面向代理公司的市场调研 API：一套配置，服务所有客户

代理公司的调研难题，很少是一个难回答的问题。它是同样那几个问题，每个客户、每个月都要问一遍；再加上每次新业务团队要在周四前交比稿方案时，都得重新摸一遍市场。

一个面向代理公司的市场调研 API，就得为这种重复而设计：一套配置跑完整个客户名单，成本能按客户拆分，还能在拿下客户之前，对潜在客户先做一轮快速调研。CrawlForge 就是做这件事的网页数据层。它读取你指定的公开网页和搜索结果，并返回上面写了什么。它不是市场规模数据库，也不是联系人数据库。

每月的客户报告需要什么？

对大多数代理公司来说，每个客户需要两样东西：客户在关键搜索词上相对竞争对手的排名，以及这些竞争对手在自己网站上改了什么。两者都是公开信息，每个月都在变，而且都不在任何可以按行购买授权的数据集里。

两个调用就能覆盖：

• serp_rank（5 个 credits）返回某个域名在某个关键词下的 Google 自然排名，按你为每个客户设置的 location_name、language_code 和 device 查询。响应包含 found、rank、排名所在的 url 和 checked_at。
• 带 question 格式的 scrape（3 个 credits）原文返回竞争对手页面上最能回答你问题的五个句子，每句都带偏移量。面向 RevOps 的那篇文章讲了这个格式的行为；在这里，它只是模板里的一行。

怎样用一套模板跑完所有客户？

把每个客户特有的东西都放进数据，而不是代码。每个客户就是一份小配置：域名、市场、关键词、竞争对手，以及你要向对方页面提出的问题。

{
  "client": "Northwind",
  "domain": "northwind.co.uk",
  "location_name": "United Kingdom",
  "device": "mobile",
  "keywords": ["office cleaning contracts", "commercial cleaning manchester"],
  "competitors": ["rival-a.co.uk", "rival-b.co.uk", "rival-c.co.uk"],
  "pages": ["https://rival-a.co.uk/pricing", "https://rival-b.co.uk/services"],
  "questions": ["What is the minimum contract length?"]
}

然后用一个工作流遍历整个客户名单。每个关键词，为客户调用一次 serp_rank，再为每个竞争对手各调用一次，因为一次调用只定位一个域名。每个竞争对手页面，每个问题运行一次 scrape。

curl -X POST https://crawlforge.dev/api/v1/tools/serp_rank \
  -H "X-API-Key: cf_live_NORTHWIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "office cleaning contracts",
    "target": "northwind.co.uk",
    "location_name": "United Kingdom",
    "device": "mobile"
  }'

在 n8n 里，这个循环就是一个读取配置的节点，后面接两个 HTTP Request 节点（n8n 的配置方法见文档）；写成脚本就是两层嵌套循环。第十三个客户只是一份新的配置文件，而不是一个新的工作流。

给每个客户单独建一个命名的 API 密钥，请求日志就会按客户拆分当月的花费，面向顾问的那篇文章有详细步骤。一个账户最多十个密钥，所以客户超过十个时，就按服务费档位分组。

比稿之前，怎样调研潜在客户？

先跑一次 deep_research，10 个 credits。告诉它潜在客户的品类和市场，它会搜索、抓取最多十个来源，原文返回最匹配的段落，并附上 sources 网址列表。然后再对潜在客户最明显的三个关键词跑 serp_rank，多花 15 个 credits。

每个潜在客户 25 个 credits，按额度包价格算不到 0.1 美元，而方案里就多了一页“你今天排在哪里”。这一页往往是对话的开场；比稿没拿下，它也几乎没花什么钱。

一个客户名单每月花多少钱？

十二个客户，每个客户五个关键词、三个竞争对手、六个竞争对手页面，每个页面两个问题：

按一次性 5,000 credits 额度包（$14）的价格算，大约每月 $5，不按席位收费，也没有每月最低消费。排名查询是最贵的一项，因为它是关键词数乘以域名数，所以先从排名循环里减竞争对手，再考虑减关键词。

它不会做什么？

• 不做市场规模测算。 没有 TAM、样本组或问卷数据。如果方案需要市场规模数字，请从行业报告里找。
• 没有联系人或企业属性（firmographic）数据。 它读取的是网页和搜索结果，不是企业数据库。
• 没有客户门户。 没有白标仪表盘；报告就是你用这些数据行搭出来的东西。
• 默认遵守 robots.txt，适用于你抓取的页面。被禁止的页面会在抓取之前被拒绝，不收费。

如果客户希望竞争对手页面一变就收到通知，而不是等到月底在报告里读到，那需要的是每个客户一个监控，而不是更频繁地跑这套流程。

免费开始，送 1,000 个 credits。足够让这套模板为七个客户跑一个月，再接入整个客户名单。