用 Apify 周测品牌在 AI 搜索里的声量

原文要点

该模板由 Touchrock 发布，每周一 08:00（或手动）运行 Apify 的 touchrock/ai-share-of-voice Actor，从工作流内置 JSON 读取品牌、竞品、提问词、目标 AI 引擎、国家、语言与每提问运行次数，启动运行时设最大费用上限。每两分钟轮询运行状态，非成功则报错退出；成功后从 Apify 键值存储取 OUTPUT 报告，按品牌×引擎展开成行，字段含提及率、声量份额、平均排名、引用率等，追加到 Google Sheets 指定工作表。需 Apify API token（Bearer）与 Google Sheets OAuth 凭据。

这次做成什么

搭一条每周用 Apify Actor 测品牌与竞品在多个 AI 引擎声量、并把指标追加进 Google Sheets 的 n8n 工作流；练习方案：先用本站虚构的两个品牌、三条提问、两个引擎的小配置跑通轮询与追加逻辑，再扩大清单。注意 Apify Actor 运行可能产生费用，模板用上限控制。

准备什么

• Apify 账号及 API token，并在 n8n 建 Header Auth 凭据发送 Authorization: Bearer <token>
• Google Sheets OAuth 凭据及一张已建好的目标电子表格
• 工作表已含列：date、engine、brand、yourBrand、answers、mentionedIn、mentionRatePct、shareOfVoicePct、avgListRank、citationRatePct、runUrl
• 一个可用的 n8n 实例及编辑工作流输入 JSON 的权限

具体怎么做

1. 准备凭据与表格

   在 n8n 新建 HTTP Header Auth 凭据，头名 Authorization，值 Bearer 加你的 Apify token；另建 Google Sheets OAuth 凭据。打开目标表格，按上方列名建好表头工作表。

2. 填写品牌与提问配置

   在工作流的输入 JSON 节点中填入：yourBrand 自家品牌、competitors 竞品列表、prompts 用户会问 AI 的提问词、engines 目标引擎（具体取值以该 Actor 页面实际支持为准）、country、language、runsPerPrompt。先用小清单试跑。

3. 配置触发器与启动 Actor

   Schedule Trigger 设为每周一 08:00；HTTP Request 节点以 Bearer 凭据调用 Apify 启动 touchrock/ai-share-of-voice 运行，body 传入上一步 JSON，并设置最大费用上限参数防止超支。

4. 轮询运行状态

   用 HTTP Request 查询运行状态，接 Wait 节点等待两分钟再查，循环直到成功；状态为失败/中止等非成功时走错误分支退出工作流，不写表。

5. 取报告并展开成行

   运行成功后从 Apify 键值存储取 OUTPUT 报告，用 Code 节点把报告按品牌×引擎展开，每行生成 date、engine、brand、mentionRatePct、shareOfVoicePct、avgListRank、citationRatePct、runUrl 等字段。

6. 追加到 Google Sheets

   接 Google Sheets Append 操作，选 OAuth 凭据、目标电子表格与工作表，字段映射到已建表头列；激活工作流后每周自动追加。

可直接复制的材料

{
  "yourBrand": "澄光咖啡",
  "competitors": ["山丘咖啡", "蓝鲸咖啡"],
  "prompts": [
    "推荐适合办公室提神的冷萃咖啡品牌",
    "哪些国产咖啡品牌口碑较好",
    "预算 50 元以内买什么挂耳咖啡"
  ],
  "engines": ["chatgpt", "perplexity"],
  "country": "CN",
  "language": "zh",
  "runsPerPrompt": 1
}

date,engine,brand,yourBrand,answers,mentionedIn,mentionRatePct,shareOfVoicePct,avgListRank,citationRatePct,runUrl
2026-10-19,chatgpt,澄光咖啡,true,3,2,66.7,40.0,2.5,33.3,https://console.apify.com/actors/runs/example001
2026-10-19,chatgpt,山丘咖啡,false,3,2,66.7,35.0,2.0,33.3,https://console.apify.com/actors/runs/example001
2026-10-19,perplexity,澄光咖啡,true,3,1,33.3,25.0,3.0,66.7,https://console.apify.com/actors/runs/example001

输入与输出示例

本站虚构演示，未实际运行 Actor，百分比仅为示意计算。

输入

自家品牌“澄光咖啡”，竞品“山丘咖啡”，3 条提问词，引擎 chatgpt，runsPerPrompt=1；Actor 报告显示澄光咖啡在 3 条回答中被提及 2 次、平均排名 2.5。

对应输出

追加行：2026-10-19,chatgpt,澄光咖啡,true,3,2,66.7,40.0,2.5,33.3,https://console.apify.com/actors/runs/example001 —— 即提及率 66.7%、平均排名 2.5 的一行写入表格。

做完检查这些

• Actor 启动请求返回运行 ID，且请求中带有最大费用上限参数
• 轮询循环按约两分钟间隔执行，非成功状态时工作流报错退出且不写表
• 输出行数等于品牌数（自家+竞品）乘以引擎数
• Google Sheets 中新行各列与表头一一对应，date 为运行日期

容易卡住的地方

• Apify Actor 运行按用量计费，未设费用上限或提问清单过大可能产生意外支出
• 表头列名与追加字段不一致会导致数据错位或写入失败
• Bearer token 拼写错误或凭据未挂到 HTTP 节点会返回鉴权失败
• engines 可用取值取决于 Actor 实际支持，填了不支持的引擎可能报错
• Actor 运行耗时随提问与引擎数量增长，轮询需有耐心，不要缩短间隔触发限流