> 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/pt-br/habilidades-de-agente.md).

# Habilidades de Agente

Configure ferramentas de IA e assistentes de programação com Agent Skills oficiais para os produtos da Oxylabs.

Oxylabs Agent Skills (`skills.md`) ensinam LLMs e assistentes de programação com IA a configurar e interagir com produtos da Oxylabs. Com uma skill instalada, seu assistente escreve strings de conexão, payloads de requisição e código de automação precisos — sem alucinações de sintaxe ou parâmetros.

## Visão geral

As skills da Oxylabs são publicadas em dois repositórios:

<table><thead><tr><th width="188.6640625">Repositórios</th><th>Produtos cobertos</th><th>Credenciais necessárias</th></tr></thead><tbody><tr><td><a href="https://github.com/oxylabs/web-api-skills">oxylabs/web-api-skills</a></td><td>Web API</td><td>chave da Web API</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>Produto <code>USERNAME</code> e <code>PASSWORD</code></td></tr></tbody></table>

{% hint style="info" %}
**Observação:** As skills ensinam seu assistente a escrever código para produtos da Oxylabs. Para permitir que seu assistente chame produtos da Oxylabs diretamente, veja [Model Context Protocol (MCP)](/ai-workflows/pt-br/mcp.md).
{% endhint %}

## Skills de agente da Web API

Um repositório separado com skills que ensinam seu agente a usar a Oxylabs Web API para busca web em tempo real e coleta de páginas.

<table><thead><tr><th width="263.734375">Skill</th><th>Cobre</th></tr></thead><tbody><tr><td><code>oxylabs-web-api</code></td><td>A mecânica — as ferramentas MCP, parâmetros, latência, erros, tentativas — mais um auxiliar de CLI sem dependências</td></tr><tr><td><code>oxylabs-web-research</code></td><td>O método de pesquisa: buscar, escolher fontes, ler, citar</td></tr><tr><td><code>migrate-to-oxylabs</code></td><td>Portar uma base de código de Tavily, Exa, Firecrawl, Perplexity, Brave ou Linkup</td></tr></tbody></table>

### Instalação

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

