用途
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.readonlyOAuth 范围,原有 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 个账户时支持分页选择。
使用方式
- 运行安装命令,该命令会打开浏览器、授权 Google 账户并安全存储凭据。
- 将其加入 MCP 客户端配置(Claude Desktop、Cursor、Antigravity 等),然后重启客户端。
- 向智能体直接输入自然语言问题,例如:
- “我的流量本周相比上周下降了,找出具体从何时开始以及哪些页面导致。”
- “找出 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。”
- 也可通过
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.readonlyOAuth 范围。 - 凭据以机器加密方式存储(操作系统钥匙串优先,AES-256-GCM 作为回退),仅在授权机器上可用;只持久化
refresh_token和expiry_date。 - 具体支持的平台、收费用途或价格信息暂未提供。