跳到主要内容
项目档案文档型项目

Apify Agent Skills 官方技能库详解:为 AI 代理提供 55+ 平台爬虫、Actor 开发与转换能力,附安装使用教程

apify/agent-skills:Apify Agent Skills 是为 Apify 平台 AI 代理设计的标准化技能库,提供爬虫、开发、转换等预构建模块,使 AI 能快速执本页整理它适合谁看、核心内容和站内延伸入口。

2,388PythonStar 于 2026年3月8日2026年9月19日 更新

AI 总结

Apify Agent Skills 是为 Apify 平台 AI 代理设计的标准化技能库,提供爬虫、开发、转换等预构建模块,使 AI 能快速执行网络抓取、Actor 创建等任务,大幅提升开发效率。

中文项目介绍

Apify Agent Skills 是一个专为 Apify 平台 AI 代理设计的技能集合项目,旨在解决 AI 代理在执行网络爬虫、数据提取和 Actor 开发时缺乏标准化、可复用能力的问题。 该项目提供多个核心技能模块:Ultimate Scraper 支持 55+ 主流平台(如 Instagram、Facebook、TikTok 等)的智能爬取;Actor Development 允许 AI 从零创建、调试和部署 Apify Actors;Actorization 可将现有项目转换为 Apify Actors;Generate Output Schema 能自动生成数据模式定义。 适用场景包括 AI 自动执行多平台数据抓取、使用 AI 辅助开发 Apify Actors、将 legacy 项目迁移至 Apify 平台、以及为 Actors 自动生成数据模式。技能通过标准化 Markdown 文档(SKILL.md、AGENTS.md)实现模块化,支持 Claude Code、Cursor、Gemini CLI 等多种 AI 工具无缝集成,无需额外适配。 使用前需准备 Apify 账户及 API 令牌(APIFY_TOKEN 环境变量),Ultimate Scraper 技能要求 Node.js 20.6+ 环境。所有任务在 Apify 平台执行,按结果计费。

详细信息与使用说明

1. 项目定位与用途

Apify Agent Skills 是 Apify 官方推出的 AI 代理技能集合,专为提升 AI 在 Apify 平台上的操作能力而设计。它提供一系列预构建、文档化的技能模块,使 AI 代理能够直接执行复杂的网络爬虫、数据提取和 Actor 开发任务,而无需从零编写逻辑。这些技能作为标准化组件,可被多种 AI 编程环境(如 Claude Code、Cursor)自动发现和调用,实现 AI 与 Apify 平台能力的深度集成,最终帮助开发者通过自然语言指令快速完成数据采集和自动化工作流构建。

2. 解决的问题

传统 AI 代理在 Apify 平台上执行任务时,往往缺乏现成的、可复用的能力模块,导致每次都需要重新编写爬虫逻辑、Actor 配置或数据转换代码,效率低下且容易出错。Apify Agent Skills 通过提供标准化、经过验证的技能包,解决了以下问题:一是降低 AI 代理执行网络爬虫的技术门槛,无需手动处理反爬、代理等细节;二是简化 Apify Actor 的创建和部署流程,使 AI 能直接生成可运行的 Actor;三是确保数据输出结构的一致性,通过自动模式生成避免 schema 错误;四是消除不同 AI 工具间的集成差异,提供统一的技能接口。

3. 适用场景

该技能集合适用于多种开发与数据采集场景:对于需要多平台数据抓取的业务,可使用 Ultimate Scraper 技能让 AI 自动从 Instagram、TikTok、Amazon 等 55+ 网站提取信息;对于希望利用 AI 加速开发的团队,Actor Development 技能支持用自然语言生成 JavaScript、TypeScript 或 Python 的 Apify Actor;对于已有代码库需要迁移上云的场景,Actorization 技能可将普通项目转换为 Apify Actor,获得调度、监控和代理能力;对于需要严格数据结构的应用,Generate Output Schema 技能能自动分析代码并生成符合 Apify 规范的输出模式文件。此外,任何支持 Markdown 上下文的 AI 工具均可通过引用技能文档来集成这些能力。

4. 安装方式

Apify Agent Skills 提供多种安装途径以适应不同 AI 工具:通用方式是通过 npx 命令一键添加整个技能集合:`npx skills add apify/agent-skills`。针对特定 AI 工具:Claude Code 需先添加插件市场 `/plugin marketplace add https://github.com/apify/agent-skills`,再安装具体技能如 `/plugin install apify-ultimate-scraper@apify-agent-skills`;Cursor 和 Windsurf 用户可在项目 `.cursor/settings.json` 中配置插件路径;Codex 需在配置中指向 `agents/AGENTS.md` 文件作为技能索引;Gemini CLI 会自动读取仓库中的 `gemini-extension.json`。其他支持 Markdown 上下文的 AI 工具可直接引用 `agents/AGENTS.md`(自动生成的技能索引)或各技能目录下的 `SKILL.md` 文件来加载技能描述和路径。

