用途:把 Apify Actor 部署到 Apify 平台,并将抓取结果接入外部应用,覆盖部署、API 触发、Webhook 接收、定时流水线与容器化部署。
主要能力:使用 apify push 推送 Actor 代码(可指定 username/my-scraper,不存在则创建),apify pull 拉取已有 Actor 修改;在应用中用 ApifyClient 触发运行,call() 阻塞至完成,start() 立即返回供轮询;从默认数据集读取结构化结果(JSON 或 CSV);支持 Next.js API 路由、Express Webhook 接收器、定时流水线、Docker/Cloud Run 等集成模式。
使用方式:前置条件为 Actor 已在本地用 apify run 测试、已完成 apify login、目标应用就绪。认证使用 Apify API token,在 Apify Console → Settings → Integrations 生成,通过 APIFY_TOKEN 环境变量注入,不要硬编码;CLI 使用 apify login 的独立凭据。核心命令:apify push、apify push username/my-scraper、apify pull username/existing-actor。同步调用骨架:用 token 实例化 ApifyClient,调用 client.actor('username/product-scraper').call({...}),检查 run.status 是否为 SUCCEEDED,再用 client.dataset(run.defaultDatasetId).listItems() 取结果。
适用场景:请求/响应式 UX 用轮询;定时抓取、后台数据补充等即发即忘流水线用 Webhook(监听 ACTOR.RUN.SUCCEEDED / FAILED / TIMED_OUT)。
限制与错误处理:apify push 失败检查登录与 Dockerfile;Webhook 未收到检查 URL 是否公网可达,开发用 ngrok,生产验证 HTTPS;API 路由超时改用异步模式;平台内存不足需提高内存;结果超过 100MB 使用分页或流式下载。完整代码见 references/implementation.md,端到端示例见 references/examples.md。