# 在代理里读取一条缓存中的域名快照

网站流量 MCP：在代理里读取域名快照

连接 Vaneform MCP，调用 lookup_domain 与 compare_bulk，并把缓存状态、积分和套餐限制跟每条结果放在一起。

Kai · 核查于 2026-10-24

HTTP 指南给出 curl 和要保留的字段。这一篇走代理。用同一把 vf_live_ 钥匙接上 MCP，先调用 get_account，再对两个公开域名调用 lookup_domain，把快照返回的 status 记下来，包括 missing。多个主机放在同一次调用里时用 compare_bulk；问题是一条 US/EN 查询词时用 lookup_keyword。

## 先接上服务器，再读账户

MCP 端点是站点源上的 POST /mcp。公开站点上就是 https://vaneform.com/mcp。initialize 和 tools/list 不需要钥匙。每一次 tools/call 都要一把 vf_live_ 钥匙，和 HTTP API 用的是同一把，放在 Authorization: Bearer 头里。登录后的 API 工作台在 /account/api，MCP 标签会按你当前页面的源填好 Cursor、Claude 和 Codex 片段。下面的片段使用公开源和占位符 vf_live_…。在那个工作台创建钥匙，放进客户端请求头；Codex 则放进 VANEFORM_API_KEY。公开的 Skill 文件在 /skill.md，里面要求钥匙留在 SKILL.md 之外。

客户端列出工具之后，批量调用前先执行 get_account。这次调用消耗 0 积分。账户载荷包含 plan、access_tier、网站查询额度（used、limit、remaining、resets_at）和积分（used、limit、remaining、resets_at、top_up_remaining）。把这份载荷当作后面几次调用的预算。截至 2026-10-24 的核对，免费版每个 UTC 月含 100 积分，Pro 含 10,000 积分。每把钥匙每分钟 60 次、每天 5,000 次；超出后服务器返回 429 lookup_rate_exceeded，并在有 Retry-After 时带上该头。

~~~
{
  "mcpServers": {
    "vaneform": {
      "url": "https://vaneform.com/mcp",
      "headers": { "Authorization": "Bearer vf_live_…" }
    }
  }
}

claude mcp add --transport http --scope user vaneform https://vaneform.com/mcp --header "Authorization: Bearer vf_live_…"

export VANEFORM_API_KEY=vf_live_…
codex mcp add vaneform --url https://vaneform.com/mcp --bearer-token-env-var VANEFORM_API_KEY
~~~

参考资料:

