用途:把 Apify Actor 执行能力加入已有应用,用于网页抓取、自动化,或把 Actor 结果接入数据管道,也可将 Apify 作为产品后端服务。
主要能力:覆盖 JS/TS 与 Python 的 apify-client 包,以及面向其他语言的 REST API。支持同步执行(.call() 阻塞至完成,适合几分钟内的短任务)与异步执行(.start() 后轮询 .waitForFinish(),适合长任务或需立即拿到 run ID)。结果可从数据集(listItems,支持 limit/offset 分页)和键值存储(getRecord)读取。Python 另提供 asyncio 的 ApifyClientAsync。
必要用法:安装时 JS/TS 用 npm install apify-client,Python 用 pip install apify-client;注意 apify-client 是调用 Actor 的客户端,apify 是构建 Actor 的 SDK,集成场景不要装错。需要 APIFY_TOKEN,可在 Console 的 Settings > Integrations 创建,并存入环境变量或密钥管理器,切勿硬编码。写代码前先用 MCP 工具 search-actors、fetch-actor-details 或浏览 apify.com/store 找到合适 Actor,并在 Actor 商店 URL 后加 .md 获取其输入 schema。
限制与注意:每个 Actor 输入 schema 不同,需先查文档再构造输入;建议设置 timeoutSecs 或 waitSecs 避免无限等待;大数据集需分页;复用同一个客户端实例。错误处理需检查 run.status 是否为 SUCCEEDED,并区分 401(token 无效)与 not found(Actor ID 错误或已删除)。REST API 端点与完整参考见 docs.apify.com/api/v2。具体收费与价格资料未提供。