Funciona com qualquer agente compatível com skills. O Claude Code também pode usar o repositório como um plugin, que conecta as skills e o [servidor MCP](/ai-workflows/pt-br/mcp.md#web-api) juntos:

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

Depois `export OXYLABS_WEB_API_KEY=<key>` — no ambiente, nunca em um arquivo de configuração, e a partir de uma **Web API** instância, não de outro produto da Oxylabs — inicie uma nova sessão e execute `/skills` para confirmar que os três foram carregados. Clonar e executar `./install.sh` ainda funciona se você preferir não usar npx; o [README](https://github.com/oxylabs/web-api-skills#install) tem isso e a cópia manual.

### Skills ou MCP?

Eles resolvem metades diferentes e se complementam bem:

| Critérios                          | Skills                                                          | servidor MCP                                        |
| ---------------------------------- | --------------------------------------------------------------- | --------------------------------------------------- |
| Dá ao agente                       | Julgamento — quando pesquisar, quais fontes confiar, como citar | Ferramentas tipadas que ele pode chamar diretamente |
| Precisa de um processo em execução | Não                                                             | Sim                                                 |
| Funciona em                        | Agentes que carregam diretórios de skills                       | Qualquer cliente MCP                                |

Instalar ambos é um padrão razoável. O servidor empacota `oxylabs-web-api` e o expõe como o `oxylabs://skill/web-api` recurso, então conectá-lo sozinho dá a um agente as duas metades — instale as skills separadamente quando quiser usá-las sem um servidor em execução, ou quando quiser `migrate-to-oxylabs`.

### Solução de problemas

<table><thead><tr><th width="300.53515625">Problema</th><th>Solução</th></tr></thead><tbody><tr><td><code>401</code> erro com uma chave que parece válida</td><td>A chave quase sempre é de outro produto da Oxylabs. Crie uma instância da Web API e gere uma chave para ela.</td></tr><tr><td><code>429</code> erro com <code>QUOTA_EXCEEDED</code></td><td>A cota do seu plano se esgotou. Tentar de novo não ajudará.</td></tr><tr><td>O servidor MCP falha com <code>Executable not found: oxylabs-web-api-mcp</code></td><td>O servidor não está instalado. Execute <code>uv tool install git+https://github.com/oxylabs/web-api-mcp</code>.</td></tr></tbody></table>

## Oxylabs Agent Skills

Um único repositório com skills para Proxies, Agent Browser, Web Unblocker, Video Data e Web Scraper API. Você instala todas de uma vez e depois adiciona credenciais para os produtos que usa.

### Skills disponíveis

Use skills específicas do produto por meio do `skill/` diretório.

<table><thead><tr><th width="168.19140625">Skill</th><th>Descrição</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>Gere strings de conexão, trate nós de entrada e aplique geotargeting, rotação de IP e persistência de sessão.</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>Controle navegadores remotos via Chrome DevTools Protocol (CDP), configure fingerprints e gerencie automação com Playwright ou 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>Roteie o tráfego pelos gateways corretos, gerencie cabeçalhos personalizados, alterne a renderização de JavaScript e configure 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>Extraia metadados de vídeo, legendas, resultados de busca e dados de canais, e baixe vídeo ou áudio via 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>Crie payloads de requisição, parâmetros de parsing personalizados e campos de geotargeting, e formate a saída JSON para mais de 40 destinos.</td><td></td></tr></tbody></table>

A `proxies` skill cobre [Residential](https://developers.oxylabs.io/products/proxies/residential-proxies), [Mobile](https://developers.oxylabs.io/products/proxies/mobile-proxies), [ISP](https://developers.oxylabs.io/products/proxies/isp-proxies), [ISP dedicada](https://developers.oxylabs.io/products/proxies/dedicated-isp-proxies), [Datacenter](https://developers.oxylabs.io/products/proxies/datacenter-proxies)e [Dedicated Datacenter Proxies](https://developers.oxylabs.io/products/proxies/dedicated-datacenter-proxies).

### Instalação

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

Configure o Claude Code e execute os seguintes comandos para instalar as 5 skills como um único plugin:

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

Para atualizar as skills, execute este comando:

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

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

Para outros agentes e ambientes personalizados, carregue o repositório no workspace do seu projeto via a CLI padrão de skills:

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

#### **Instalação manual (symlink)**

Para instalar uma única skill sem o plugin, clone o repositório e vincule a skill ao diretório de skills do seu assistente. O exemplo abaixo instala a `agent-browser` skill para Claude Code:

{% hint style="info" %}
Para instalar qualquer skill, substitua `agent-browser` pelo nome dela na tabela acima. Para atualizar, execute `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
```

### Configuração

Todas as skills autenticam com variáveis de ambiente em um `.env` arquivo. Adicione apenas as variáveis dos produtos que você usa.

<table><thead><tr><th width="167.9296875">Variável</th><th width="248">Produto</th><th>Descrição</th></tr></thead><tbody><tr><td><p><code>OXY_RES_USERNAME</code></p><p><code>OXY_RES_PASSWORD</code></p></td><td>Proxies Residential e Mobile</td><td>Nome de usuário e senha do usuário do proxy</td></tr><tr><td><p><code>OXY_DC_USERNAME</code></p><p><code>OXY_DC_PASSWORD</code></p></td><td>Proxies Datacenter e ISP</td><td>Nome de usuário e senha do usuário do 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>Nome de usuário e senha do usuário do Agent Browser</td></tr><tr><td><p><code>OXYLABS_USERNAME</code></p><p><code>OXYLABS_PASSWORD</code></p></td><td>Web Unblocker</td><td>Nome de usuário e senha do usuário do Web Unblocker</td></tr><tr><td><code>OXY_HB_ENDPOINT</code></td><td>Video Data (opcional)</td><td>Endpoint de High-Bandwidth Proxy para downloads de vídeo e áudio</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>Nome de usuário e senha do usuário da Web Scraper API</td></tr></tbody></table>

{% hint style="warning" %}
**Aviso:** `OXY_HB_ENDPOINT` refere-se a High-Bandwidth Proxies, não a Agent Browser. Video Data usa suas credenciais da Web Scraper API e só precisa deste endpoint para downloads de mídia.
{% endhint %}

### Verifique a configuração

Peça ao seu assistente para executar uma pequena tarefa com um produto para o qual você instalou a skill. Por exemplo, para Agent Browser:

{% code overflow="wrap" %}

```
Escreva e execute um script do Playwright em TypeScript que se conecte ao Oxylabs Agent Browser com geolocalização dos EUA, acesse https://ip.oxylabs.io/location e imprima o título e o IP.
```

{% endcode %}

## Quais skills usar

<table><thead><tr><th width="582.09765625">Precisa</th><th>Use</th></tr></thead><tbody><tr><td>Traga seu próprio cliente HTTP, autenticação de proxy, rotação de IP, sessões persistentes ou tráfego bruto de proxy com geotargeting</td><td><a href="/products/proxies.md">Proxies</a></td></tr><tr><td>Dê ao seu agente de IA busca web em tempo real e leitura de páginas, para que ele possa pesquisar informações atuais e citar suas fontes</td><td><a href="https://developers.oxylabs.io/products/web-api">Web API</a></td></tr><tr><td>Clique, preencha formulários, tire capturas de tela ou automatize com Playwright ou Puppeteer</td><td><a href="/products/agent-browser.md">Agent Browser</a></td></tr><tr><td>Busque páginas protegidas sem interações no navegador</td><td><a href="/products/web-unblocker.md">Web Unblocker</a></td></tr><tr><td>Colete metadados do YouTube, legendas, resultados de busca ou dados de canais, ou baixe vídeo e áudio</td><td><a href="https://developers.oxylabs.io/api-targets/video-and-social-media">Video Data</a></td></tr><tr><td>Obtenha dados estruturados de destinos suportados, resultados de busca, páginas de e-commerce ou JSON analisado</td><td><a href="/products/web-scraper-api.md">Web Scraper API</a></td></tr></tbody></table>

{% hint style="info" %}
**Observação:** Comece com o produto mais específico que se encaixa na tarefa. Teste primeiro uma única requisição pequena para confirmar autenticação e saída e, depois, aumente a escala.
{% endhint %}

Se precisar de ajuda para navegar pelas Agent Skills, entre em contato com nossa equipe de suporte 24/7 para obter assistência em <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/pt-br/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.