> 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/agent-skills.md).

# Habilidades do Agente

Configure ferramentas de IA e assistentes de código com as Habilidades do Agente oficiais da Oxylabs Web Scraper API para scraping web e coleta de dados de vídeo.

Habilidades de Agente da Oxylabs (`SKILL.md`) ensinam LLMs e assistentes de codificação de IA como configurar e interagir com os produtos da Oxylabs.

**As credenciais da Web Scraper API oferecem suporte a duas habilidades de agente diferentes** dependendo do seu fluxo de trabalho alvo:

* [**web-scraper-api**](/products/pt-br/web-scraper-api/solutions-for-ai-workflows/agent-skills.md#web-scraper-api) – coleta e análise 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)

Dentro do Claude Code, execute os seguintes comandos:

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

Isso instala todas as 5 habilidades 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 habilidades, execute este comando:

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

### Outros agentes (genérico)

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, parâmetros de parsing personalizados, campos de geotargeting e a formatação da saída em JSON ao extrair dados de qualquer alvo web usando a Web Scraper API da Oxylabs.

### Configuração

Adicione suas credenciais da Web Scraper API ao arquivo 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 scraping de dados.

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

## Dados de Vídeo

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

### Configuração

Todas as Oxylabs Agent Skills autenticam via variáveis de ambiente definidas em um `.env` arquivo. Para usar as habilidades 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 de 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 em Python usando o alvo Video Data API da Oxylabs para extrair o texto completo das legendas e os metadados de upload de um ID de vídeo específico."
* **Exemplo 2:** "Escreva uma função em 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 Agent Skills para outras soluções da Oxylabs:

* [Proxies](/products/pt-br/proxies/residential-proxies/agent-skills.md)
* [Web Unblocker](/products/pt-br/web-unblocker/agent-skills.md)
* [Headless Browser](/products/pt-br/headless-browser/ai-workflows/agent-skills.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/agent-skills.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.