SuperAPI AI 工具集

apify-integration-development

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:为某公司产品设计并构建官方 Apify 集成,覆盖 Apify 支持的全部集成形态——工作流自动化平台(Zapier、n8n、Make、Pipedream、Activepieces)、AI 智能体插件(Cursor、Claude Code、Codex、GitHub Copilot 等编码智能体,以及 OpenClaw、Hermes 类运行时)、AI 框架包(PyPI/npm,如 LangChain、LlamaIndex、Haystack、Vercel AI SDK)和直接调用客户端的应用集成。

主要能力与规则:先阅读 https://apify.com/agents.md 掌握 Apify 模型与术语(Actor、Actor Run、Dataset、Key-Value Store、Actor Task、Apify Store、Compute Unit),术语需保持与平台一致。按形态选择一个参考文件(references/workflow-automation.md、ai-harness-plugin.md、ai-framework-package.md、sdk-integration.md)。跨形态规则包括:采用异步运行流程与有界轮询,不使用 300 秒同步端点;每次启动运行都暴露成本控制,如 maxTotalChargeUsd 与 maxItems(作为选项/查询参数发送,不放进 Actor 输入);请求加 x-apify-integration-platform 等归因头;鉴权按场景选择 OAuth2+PKCE 或 API token(Authorization: Bearer);集中式 HTTP 层,对 429/5xx 指数退避重试,但网络错误不重试 POST /runs;将 Apify 错误映射到宿主平台错误类别并返回原始错误文本;优先用 webhook 而非轮询感知运行完成;宿主支持时用 OpenAPI(https://apify.com/openapi.json)生成字段;在通用运行之外提供少量高层便捷操作;测试分模拟与真实 E2E,发布走 CI。

必要用法:可用 Apify MCP 工具(search-actors、fetch-actor-details、search-apify-docs、fetch-apify-docs)调研 Actor 与文档,匿名子集无需账号。核心 API 包括 POST /v2/actors/{actorId}/runs、GET /v2/actor-runs/{runId}、GET /v2/datasets/{datasetId}/items、POST/GET/DELETE /v2/webhooks、GET /v2/users/me 等。发布后需联系 integrations@apify.com 供官方审核验证。

限制:资料未提供具体收费与价格信息;这是导入的上游技能,执行前需自行核实凭据、权限与安全边界,不能替代环境相关的验证、测试与维护者审查。