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

# Agent Skills

Oxylabs 代理技能 (`skills.md`) 教授 LLM 和 AI 编码助手如何配置并与 Oxylabs 产品交互。

**网页爬虫API 凭证支持两种不同的代理技能** 具体取决于你的目标工作流：

* [**web-scraper-api**](#web-scraper-api-skills) – 从各种网站和公开数据源进行结构化数据采集与解析。
* [**video-data**](#video-data) – 提取视频元数据、搜索结果、字幕，或处理原始媒体下载。

## 安装

### Claude Code（插件市场）

在 Claude Code 中，运行以下命令：

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

这会将全部 5 个技能作为一个插件安装：

* [`skills/代理`](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)

要更新技能，请运行此命令：

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

### 其他代理（通用）

对于其他代理和自定义环境，请通过标准 skills CLI 将仓库加载到你的项目工作区：

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

## 网页爬虫API

`web-scraper-api` 当使用 Oxylabs 网页爬虫API 从任何网页目标提取数据时，此技能可改进负载构建、自定义解析参数、地理定位字段和 JSON 输出格式。

### 配置

将你的网页爬虫API凭据添加到项目的本地 `.env` 文件：

| 变量                 | 描述                 |
| ------------------ | ------------------ |
| `OXY_WSA_USERNAME` | 你的网页爬虫API用户 `用户名`. |
| `OXY_WSA_PASSWORD` | 你的网页爬虫API用户 `密码`.  |

### 使用方法

一旦该技能在你的工作区中启用，你就可以提示你的 AI 助手编写完整的数据抓取脚本。

* **示例 1：** "使用网页爬虫API编写一个 Python 脚本来抓取 `e-commerce-website.net` 使用自定义解析 schema 和 `美国` 地理定向。"
* **示例 2：** "创建一个 Node.js 函数，将 URL 列表传递给网页爬虫API端点，以抓取并解析 JSON 响应。"

## 视频数据

`video-data` 该技能涵盖使用网页爬虫API进行视频数据提取（元数据、搜索、频道）和 `yt-dlp` 通过高带宽代理 agent 技能下载视频/音频文件。

### 配置

所有 Oxylabs Agent Skills 都通过定义在一个 `.env` 文件中的环境变量进行认证。要使用视频数据技能，请将这些键添加到你的 `.env` 文件：

| 变量                 | 描述                                                                                           |
| ------------------ | -------------------------------------------------------------------------------------------- |
| `OXY_WSA_USERNAME` | 你的网页爬虫API用户 `用户名`.                                                                           |
| `OXY_WSA_PASSWORD` | 你的网页爬虫API用户 `密码`.                                                                            |
| `OXY_HB_ENDPOINT`  | （可选）用于媒体下载的高带宽代理网关字符串。更多详情 [这里](/products/cn/dai-li/high-bandwidth-proxies.md#agent-skills). |

### 使用方法

一旦该技能在你的工作区中启用，你就可以提示你的 AI 智能体编写适用于公开视频内容采集的代码。

* **示例 1：** “编写一个使用 Oxylabs 视频数据API 目标的 Python 脚本，以提取特定视频 ID 的完整字幕文本和上传元数据。”
* **示例 3：** “编写一个 Node.js 函数，搜索视频平台中的关键词字符串，并提取匹配频道 URL 的结构化 JSON 列表。”

## 更多 Oxylabs Agent Skills

了解其他 Oxylabs 解决方案的 Agent Skills：

* [代理](/products/cn/dai-li/residential-proxies/agent-skills.md)
* [网页解锁器](/products/cn/web-unblocker/agent-skills.md)
* [无头浏览器](/products/cn/headless-browser/ai-gong-zuo-liu/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/cn/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.