Vouched

Vouched

可供 AI 引用的 SEO 数据。一个开源 MCP 服务，支持 Search Console、Google Analytics、关键词、反向链接、实时 Google 搜索结果和 AI 答案可见度。

网站 · 工具 · 自托管 · MIT 许可证

---

向 Claude、ChatGPT 或 Cursor 提问：“为什么我们上个月的点击量下降了？”或“我们的竞争对手有哪些排名关键词是我们没有的？”，它会基于真实数据作答，而不是猜测。

每个工具都返回相同的 JSON 封装结构。其中的每条事实都注明了来源、可信度和观测时间，因此 Agent（以及你）可以分辨哪些是 Search Console 数值，哪些是索引估算值。

两种运行方式

托管于 vouchedhq.com。 在 AI 客户端中添加 https://vouchedhq.com/mcp 作为连接器并登录。你自己的 Google 数据免费；实时市场数据由 DataForSEO 提供，需要 Pro 或 Team 计划，并按成本计费。请参阅定价。

自托管。 在你自己的 Cloudflare 账户中运行同一服务，使用你自己的 Google OAuth 客户端；如果需要市场数据，还可以使用你自己的 DataForSEO 密钥。不加价，也无需在我们这里创建账户。请参阅 docs/SELF_HOST.md。

两种方式运行的是同一份代码，并提供相同的工具。

工具

共 19 个工具，全部为只读。绝不会向 Google 或任何网站写入数据。

你自己的数据（免费；需要连接 Google）

工具	可解答的问题
get_search_performance	按查询、页面、日期、国家或设备查看点击量、展示次数、CTR 和排名，并比较各时段的变化
inspect_indexing	此 URL 是否已编入索引、Google 选择了哪个规范网址、上次抓取时间
list_sitemaps	已提交的网站地图，以及错误、警告和 URL 数量
get_website_analytics	来自 GA4 的会话数、用户数和互动情况

市场数据（来自 DataForSEO：托管版需使用 Pro 或 Team 计划；自托管需使用你自己的密钥）

工具	可解答的问题
inspect_domain	某个域名的自然流量、排名关键词和主要竞争对手
discover_competitors	哪些网站在相同关键词上与某个网站竞争
research_keywords	围绕种子词的关键词创意，包括搜索量、难度、CPC 和意图
inspect_keyword	某个关键词的搜索量和难度
inspect_serp	当前在 Google 上某个查询的排名网站，以及 AI Overviews 和其他功能
inspect_search_visibility	某个域名在一组关键词上的排名
inspect_page	单个 URL 的关键词和流量
compare_keyword_coverage	竞争对手有排名而你没有的关键词
inspect_backlinks	权威度、引荐域名、锚文本和单条反向链接
compare_backlink_gap	链接到竞争对手但未链接到你的网站
discover_ai_citations	AI 答案针对某个主题引用了哪些网站
inspect_ai_visibility	某个域名在 AI 答案中被提及的频率与竞争对手相比如何

实用工具

工具	功能
describe_capabilities	此服务启用了哪些功能，以及每个工具的费用
list_websites	你跟踪的网站及其 Google 连接
export_dataset	截断响应背后的完整结果，保留 7 天

每个工具都有独立页面，介绍输入、输出和响应示例，详见 vouchedhq.com/tools。自动生成的参考文档位于 docs/TOOLS.md。

数据来源

Vouched 没有自己的搜索索引或网络爬虫。Vouched 构建并运行的是 MCP 服务：登录、响应封装、每条事实的来源信息和置信度、缓存、周期对比、导出和计费。工具背后的数据来自你的 Google 账号或 DataForSEO：

工具	上游 API	provenance 中的来源类别
get_search_performance、inspect_indexing、list_sitemaps	Google Search Console API（Search Analytics、URL Inspection、Sitemaps），使用你自己的 Google 登录信息读取	webmaster_console
get_website_analytics	Google Analytics Data API（GA4），使用相同的登录信息	analytics_property
inspect_domain、discover_competitors、research_keywords、inspect_keyword、inspect_page、compare_keyword_coverage	DataForSEO Labs API	search_index
inspect_serp	DataForSEO SERP API（实时 Google 搜索结果）	live_serp
inspect_search_visibility	DataForSEO Labs API；如果要求实时重新检查排名，则还会使用 SERP API	search_index、live_serp
inspect_backlinks、compare_backlink_gap	DataForSEO Backlinks API	backlink_index
discover_ai_citations、inspect_ai_visibility	DataForSEO AI Optimization API（LLM Mentions，用于 Google AI Overviews 或 ChatGPT）	ai_answer
describe_capabilities、list_websites、export_dataset	无：Vouched 自有数据	无

