Apify × n8n：从 Actor run 到可用数据的最小工作流

证据口径：本页于 2026-07-30 按 Apify n8n 官方集成文档 核对。示例没有连接本站账户、没有触发新 run，因此不写“本站已跑通”。

Apify 在 n8n 中使用 community node，包名是 @apify/n8n-nodes-apify。它能运行 Actor/Task、读取 run 与存储，也能在 Actor/Task 运行结束时触发工作流。

官方节点也提供“运行并返回 Dataset items”的组合操作。它适合短流程；需要审计状态、日志与结果归属时，保留显式步骤更容易定位失败：

Manual Trigger
  → Apify: Run Actor (Wait for finish = true)
  → IF Run.status = SUCCEEDED
  → Apify: Get Dataset Items
     Dataset ID = 同一个 Run 的 defaultDatasetId
  → 你的下游：Google Sheets / 数据库 / HTTP

Wait for finish 返回后，SUCCEEDED、FAILED、TIMED-OUT 和 ABORTED 都可能是终态。只有 SUCCEEDED 进入取数分支；其他终态记录 runId、status 与 statusMessage 后停止写入。不要在第一次就加入 AI 总结、十个分支和自动群发，先证明一条输入能产生正确 Dataset，再扩工作流。

安装与认证怎么选

API key 只放 Credentials。不要把 token 写进 HTTP URL、Code node、工作流名称或可导出的 JSON。

自托管 n8n 只有在使用 Apify 完成事件 trigger 时，才需要把 WEBHOOK_URL 配成 Apify 可访问的外部地址；默认指向 localhost 的 webhook 无法接收平台回调。纯 Manual/Cron → Run Actor action 流程不依赖这个外部回调。

节点配置顺序

1. 在任务页确认 Actor slug、输入字段和小样本上限。
2. 添加 Run Actor，先用固定 JSON 输入，并开启 Wait for finish。
3. 从等待完成后的 Run 输出读取 id、status、statusMessage 和 defaultDatasetId，不要拿启动时的旧响应猜最终状态。
4. 加状态门禁：仅 SUCCEEDED 进入结果分支；FAILED、TIMED-OUT、ABORTED 进入告警或人工复核。
5. 添加 Get Dataset Items，Dataset ID 使用同一个 Run 的 defaultDatasetId，不写死测试 ID。
6. 在结果后检查 0 条、必需字段、字段选择与去重，再写入下游；从 Run 输出显式补充追踪字段。
7. 需要持续运行时，最后才换成 Cron 或 Apify trigger。若使用 trigger，同样只让成功事件进入取数分支。

一份 Actor 专属的输入边界示例

{
  "queries": "coffee shops in Shanghai",
  "maxCrawledPlacesPerSearch": 10
}

这两个字段来自特定 Google Maps 类 Actor 的结构示例，不是 Apify Actor 的通用输入。必须以所选 Actor 的当前 input schema 为准；换 Actor 时不要照抄字段名。上线前把数量、地区、语言、允许的目标域名和最大费用写成工作流约束。Actor、Task 与输入复用的区别见 Actors 与 Store 指南。

常见故障

把 Google Sheets 当交付层，而不是数据库

小批量名单和人工复核适合写进 Sheets；大结果、嵌套字段、长期历史或多人并发更新更适合数据库/对象存储。先在 n8n 里选择需要的列，再从 Run 节点显式补充来源 URL、Run ID 和采集时间后写表格。完整交付路线见 Apify → Google Sheets 指南。

自动化的完成标准是：能从下游的一行数据追溯到同一次 Actor run，而不是画布上所有节点都变绿。