Apify Actors 应用集成技能（apify-sdk-integration） Skill 技能

技能简介

Integrate Apify Actors into Your Application（apify-sdk-integration）是 Apify 官方推出的 Claude/Codex 技能，用于把 Apify 平台上托管的爬虫与自动化 Actor 稳定地接入自有应用。它解决的是集成环节最容易出错的几件事：选对客户端包、正确配置令牌、发起 Actor 运行、等待完成并读取结构化结果。无论是 JS/TS 服务、Python 数据流程，还是没有官方客户端的语言，它都给出了可复用的集成模式，让"给应用加上托管爬取能力"不再需要反复踩坑。

核心能力

• 按 JavaScript、TypeScript、Python 选择正确的 apify-client 客户端包
• 展示同步与异步两种启动 Apify Actor 运行的模式
• 从已完成的运行中读取结构化数据集（dataset）与键值存储（key-value store）记录
• 为没有官方客户端的语言提供 REST API 请求范式
• 讲解令牌配置、错误处理、分页、超时与客户端复用等工程细节
• 指导通过 Apify Store 或 MCP 工具发现 Actor 并查询其输入 Schema

安装配置

通过 Skillstore 一条命令安装：

npx skillstore add apify/apify-sdk-integration

• 配置 APIFY_TOKEN 环境变量，作为安全凭证（官方建议服务端持有，不暴露到前端）
• 支持的宿主工具：Claude、Codex、Claude Code，审计状态 complete，允许代理自动安装

使用步骤

1. 确定目标 Actor 与业务输入需求，明确要抓取或自动化什么
2. 用「Install and Configure the Client」模板接入对应语言的客户端包，并完成令牌的安全配置
3. 按同步或异步模式发起 Actor 运行，设定输入参数
4. 等待运行完成后，分页读取数据集条目或键值存储记录，传入下游管线
5. 补全错误处理、超时与客户端复用逻辑，做一次真实调用验证

适用场景

• Web 应用接入爬取：把已有的 JS/TS 服务连到某个 Apify Actor，消费其数据集结果
• Python 数据采集自动化：在 Python 工作流中运行 Actor，等待完成后把记录送入管线
• REST 方式集成：在没有官方客户端的语言里启动运行、查询状态、拉取数据集
• 凭证与错误治理：统一管理令牌配置、分页与超时，提升集成稳定性

适用人群

适合需要为产品增加托管爬取/自动化能力的全栈与后端工程师、数据工程师，以及希望快速验证某类数据采集可行性的 AI 应用开发者。

工作原理

该技能是一份"集成向导"：它不执行爬取，而是把 Apify 的客户端调用抽象为选型、认证、运行、取数四条主线。通过提供各语言的最小连接示例与结构化取数模式，让 Agent 直接产出可运行的集成代码，并顺带补齐令牌安全、分页与超时等生产化考量。

官方链接

• 技能页：https://skillstore.io/skills/apify-apify-sdk-integration
• 源码仓库：https://github.com/apify/agent-skills/tree/dd6bb07579560f0cffec795181c6f49407301615/skills/apify-sdk-integration
• 质量评分：77（bronze 铜级），风险等级：safe