> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/ai-workflows/es/habilidades-de-agente.md).

# Habilidades de agente

Configura herramientas de IA y asistentes de codificación con Agent Skills oficiales para los productos de Oxylabs.

Habilidades de agente de Oxylabs (`skills.md`) enseñan a los LLM y a los asistentes de codificación de IA cómo configurar e interactuar con los productos de Oxylabs. Con una skill instalada, tu asistente escribe cadenas de conexión, cargas útiles de solicitud y código de automatización precisos, sin alucinaciones de sintaxis ni de parámetros.

## Descripción general

Las skills de Oxylabs se publican en dos repositorios:

<table><thead><tr><th width="188.6640625">Repositorios</th><th>Productos cubiertos</th><th>Credenciales requeridas</th></tr></thead><tbody><tr><td><a href="https://github.com/oxylabs/web-api-skills">oxylabs/web-api-skills</a></td><td>API web</td><td>clave de API web</td></tr><tr><td><a href="https://github.com/oxylabs/agent-skills">oxylabs/agent-skills</a></td><td>Proxies, Agent Browser, Web Unblocker, Video Data, Web Scraper API</td><td>Producto <code>USERNAME</code> y <code>PASSWORD</code></td></tr></tbody></table>

{% hint style="info" %}
**Nota:** Las skills enseñan a tu asistente a escribir código para productos de Oxylabs. Para permitir que tu asistente llame directamente a los productos de Oxylabs, consulta [Model Context Protocol (MCP)](/ai-workflows/es/mcp.md).
{% endhint %}

## Habilidades de agente de API web

Un repositorio aparte con skills que enseñan a tu agente a usar la API web de Oxylabs para búsqueda web en vivo y obtención de páginas.

<table><thead><tr><th width="263.734375">Skill</th><th>Cubre</th></tr></thead><tbody><tr><td><code>oxylabs-web-api</code></td><td>Mecánica – las herramientas MCP, los parámetros, la latencia, los errores y los reintentos – además de una utilidad CLI sin dependencias</td></tr><tr><td><code>oxylabs-web-research</code></td><td>El método de investigación: buscar, elegir fuentes, leer, citar</td></tr><tr><td><code>migrate-to-oxylabs</code></td><td>Migrar una base de código desde Tavily, Exa, Firecrawl, Perplexity, Brave o Linkup</td></tr></tbody></table>

### Instalación

```bash
npx skills add oxylabs/web-api-skills
```

