> 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/web-scraper-api/solutions-for-ai-workflows/agent-skills.md).

# Agent Skills

Oxylabs Agent Skills (`skills.md`) teach LLMs and AI coding assistants how to configure and interact with Oxylabs products.

**Web Scraper API credentials support two different agent skills** depending on your target workflow:

* [**web-scraper-api**](#web-scraper-api-skills) – structured data collection and parsing from various websites and public data sources.
* [**video-data**](#video-data) – extracting video metadata, search results, subtitles, or handling raw media downloads.

## Installation

### Claude Code (plugin marketplace)

Inside Claude Code, run the following commands:

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

This installs all 5 skills as a single 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)

To update skills, run this command:

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

### Other agents (generic)

For other agents and custom environments, load the repository into your project workspace via the standard skills CLI:

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

## Web Scraper API

`web-scraper-api` skill improves payload construction, custom parsing parameters, geo-targeting fields, and JSON output formatting when extracting data from any web targets using Oxylabs Web Scraper API.

### Configuration

Add your Web Scraper API credentials to your project's local `.env` file:

| Variable           | Description                           |
| ------------------ | ------------------------------------- |
| `OXY_WSA_USERNAME` | Your Web Scraper API user `username`. |
| `OXY_WSA_PASSWORD` | Your Web Scraper API user `password`. |

### How to use

Once the skill is active in your workspace, you can prompt your AI assistant to build full data scraping scripts.

* **Example 1:** "Write a Python script using Web Scraper API to scrape `e-commerce-website.net` with a custom parsing schema and `US` geo-targeting."
* **Example 2:** "Create a Node.js function that passes a list of URLs to the Web Scraper API endpoint to scrape and parse the JSON response."

## Video Data

`video-data` skill covers video data extraction (metadata, search, channels) using Web Scraper API and `yt-dlp` video/audio file downloads via High-Bandwidth Proxy agent skill.

### Configuration

All Oxylabs Agent Skills authenticate via environment variables defined in a `.env` file. To use video-data skills, add these keys to your `.env` file:

| Variable           | Description                                                                                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `OXY_WSA_USERNAME` | Your Web Scraper API user `username`.                                                                                                                   |
| `OXY_WSA_PASSWORD` | Your Web Scraper API user `password`.                                                                                                                   |
| `OXY_HB_ENDPOINT`  | (Optional) Your High-Bandwidth Proxy gateway string for media downloads. More details [here](/products/proxies/high-bandwidth-proxies.md#agent-skills). |

### How to use

Once the skill is active in your workspace, you can prompt your AI agent to write code tailored for public video content collection.

* **Example 1:** "Write a Python script using the Oxylabs Video Data API target to extract the full subtitle text and upload metadata of a specific video ID."
* **Example 3:** "Write a Node.js function that searches a video platform for a keyword string and extracts a structured JSON list of matching channel URLs."

## More Oxylabs Agent Skills

Learn more about Agent Skills for other Oxylabs solutions:

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