5. 使用方式

使用前必须完成前置准备:注册 Apify 账户(apify.com),在 Apify Console 获取 API 令牌,并设置环境变量 `APIFY_TOKEN=your_token`;若使用 Ultimate Scraper 技能,还需确保本地有 Node.js 20.6+ 环境。实际使用时,AI 工具会自动读取 `agents/AGENTS.md` 获取所有可用技能列表及其描述,当用户提出相关请求时,AI 会匹配相应技能并调用其功能。每个技能的具体参数、输入输出格式均在其 `skills/*/SKILL.md` 文件中有详细说明。任务执行在 Apify 平台进行,消耗计算资源,费用按结果计费并从 Apify 账户扣除。开发者也可参考 `skills/apify-actor-development/references/` 下的文档了解 Actor 开发规范。

6. 实现特点与架构

项目采用基于 Markdown 文档的模块化架构:`agents/AGENTS.md` 作为自动生成的技能索引,供 AI 工具快速发现所有技能;每个技能目录包含 `SKILL.md` 提供详细文档,以及可能的 `reference/` 子目录存放补充材料。这种设计使技能与 AI 工具解耦,任何支持 Markdown 上下文的工具均可集成。技能执行层完全依赖 Apify 平台,利用其 Actor 运行时、代理池、调度系统和计费机制。对于 Claude Code 等支持插件的环境,还提供了插件市场集成方式。项目通过 `scripts/generate_agents.py` 脚本维护 AGENTS.md 的自动生成,确保索引与技能目录同步。整体上,这是一个轻量级、文档驱动的技能库,不包含复杂运行时,核心价值在于标准化描述和多工具兼容性。

思维导图

Apify Agent Skills
核心技能
Ultimate Scraper - 55+平台爬虫
Actor Development - 创建调试部署Actor
Actorization - 项目转Actor
Generate Output Schema - 模式生成
安装与集成
通用安装: npx skills add
Claude Code插件市场
Cursor/Windsurf配置
Codex/Gemini CLI引用AGENTS.md
使用条件
Apify账户与API令牌
Node.js 20.6+ (Ultimate Scraper)
AI工具支持Markdown上下文
架构特点
Markdown文档驱动
模块化技能目录
依赖Apify平台执行
自动生成索引AGENTS.md

常见问题

Apify Agent Skills 是什么?包含哪些技能?

Apify Agent Skills 是 Apify 官方为 AI 代理设计的标准化技能集合,旨在让 AI 能直接执行网络爬虫、数据提取和 Actor 开发任务。当前包含四个核心技能:Ultimate Scraper(AI 驱动爬虫,支持 Instagram、Facebook 等 55+ 平台)、Actor Development(用 JS/TS/Python 创建 Apify Actors)、Actorization(将现有项目转换为 Actors)、Generate Output Schema(自动生成输出模式文件)。更多社区技能可参考 apify/awesome-skills。

如何安装 Apify Agent Skills?不同 AI 工具安装方式有何区别?

通用安装命令为 `npx skills add apify/agent-skills`。针对特定 AI 工具:Claude Code 需先添加插件市场 `/plugin marketplace add https://github.com/apify/agent-skills`,再安装具体技能;Cursor/Windsurf 在 `.cursor/settings.json` 中配置;Codex 需在配置中引用 `agents/AGENTS.md`;Gemini CLI 自动读取 `gemini-extension.json`。其他支持 Markdown 上下文的工具可直接指向 `agents/AGENTS.md` 或 `skills/*/SKILL.md`。

使用这些技能需要满足哪些前置条件?

必须拥有 Apify 账户(apify.com)并获取 API 令牌,将令牌设置为环境变量 `APIFY_TOKEN`;若使用 Ultimate Scraper 技能,还需 Node.js 20.6+ 运行环境。所有任务在 Apify 平台执行,费用按结果计费,需确保账户有足够余额或套餐。

技能执行在哪里进行?如何计费?

所有技能的执行均在 Apify 平台进行,利用其 Actor 运行时、代理池和调度系统。计费方式采用 pay-per-result(按结果付费),具体费用取决于所用 Actor 的定价模型,可在 Apify 平台查看各 Actor 的详细定价。免费 tier 有一定限额,超出后按量计费。

Ultimate Scraper 支持哪些平台?如果目标平台不在列表中怎么办?

Ultimate Scraper 官方支持 55+ 主流平台,包括 Instagram、Facebook、TikTok、YouTube、Google Maps、Amazon、Walmart、eBay、Booking.com、TripAdvisor 等。对于未列出的平台,该技能可自动搜索 Apify Store,寻找合适的现有 Actor 来完成任务,从而扩展覆盖范围。