在托管的 Pro 和 Team 计划中，市场数据调用通过 Vouched 的 DataForSEO 账号进行，并计入计划包含的市场数据额度，按 DataForSEO 的成本计费（参见定价）。可自托管时，调用使用你自己的 DataForSEO 密钥。DataForSEO 只会收到请求中涉及的关键词、域名和 URL，不会收到你的 Google 数据。

响应示例

精简后的 get_search_performance 结果：

{
  "schema_version": "ofe/1.0",
  "domain": "gsc",
  "data": { "domain": "xmit.sh", "startDate": "2026-08-28", "endDate": "2026-09-24", "dimensions": ["query"] },
  "facts": [
    {
      "type": "gsc.query_performance",
      "subject": ["property:...", "keyword:any:GLOBAL:transactional email api"],
      "data": { "dimensions": { "query": "transactional email api" }, "clicks": 41, "impressions": 3120, "ctr": 0.013, "position": 8.2 },
      "provenance": {
        "source_class": "webmaster_console",
        "method": "gsc.searchAnalytics.query",
        "confidence": 1,
        "observed_at": "2026-09-25T08:00:00Z",
        "cache_hit": false
      }
    }
  ],
  "deltas": [{ "fact_type": "gsc.query_performance", "field": "clicks", "previous": 29, "current": 41 }],
  "coverage": { "returned": 25, "total": null, "scope_note": "capped at 25 rows; more are available via export_dataset" },
  "resources": [{ "uri": "mcpseo://gsc/...", "description": "Up to 1000 rows for this same query" }],
  "next_actions": []
}

deltas 用于和上一周期对比，coverage 说明结果未包含的内容，resources 保存其余内容，next_actions 会在有用时建议后续调用。完整结构见 docs/OFE_ENVELOPE.md。

连接客户端

托管服务：

# Claude Code: the plugin (MCP server plus an SEO analysis skill)
claude plugin marketplace add muditjuneja/vouched
claude plugin install vouched@vouched

# Claude Code: the MCP server only
claude mcp add --transport http vouched https://vouchedhq.com/mcp

# Gemini CLI
gemini extensions install https://github.com/muditjuneja/vouched

在 Claude 或 ChatGPT 中，将 https://vouchedhq.com/mcp 添加为自定义连接器。在 Cursor 中，将其添加到 ~/.cursor/mcp.json：

{ "mcpServers": { "vouched": { "url": "https://vouchedhq.com/mcp" } } }

客户端首次使用时会打开登录页面（标准 MCP OAuth）。只能发送标头的客户端可以改用控制面板中的 API 密钥。

可自托管时，将客户端指向 Worker 的 /mcp URL，并提供你的 bearer token；参见 docs/SELF_HOST.md。

开发

npm install
cp .dev.vars.example .dev.vars   # MCP_BEARER_TOKEN at minimum
npm run db:migrate:local
npm run dev                      # http://localhost:8787/mcp

npm test
npm run typecheck
npm run lint

开发时设置 DATAFORSEO_BASE_URL=https://sandbox.dataforseo.com：DataForSEO 的沙盒免费，并会按真实响应结构返回虚拟数据。

基于 Cloudflare Workers、Hono、D1、R2 和 KV 构建。不使用 Google SDK：直接调用 Google API。

文档

• 自托管
• 架构
• 响应封装
• 工具参考
• 托管服务内部实现和部署说明

隐私

只有在你提出请求时才会读取 Google 数据，并遵守 Google 的 Limited Use 要求。数据绝不会被出售、用于广告或用于训练 AI 模型。参见隐私政策。

贡献与支持

欢迎提交问题和拉取请求。有关托管服务，请发送邮件至 [email protected]。

许可证

MIT