SuperAPI AI 工具集

search-console-mcp

search-console-mcp 是一个面向 AI 智能体和自动化流程的 MCP 服务器,将 Google Search Console、Bing Webmaster Tools、Google AdSense 和 GA4 的数据整合在同一套工具中,让用户可以直接用自然语言向 AI 智能体查询网站流量、排名和收入情况,无需在多个后台之间导出 CSV 并手动比对。该项目支持多账户自动识别、并行抓取引擎和 100% 向后兼容的旧版工具名,并提供 CLI 直接运行工具的能力。

访问官网

工具介绍

用途

search-console-mcp 是一个基于 MCP(Model Context Protocol)的服务器,把 Google Search Console、Bing Webmaster Tools、GA4 和 Google AdSense 的站点数据整合到同一套工具中,供 AI 智能体和自动化流程直接调用。它解决的问题是站点数据分散在四个不同的后台系统里:要回答“广告收入下降是因为流量下滑还是 RPM 降低”这类问题,通常需要登录四个控制台、导出四份 CSV、再手工做 VLOOKUP。该工具把四类数据放到一组工具之后,并在数据进入上下文窗口之前完成分析(如关键词蚕食、异常检测、收入归因)。

主要能力

  • 多引擎数据整合:统一接入 Google Search Console、Bing Webmaster Tools、GA4 和 Google AdSense。
  • GenAI Query Insights(genai_query_insights):针对 Google 和 Bing 返回的常规查询数据,通过自定义启发式逻辑标记可能的生成式 AI / AI 模式 / 对话式“fanout”查询。官方并未提供 GenAI 引用数据 API,因此该功能基于提示词动词、追问、确认语和对话式措辞进行识别。
  • AdSense 集成:通过 setup --engine=adsense 获取收入报告、付款和账户提醒。启用 AdSense 需要单独授权 adsense.readonly OAuth 范围,原有 GSC、Bing、GA4 配置在未选择启用前保持不变。
  • 并行抓取引擎(engine: "all"):多引擎查询可并发抓取 Google、Bing 和 GA4,延迟降低 50% 以上。
  • 向后兼容:约 96 个旧版工具名(如 bing_sites_list、seo_quick_wins、sitemaps_get、bing_index_now、indexing_submit_url、opportunity_matrix 等)通过回退路由继续可用。
  • fluent 领域工具架构:v2.0 提供 7 个 Fluent Domain Tools,覆盖 SEO、分析、检查与索引操作。
  • CLI 直接运行:已注册的 MCP 工具也可作为 CLI 命令直接执行,通过 run 子命令列出工具、查看参数,并以 JSON、CSV 或 ASCII 表格输出结果。
  • 多账户支持:智能体查询某个站点时,服务器自动解析该站点归属的账户,无需手动切换;超过 100 个账户时支持分页选择。

使用方式

  1. 运行安装命令,该命令会打开浏览器、授权 Google 账户并安全存储凭据。
  2. 将其加入 MCP 客户端配置(Claude Desktop、Cursor、Antigravity 等),然后重启客户端。
  3. 向智能体直接输入自然语言问题,例如:
    • “我的流量本周相比上周下降了,找出具体从何时开始以及哪些页面导致。”
    • “找出 example.com 上排名 8–15 位、展示量 1,000+ 的关键词。”
    • “检查关键词蚕食——是否有两个页面在竞争同一个查询?”
    • “对头部页面运行 seo_audit:哪些搜索可见度高但点击率低?”
    • “运行完整 SEO 健康检查(site_health_check),按品牌 / 非品牌拆分。”
    • “对比最近 30 天 Google 与 Bing 的表现(compare_engines)。”
    • “用 indexing_submit 的 method: "index_now" 提交最新 URL 到 Google 和 IndexNow。”
  4. 也可通过 run 子命令在 CLI 中直接执行已注册工具。

关于账户连接:AdSense 不支持服务账号,且配置文件按机器加密,因此需要在带浏览器的机器上授权一次并转移授权。令牌加密存储在服务器上并自动刷新,之后无需再使用浏览器。SSH 环境下安装也可直接进行:检测不到浏览器时,setup 会打印授权 URL 以及 ssh -L 3000:localhost:3000 端口转发说明。

服务账号方式:在 Google Cloud Console 创建服务账号、生成 JSON 密钥、将该服务账号邮箱以“完全”或“受限”权限添加为 Search Console 用户,然后设置 export GOOGLE_APPLICATION_CREDENTIALS="/path/to/key.json"。

适用场景

适合需要让 AI 智能体自动查询、分析并回答 SEO、搜索表现、网站流量和广告收入问题的场景,例如:

  • 流量下降的定位与归因分析
  • 关键词蚕食检测
  • 快速见效关键词挖掘(排名 8–15 位、展示量较高)
  • 页面 SEO 审计与点击率分析
  • 品牌词与非品牌词的健康检查
  • Google 与 Bing 表现对比
  • URL 索引提交
  • 收入报告排序与自定义日期区间分析

限制

  • GenAI Query Insights 为自定义启发式逻辑,并非官方 API 数据;Google 和 Bing 未提供 GenAI 引用数据接口。
  • AdSense 仅支持用户 OAuth,不支持服务账号;启用 AdSense 需要单独批准 adsense.readonly OAuth 范围。
  • 凭据以机器加密方式存储(操作系统钥匙串优先,AES-256-GCM 作为回退),仅在授权机器上可用;只持久化 refresh_token 和 expiry_date。
  • 具体支持的平台、收费用途或价格信息暂未提供。