用途:为产品设计并交付官方 Apify 集成,覆盖工作流自动化平台(Zapier、n8n、Make 等)、AI 智能体插件、AI 框架包(PyPI/npm)与直接应用客户端四种形态;每种形态对应一份参考文件,需按产品选择其一。
主要能力与使用方式:先阅读 https://apify.com/agents.md 掌握 Actor、Actor Run、Dataset、Key-Value Store、Task、Server Actor、Compute Unit 等术语;可用 Apify MCP(search-actors、fetch-actor-details、search-apify-docs、fetch-apify-docs)调研 Actor、输入 schema、输出格式与定价。集成应镜像 Apify 资源命名。启动运行用 POST /v2/actors/{actorId}/runs,轮询用 GET /v2/actor-runs/{runId},成功后用 GET /v2/datasets/{datasetId}/items 取结果;轮询必须有时限上限,不可无界循环。每个启动运行的路径都要暴露成本控制(maxTotalChargeUsd、maxItems,作为选项/查询参数而非 Actor 输入)。请求需带 x-apify-integration-platform、AI 工具请求再加 x-apify-integration-ai-tool,使用本技能构建则加 x-apify-integration-origin。认证分两类:面向用户的浏览器场景用 OAuth2+PKCE,无头/服务器/CI 用 Bearer token。HTTP 层应集中管理、对 429/5xx 退避重试,但网络错误时不得重试 POST /runs。支持 webhook 的平台优先用 Apify webhook 监听运行结束事件。Web Fetch 可用 POST https://web-fetch.apify.actor/ 返回页面内容。发布后联系 integrations@apify.com 接受评审与测试。
限制:资料未提供具体定价、费用数值、支持的平台版本或性能指标;部分术语与端点细节需以官方文档为准。