SuperAPI AI 工具集

apify-sdk-integration

编程与开发

查看项目

更新于 10-15 16:51

技能介绍

用途:在已有应用中调用 Apify Actor,为应用添加网页抓取、自动化或把 Actor 结果接入数据管道,也可将 Apify 作为后端服务。

包名区分:apify-client 用于从应用调用 Actor;apify 是构建 Actor 的 SDK,集成时不要安装 apify。

前置条件:需要 APIFY_TOKEN,可在 https://console.apify.com/settings/integrations 创建;无账号可免费注册。令牌须存于环境变量或密钥管理器,不可硬编码。

选 Actor:可先用 MCP 工具 search-actors 搜索,用 fetch-actor-details 查看输入结构、输出格式与定价;也可浏览 https://apify.com/store,在 Actor 商店 URL 后加 .md 获取文档。

安装:JS/TS 用 npm install apify-client;Python 用 pip install apify-client。

调用方式:JS/TS 可 new ApifyClient({ token: process.env.APIFY_TOKEN }),同步用 client.actor('apify/web-scraper').call(input),异步用 .start() 加 client.run(run.id).waitForFinish()。Python 用 ApifyClient(token=os.environ['APIFY_TOKEN']),同步 .call(run_input=...),异步 .start() 加 .wait_for_finish(),也可用 ApifyClientAsync 配合 asyncio。

取结果:数据集用 client.dataset(run.defaultDatasetId).listItems()(Python 为 list_items()),键值存储用 keyValueStore(...).getRecord('OUTPUT')。

其他语言:直接调 REST API,如 POST https://api.apify.com/v2/actors/{actorId}/runs、GET https://api.apify.com/v2/actor-runs/{runId}、GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json,需 Bearer 令牌。

限制与建议:每个 Actor 输入结构不同,需先查 schema;短任务用 .call(),长任务用 .start() 加轮询;设置 timeoutSecs 或 waitSecs 避免无限等待;大数据集用 limit 和 offset 分页,默认上限 250K 条;复用同一个客户端实例;注意处理 Actor 失败与 401 等错误。定价与具体费用暂未在本资料提供。