> 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/products/pt-br/web-scraper-api/solutions-for-ai-workflows/habilidades-do-agente.md).

# Habilidades do Agente

Habilidades de Agente Oxylabs (`skills.md`) ensinam LLMs e assistentes de programação de IA a configurar e interagir com os produtos da Oxylabs.

**As credenciais da Web Scraper API suportam duas skills de agente diferentes** dependendo do fluxo de trabalho desejado:

* [**web-scraper-api**](#web-scraper-api-skills) – coleta e parsing de dados estruturados de vários sites e fontes de dados públicas.
* [**video-data**](#video-data) – extração de metadados de vídeo, resultados de busca, legendas ou tratamento de downloads brutos de mídia.

## Instalação

### Claude Code (marketplace de plugins)

No Claude Code, execute os seguintes comandos:

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

Isso instala todas as 5 skills como um único plugin:

* [`skills/proxies`](https://github.com/oxylabs/agent-skills/blob/main/skills/proxies/SKILL.md)
* [`skills/web-unblocker`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-unblocker/SKILL.md)
* [`skills/web-scraper-api`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-scraper-api/SKILL.md)
* [`skills/headless-browser`](https://github.com/oxylabs/agent-skills/blob/main/skills/headless-browser/SKILL.md)
* [`skills/video-data`](https://github.com/oxylabs/agent-skills/blob/main/skills/video-data/SKILL.md)

Para atualizar as skills, execute este comando:

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

### Outros agentes (genéricos)

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

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

## Web Scraper API

`web-scraper-api` a skill melhora a construção do payload, os parâmetros de parsing personalizados, os campos de geo-targeting e a formatação da saída JSON ao extrair dados de qualquer alvo web usando Oxylabs Web Scraper API.

### Configuração

Adicione suas credenciais da Web Scraper API ao local do seu projeto `.env` arquivo:

| Variável           | Descrição                                         |
| ------------------ | ------------------------------------------------- |
| `OXY_WSA_USERNAME` | Seu usuário da Web Scraper API `nome de usuário`. |
| `OXY_WSA_PASSWORD` | Seu usuário da Web Scraper API `senha`.           |

### Como usar

Depois que a skill estiver ativa no seu workspace, você pode pedir ao seu assistente de IA para criar scripts completos de extração de dados.

* **Exemplo 1:** "Escreva um script Python usando Web Scraper API para extrair `e-commerce-website.net` com um schema de parsing personalizado e `US` segmentação geográfica."
* **Exemplo 2:** "Crie uma função Node.js que passe uma lista de URLs para o endpoint da Web Scraper API para extrair e analisar a resposta JSON."

## Dados de vídeo

`video-data` esta skill cobre a extração de dados de vídeo (metadados, busca, canais) usando Web Scraper API e `yt-dlp` downloads de arquivos de vídeo/áudio por meio da skill de agente High-Bandwidth Proxy.

### Configuração

Todas as Oxylabs Agent Skills se autenticam por meio de variáveis de ambiente definidas em um `.env` arquivo. Para usar as skills video-data, adicione estas chaves ao seu `.env` arquivo:

| Variável           | Descrição                                                                                                                                                            |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `OXY_WSA_USERNAME` | Seu usuário da Web Scraper API `nome de usuário`.                                                                                                                    |
| `OXY_WSA_PASSWORD` | Seu usuário da Web Scraper API `senha`.                                                                                                                              |
| `OXY_HB_ENDPOINT`  | (Opcional) Sua string de gateway High-Bandwidth Proxy para downloads de mídia. Mais detalhes [aqui](/products/pt-br/proxies/high-bandwidth-proxies.md#agent-skills). |

### Como usar

Depois que a skill estiver ativa no seu workspace, você pode pedir ao seu agente de IA para escrever código adaptado à coleta de conteúdo público de vídeo.

* **Exemplo 1:** "Escreva um script Python usando o destino da Oxylabs Video Data API para extrair o texto completo das legendas e os metadados de upload de um ID de vídeo específico."
* **Exemplo 3:** "Escreva uma função Node.js que pesquise uma plataforma de vídeo por uma string de palavra-chave e extraia uma lista JSON estruturada de URLs de canais correspondentes."

## Mais Oxylabs Agent Skills

Saiba mais sobre habilidades de agente para outras soluções da Oxylabs:

* [Proxies](/products/pt-br/proxies/residential-proxies/habilidades-do-agente.md)
* [Web Unblocker](/products/pt-br/web-unblocker/habilidades-do-agente.md)
* [Headless Browser](/products/pt-br/headless-browser/fluxos-de-trabalho-de-ia/habilidades-do-agente.md)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/pt-br/web-scraper-api/solutions-for-ai-workflows/habilidades-do-agente.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.