- [Vaneform API 文档](https://vaneform.com/docs/api)
- [Vaneform MCP 服务器源码](https://github.com/vaneform/vaneform-mcp)

## 调用 lookup_domain，保留收到的 status

把 lookup_domain 调用两次。第一次 domain 填 google.com，第二次填 example.com。include 保持默认的四族：scale、registry、profile、popularity。读取缓存前会去掉开头的 www. 并把主机名转成小写，因此 www.google.com 和 google.com 请求的是同一个主机。可选的 include=baidu 加上缓存中的百度权重，免费版也能用。可选的 include=search 加上仅 Pro 可用的关键词排名（排名关键词、落地页、搜索竞品），来自已保存的月份。这次步骤停在默认的四族。

先读资源的 status，再看任何访问字段。status=missing 表示缓存里没有该主机的快照。访问数留空，并记下 missing。ready 或 partial 的快照可以带有 scale。scale 出现时，把 estimate（site 或 search）、visits、month、as_of 和 confidence 跟数字放在一起。这次域名读取只走缓存：该调用的 refresh_policy 保持 cache_only，再发一次相同调用也不会去买上游补数。读取时间写在你自己的笔记里，和 month、as_of 分开。你执行当天 google.com 和 example.com 返回什么，就是那次观察；本指南不给这两个主机填写访问数。

截至 2026-10-24 的核对，一条新的 ready 或 partial 域名消耗 1 积分。带上 include=search 时，若域名资源是 ready 或 partial，且没有已保存的排名或该排名 status 为 ready，服务器扣 200 积分。已保存排名的 status 为 missing、error 或 partial 时扣 0；域名资源本身是 missing 或 error 时也扣 0。同一账户、同一主机、同一种扣费（普通查询为 lookup，带 search 时为 advanced）在此前 24 小时内已有回执时，扣 0。免费版钥匙发送 include=search 会收到 403 search_requires_pro。现行积分数以 API 文档为准，那一页渲染的是当前的积分常量。

~~~
get_account

lookup_domain
domain: google.com
include: scale,registry,profile,popularity

lookup_domain
domain: example.com
include: scale,registry,profile,popularity
~~~

## 每个工具负责哪一件事

MCP 工具清单在每条说明里写了这件事要做什么。积分列是服务器对这件事实际扣的数，来自积分常量和查询路径，核对日为 2026-10-24。写着 0 的行仍会返回载荷自己的 status、覆盖范围和日期。研究工具是说明里写明消耗 0 积分的五个调用：research_site、get_research_workspace、save_research、monitor_research、manage_research。

| 工具 | 任务 | 积分 |
| --- | --- | --- |
| lookup_domain | 缓存快照：scale、registry、profile、popularity。可选 baidu。可选的 Pro search。status=missing 表示缓存没有快照。 | 新的 ready 或 partial 域名扣 1。include=search：域名 ready 或 partial 且没有已保存排名或排名为 ready 时扣 200；该排名 status 为 missing、error 或 partial 时扣 0。同一种扣费的 24 小时回执扣 0。 |
| get_account | 套餐、网站查询额度和积分余额。批量调用前先读它。 | 0 |
| lookup_keyword | US/EN 关键词简报：月搜索量、难度、CPC 和 Google 占位。最多 30 条 Google 结果。仅 Pro。 | 缓存命中且 status 为 ready 或 empty 时扣 0。未命中且返回 status ready 时扣 60。 |
| compare_bulk | 多个域名的 scale 和 registry。月访问缺失时获取 scale，注册记录需要刷新时获取 registry。重复域名只留一次。免费版 3 个域名，Pro 30 个。 | scale 或 registry 为 ready 或 partial 的每个对比域名扣 1。该域名在此前 24 小时内已有 lookup 回执时扣 0。 |
| compare_tld | 同一个可注册名称在多个后缀上的对比。默认后缀为 com、ai、io。example.com 会按 example 读取。响应顺序跟随返回的 suffixes 列表。 | 每个有 scale 或 registry 数据的对比域名扣 1，24 小时回执与 compare_bulk 相同。 |
| research_site | 免费的早期研究。tool 取 site-overview、google-ads、adsense、meta-ads、outbound-links、ad-keywords、discovery、dr-growth 之一，并带上 q 和工具说明里的可选过滤。 | 0。响应里带 credits_spent: 0。 |
| get_research_workspace | 当前钥匙所属账户的已保存研究、文件夹、私人笔记、工具历史、监测和站内变更通知。 | 0 |
| save_research | 保存一次站点工具查询，并带上 label、folder 和 notes。Skill 文件把单个账户的保存上限写为 200 个目标。 | 0 |
| monitor_research | 按日或按周监测一条 Google Ads 或 AdSense 查询。interval_days 为 1 或 7。Skill 文件把单个账户的监测上限写为 50 个目标。 | 0 |
| manage_research | remove_save、update_monitor、remove_monitor、check_monitor 或 read_event，id 来自 get_research_workspace。 | 0 |

MCP 工具、工具清单里写明的任务，以及 2026-10-24 核对的扣费。

## 对已经点名的主机运行 compare_bulk

问题是「这些主机并排看」时，调用 compare_bulk，q 里用逗号或换行分隔域名。第一次用 google.com,example.com 就够。重复主机只留一次。工具返回 scale 和 registry。月访问缺失时它会去获取 scale，注册记录需要刷新时会去获取该记录。lookup_domain 仍然只读缓存；能补上缺失月访问的是这条对比路径。逐条读返回项的 scale status 和 registry status。某个主机失败时可以带着 reason lookup_failed 出现在跳过列表里，其余行仍然返回。

免费版一次最多对比 3 个域名，Pro 最多 30 个，和网站对比页的上限相同。超出上限会返回 invalid_request，错误信息里写着这个上限。scale 或 registry 为 ready 或 partial 的每个对比域名扣 1 积分；该主机在此前 24 小时内已有 lookup 回执时，这一次扣 0。批次大到剩余余额会影响下一步时，对比之后再调一次 get_account。同一件事的网页在 /bulk。

~~~
compare_bulk
q: google.com,example.com
~~~

## lookup_keyword 用来读查询词

lookup_keyword 回答的是一条查询词。市场是 US/EN：默认市场 id 为 us，语言代码为 en。传入 q，例如 website traffic。去掉首尾空白后，长于 200 个字符的字符串无效。匹配和返回的 keyword 使用转成小写、折叠空格后的前 80 个字符。简报可以包含月搜索量、难度、CPC 和 Google 占位，工具说明把 Google 样本上限写为 30 条结果。缓存快照的 status 为 ready 或 empty 时扣 0 积分。缓存未命中且返回 status ready 时扣 60 积分。status=empty 表示结果没有行，扣 0。免费版钥匙会收到 403 pro_required。

中文短语可以作为 q 的文本，这个工具的市场仍然是 US/EN。域名的排名是另一次调用：lookup_domain 加上 include=search，仅 Pro，读的是该主机已保存的排名。你手里是查询词、还没有主机时，用 lookup_keyword。你已经有主机，需要它在已保存月份里的排名关键词、落地页和搜索竞品时，用 include=search。站点上的关键词页是 /keyword。

~~~
lookup_keyword
q: website traffic
~~~

## 套餐门槛、研究工具和余额不足

五个研究工具消耗 0 积分。research_site 需要 tool 和 q。tool 的取值是 site-overview、google-ads、adsense、meta-ads、outbound-links、ad-keywords、discovery、dr-growth。可选参数包括 mode、region、1 到 100 的 limit、访问量、DR 和域名年龄过滤，以及返回的 cursor。get_research_workspace 读取这把钥匙所属账户的保存、历史、监测和变更事件。save_research 存一条查询，带 label、folder 和 notes。monitor_research 按 interval_days 1 或 7 监测一条 Google Ads 或 AdSense 查询。manage_research 需要 action 和该工作区里的 id：remove_save、update_monitor、remove_monitor、check_monitor 或 read_event。Skill 文件写了两条工具说明里没有点名的上限：一个账户 200 个保存目标和 50 个监测。保存和监测只属于该账户。

关键词查询和 include=search 留在 Pro。免费版钥匙会得到 pro_required 或 search_requires_pro，这些响应里带有 upgrade_url。credits_exhausted 表示余额不够这次扣费；原样再调一次，余额仍然不够。invalid_domain 和 invalid_request 是参数问题：修正主机名，或修正 include 列表。include 必须是从 scale、registry、profile、popularity、baidu、search 里选出的逗号分隔集合。开源 MCP 仓库说明这台服务器。curl 示例和 scale 字段表仍在 HTTP 指南，CSV 文件仍在 Python 指南。

参考资料:

- [Vaneform：已写明的错误与积分规则](https://vaneform.com/docs/api)

## 拿到载荷之后，打开对得上问题的页面

笔记开头写域名或关键词、status，以及载荷里真实出现的数字。有 report_url 时把链接留下。status 为 missing 时，笔记写 missing 并写上主机名。AI 引荐榜回答的是另一件事：哪些站点的生成式助手引荐访问估计在增加，并带有该榜自己的月份和口径。代理任务关心的是助手引荐时，打开那一榜。想在屏幕上做同一次对比时打开 /bulk，想在浏览器里看 US/EN 简报时打开 /keyword。

缺失的访问保持空白，较早的 as_of 留在它自己的日期上。把指标族的 status 和数值放在一起，下一步只按表里的任务去叫下一个工具。HTTP 指南负责逐字段的对照。代理能够重复那两次 lookup_domain、把 missing 的行记成 missing，并按下一个问题在 compare_bulk 和 lookup_keyword 之间选择，这一篇就完成了。

## 继续研究

- [打开 API 文档](https://vaneform.com/zh/docs/api)
- [打开 API 与 MCP 工作台](https://vaneform.com/zh/account/api)
- [在站内对比域名](https://vaneform.com/zh/bulk)
- [打开关键词简报](https://vaneform.com/zh/keyword)
- [AI 引荐榜](https://vaneform.com/zh/boards/ai-traffic)
- [阅读 HTTP 字段指南](https://vaneform.com/zh/guides/website-traffic-api-guide)

Canonical: https://vaneform.com/zh/guides/website-traffic-mcp