Funciona con cualquier agente compatible con skills. Claude Code, en cambio, puede tomar el repositorio como un plugin, que conecta las skills y el [servidor MCP](/ai-workflows/es/mcp.md#web-api) juntos:

```
/plugin marketplace add oxylabs/web-api-skills
/plugin install oxylabs-web-api
```

Luego `export OXYLABS_WEB_API_KEY=<key>` – en el entorno, nunca en un archivo de configuración, y desde una **API web** instancia, no desde otro producto de Oxylabs – inicia una nueva sesión y ejecuta `/skills` para confirmar que los tres se cargaron. Clonar y ejecutar `./install.sh` sigue funcionando si prefieres no usar npx; el [README](https://github.com/oxylabs/web-api-skills#install) incluye eso y la copia manual.

### ¿Skills o MCP?

Resuelven mitades distintas y combinan bien:

| Criterio                         | Skills                                                  | servidor MCP                                        |
| -------------------------------- | ------------------------------------------------------- | --------------------------------------------------- |
| Le da al agente                  | Juicio – cuándo buscar, qué fuentes confiar, cómo citar | Herramientas tipadas que puede invocar directamente |
| Necesita un proceso en ejecución | No                                                      | Sí                                                  |
| Funciona en                      | Agentes que cargan directorios de skills                | Cualquier cliente MCP                               |

Instalar ambos es un valor predeterminado razonable. El servidor agrupa `oxylabs-web-api` y lo sirve como el `oxylabs://skill/web-api` recurso, así que conectarlo por sí solo le da a un agente ambas mitades – instala las skills por separado cuando las quieras sin un servidor en ejecución, o cuando quieras `migrate-to-oxylabs`.

### Solución de problemas

<table><thead><tr><th width="300.53515625">Problema</th><th>Solución</th></tr></thead><tbody><tr><td><code>401</code> error con una clave aparentemente válida</td><td>La clave casi siempre pertenece a otro producto de Oxylabs. Crea una instancia de API web y genera una clave para ella.</td></tr><tr><td><code>429</code> error con <code>QUOTA_EXCEEDED</code></td><td>La cuota de tu plan se ha agotado. Reintentar no ayudará.</td></tr><tr><td>El servidor MCP falla con <code>Ejecutable no encontrado: oxylabs-web-api-mcp</code></td><td>El servidor no está instalado. Ejecuta <code>uv tool install git+https://github.com/oxylabs/web-api-mcp</code>.</td></tr></tbody></table>

## Habilidades de agente de Oxylabs

Un repositorio con skills para Proxies, Agent Browser, Web Unblocker, Video Data y Web Scraper API. Instalas todas a la vez, luego agregas credenciales para los productos que usas.

### Skills disponibles

Usa skills específicas de producto a través del `skill/` directorio.

<table><thead><tr><th width="168.19140625">Skill</th><th>Descripción</th><th data-hidden></th></tr></thead><tbody><tr><td><a href="https://github.com/oxylabs/agent-skills/blob/main/skills/proxies/SKILL.md"><code>proxies</code></a></td><td>Genera cadenas de conexión, gestiona nodos de entrada y aplica segmentación geográfica, rotación de IP y persistencia de sesión.</td><td></td></tr><tr><td><a href="https://github.com/oxylabs/agent-skills/blob/main/skills/agent-browser/SKILL.md"><code>agent-browser</code></a></td><td>Controla navegadores remotos mediante Chrome DevTools Protocol (CDP), configura huellas digitales y gestiona automatización con Playwright o Puppeteer.</td><td></td></tr><tr><td><a href="https://github.com/oxylabs/agent-skills/blob/main/skills/web-unblocker/SKILL.md"><code>web-unblocker</code></a></td><td>Redirige el tráfico a través de las puertas de enlace correctas, gestiona encabezados personalizados, activa o desactiva el renderizado de JavaScript y configura SSL.</td><td></td></tr><tr><td><a href="https://github.com/oxylabs/agent-skills/blob/main/skills/video-data/SKILL.md"><code>video-data</code></a></td><td>Extrae metadatos de video, subtítulos, resultados de búsqueda y datos del canal, y descarga video o audio mediante High-Bandwidth Proxies.</td><td></td></tr><tr><td><a href="https://github.com/oxylabs/agent-skills/blob/main/skills/web-scraper-api/SKILL.md"><code>web-scraper-api</code></a></td><td>Construye cargas útiles de solicitud, parámetros de análisis personalizados y campos de segmentación geográfica, y formatea la salida JSON para más de 40 destinos.</td><td></td></tr></tbody></table>

La `proxies` skill cubre [Residenciales](https://developers.oxylabs.io/products/proxies/residential-proxies), [Móviles](https://developers.oxylabs.io/products/proxies/mobile-proxies), [ISP](https://developers.oxylabs.io/products/proxies/isp-proxies), [ISP dedicado](https://developers.oxylabs.io/products/proxies/dedicated-isp-proxies), [Datacenter](https://developers.oxylabs.io/products/proxies/datacenter-proxies), y [Dedicated Datacenter Proxies](https://developers.oxylabs.io/products/proxies/dedicated-datacenter-proxies).

### Instalación

#### Claude Code (mercado de plugins) <a href="#claude-code-plugin-marketplace" id="claude-code-plugin-marketplace"></a>

Configura Claude Code y ejecuta los siguientes comandos para instalar las 5 skills como un solo plugin:

```bash
/plugin marketplace add oxylabs/agent-skills
/plugin install oxylabs@oxylabs-agent-skills
```

Para actualizar las skills, ejecuta este comando:

```bash
/plugin marketplace update oxylabs-agent-skills
```

#### Otros agentes (genéricos) <a href="#other-agents-generic" id="other-agents-generic"></a>

Para otros agentes y entornos personalizados, carga el repositorio en el espacio de trabajo de tu proyecto mediante la CLI estándar de skills:

```bash
npx skills add https://github.com/oxylabs/agent-skills.git
```

#### **Instalación manual (enlace simbólico)**

Para instalar una sola skill sin el plugin, clona el repositorio y vincula la skill en el directorio de skills de tu asistente. El siguiente ejemplo instala la `agent-browser` skill para Claude Code:

{% hint style="info" %}
Para instalar cualquier skill, reemplaza `agent-browser` con su nombre de la tabla anterior. Para actualizar, ejecuta `git -C agent-skills pull`.
{% endhint %}

```bash
git clone https://github.com/oxylabs/agent-skills.git
mkdir -p ~/.claude/skills
ln -sfn "$PWD/agent-skills/skills/agent-browser" ~/.claude/skills/agent-browser
```

### Configuración

Todas las skills se autentican con variables de entorno en un `.env` archivo. Agrega solo las variables de los productos que uses.

<table><thead><tr><th width="167.9296875">Variable</th><th width="248">Producto</th><th>Descripción</th></tr></thead><tbody><tr><td><p><code>OXY_RES_USERNAME</code></p><p><code>OXY_RES_PASSWORD</code></p></td><td>Proxies residenciales y Mobile Proxies</td><td>Nombre de usuario y contraseña del usuario del proxy</td></tr><tr><td><p><code>OXY_DC_USERNAME</code></p><p><code>OXY_DC_PASSWORD</code></p></td><td>Proxies de datacenter e ISP Proxies</td><td>Nombre de usuario y contraseña del usuario del proxy</td></tr><tr><td><p><code>OXY_AB_USERNAME</code></p><p><code>OXY_AB_PASSWORD</code></p></td><td>Agent Browser</td><td>Nombre de usuario y contraseña del usuario de Agent Browser</td></tr><tr><td><p><code>OXYLABS_USERNAME</code></p><p><code>OXYLABS_PASSWORD</code></p></td><td>Web Unblocker</td><td>Nombre de usuario y contraseña del usuario de Web Unblocker</td></tr><tr><td><code>OXY_HB_ENDPOINT</code></td><td>Video Data (opcional)</td><td>endpoint de High-Bandwidth Proxies para descargas de video y audio</td></tr><tr><td><p><code>OXY_WSA_USERNAME</code></p><p><code>OXY_WSA_PASSWORD</code></p></td><td>Video Data, Web Scraper API</td><td>Nombre de usuario y contraseña del usuario de Web Scraper API</td></tr></tbody></table>

{% hint style="warning" %}
**Aviso:** `OXY_HB_ENDPOINT` se refiere a High-Bandwidth Proxies, no a Agent Browser. Video Data usa tus credenciales de Web Scraper API y solo necesita este endpoint para descargas multimedia.
{% endhint %}

### Verifica la configuración

Pídele a tu asistente que ejecute una tarea pequeña con un producto para el que instalaste la skill. Por ejemplo, con Agent Browser:

{% code overflow="wrap" %}

```
Escribe y ejecuta un script de Playwright en TypeScript que se conecte a Oxylabs Agent Browser con geolocalización de EE. UU., navegue a https://ip.oxylabs.io/location y muestre el título y la IP.
```

{% endcode %}

## Qué skills usar

<table><thead><tr><th width="582.09765625">Necesitas</th><th>Usa</th></tr></thead><tbody><tr><td>Trae tu propio cliente HTTP, autenticación de proxy, rotación de IP, sesiones persistentes o tráfico bruto de proxy con segmentación geográfica</td><td><a href="/products/proxies.md">Proxies</a></td></tr><tr><td>Dale a tu agente de IA búsqueda web en vivo y lectura de páginas, para que pueda investigar información actual y citar sus fuentes</td><td><a href="https://developers.oxylabs.io/products/web-api">API web</a></td></tr><tr><td>Haz clic, completa formularios, toma capturas de pantalla o automatiza con Playwright o Puppeteer</td><td><a href="/products/agent-browser.md">Agent Browser</a></td></tr><tr><td>Obtén páginas protegidas sin interacciones del navegador</td><td><a href="/products/web-unblocker.md">Web Unblocker</a></td></tr><tr><td>Recopila metadatos de YouTube, subtítulos, resultados de búsqueda o datos del canal, o descarga video y audio</td><td><a href="https://developers.oxylabs.io/api-targets/video-and-social-media">Video Data</a></td></tr><tr><td>Obtén datos estructurados de destinos compatibles, resultados de búsqueda, páginas de comercio electrónico o JSON analizado</td><td><a href="/products/web-scraper-api.md">Web Scraper API</a></td></tr></tbody></table>

{% hint style="info" %}
**Nota:** Empieza con el producto más específico que se ajuste a la tarea. Prueba primero una solicitud pequeña para confirmar la autenticación y la salida, y luego escala.
{% endhint %}

Si necesitas ayuda para navegar por Agent Skills, contacta a nuestro equipo de soporte 24/7 para recibir asistencia en <support@oxylabs.io>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/ai-workflows/es/habilidades-de-agente.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.