Google Search Console MCP 服务器让 Claude、Claude Code、Codex、Cursor 这类 AI agent 能调用 Search Console API:拉取点击次数、展示次数、点击率和平均排名,检查某个网页有没有被编入索引,列出你的站点地图。你用平常的话提问,比如「哪些网页排在第一页却没人点?」,agent 去查数据,再逐行分析。这篇比较三种接法,讲清 API 拿不到什么,并带你做一次能在 Search Console 里自己核对的首次审计。
简单说:截至 2026 年 11 月 9 日,Google 没有官方的 Search Console MCP 服务器。Google 只给 Google Analytics 出了一个;Claude 和 ChatGPT 的目录里,也没有 Google、Anthropic 或 OpenAI 做的 Search Console 连接器。你的选择有三种:自己运行的免费社区服务器,需要建一个 Google Cloud 项目;用 Google 账号登录的托管服务器;或者内置连接器的应用,比如 Orkas,点一下「连接」就行。三种读的都是同一个 API,而这个 API 不会列出所有查询:Google 不列匿名查询,Ahrefs 对 887,534 个 Search Console 资源的研究发现,这部分占了 46.77% 的流量。
Search Console MCP 能做什么、做不到什么
不管是社区做的还是商业的,所有 Search Console MCP 服务器调用的都是同一个免费的 Search Console API。它能做什么,取决于这个 API。下表根据 Google 的 API 参考和用量限制整理。
| 你想要的 | API | 限制 |
|---|---|---|
| 按查询、网页、国家/地区、设备、日期或搜索结果呈现分组的点击、展示、点击率和排名 | Search Analytics | 可查 16 个月;数据晚约 2–3 天;每次请求最多 25,000 行,每种搜索类型每天最多 50,000 行 |
| 某个网址有没有编入索引、上次抓取时间、Google 选定的规范网址 | URL Inspection | 每次一个网址;每个资源每天 2,000 次 |
| 你的站点地图和其中的错误 | Sitemaps | 读取只要只读权限;提交或删除要完整权限 |
| 你能看到的资源 | Sites | 添加或移除资源要完整权限 |
Search Console 里有些东西没有 API,所以任何 MCP 服务器都拿不到:
- AI 概览和 AI 模式的数据。Google 在 2026 年 8 月 31 日向所有网站开放了生成式 AI 效果报告,但 API 参考里没有对应的搜索类型,也没有对应的搜索结果呈现类型。
- 较新的报告选项。多模态搜索类型和品牌查询过滤条件,API 参考里同样没有。
- 测试线上网页。网址检查报告的是 Google 索引里的那个版本。API 文档写明:「无法测试线上网址能否编入索引。」
- 「请求编入索引」按钮("Request indexing")。只有 Search Console 里有。有些服务器会调用 Google 另外的 Indexing API,但官方规定它只用于招聘信息和直播页面。
把 Search Console 接到 Claude、Claude Code 或 Codex 的三种方式
| 接法 | 要做的设置 | 数据经过哪里 | 费用 |
|---|---|---|---|
| 自己运行的社区服务器,如 mcp-gsc | Google Cloud 项目、启用 API、创建凭据、写一条配置 | 从你的电脑直接到 Google | 免费 |
| 托管服务器,如 mcpsearchconsole.com | 用 Google 登录,把服务器网址粘贴到 AI 应用里 | 经过服务商的服务器 | 有免费档,之后按月订阅 |
| Orkas 内置连接器 | 点「连接」,用 Google 登录 | 从你的电脑直接到 Google | 连接器免费 |
- 社区服务器免费,功能也最全。最受欢迎的 AminForou/mcp-gsc 在 2026 年 11 月 9 日有 2,151 个 GitHub 星标。它的源码里有 21 个工具,包括对比两个时间段、一次检查最多 10 个网址,以及(你允许的话)提交站点地图。代价是设置:你得自己创建 Google 凭据。r/TechSEO 上有人说,Google Cloud 是「唯一的麻烦」。
- 想在网页版 claude.ai 或 ChatGPT 里用,托管服务器最快。它们是远程服务器,填网址就能加。Claude 帮助中心说,所有套餐都能用自定义连接器,但「免费用户只能添加一个自定义连接器。」mcpsearchconsole.com 标的免费档是每月 40 次取数、3 个资源,之后每月 €4.99(不含增值税)。你的 Search Console 数据会经过服务商,用之前先看它的隐私条款。
- 内置连接器省掉 Google Cloud 那一步。在 Orkas 里用 Google 登录即可,连接器在你的电脑上运行。它是只读的,只有 4 个工具,比社区服务器少。
自己运行社区服务器
下面的步骤依据 mcp-gsc 0.4.2 版(2026 年 11 月 6 日)的 README。写这篇时我们没有建 Google Cloud 项目,动手前请再对照一遍 README。
- 创建 Google 凭据。在 Google Cloud 控制台新建项目,启用 Search Console API,再创建一个类型为 Desktop app 的 OAuth 客户端 ID,下载它的 JSON 文件。要做自动化的话,改建一个服务账号,然后在 Search Console 的「设置 → 用户和权限」里把它的邮箱加进去,权限选「完整」。
- 安装 uv。README 推荐用
uvx运行服务器,它会替你处理 Python。不用它的话,需要 Python 3.11 或更高版本。 - 把服务器加到你的 agent 里。在 Claude Code 里:
在 Codex 里:claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
这两条命令我们在 Claude Code 2.1.311 和 Codex CLI 0.163.0 上核过。Claude Desktop 和 Cursor 用的是 JSON 配置,README 要求写codex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-consoleuvx的完整路径,因为从 Dock 或开始菜单打开的应用可能找不到它。 - 登录一次。第一次使用时会弹出浏览器窗口,让你登录 Google。从 0.4.2 起,除非设置
GSC_ALLOW_DESTRUCTIVE=true,服务器只申请只读权限。
有个坑,社区教程都没提:如果你的 OAuth 同意屏幕设成 External、发布状态停在 Testing,Google 的 OAuth 文档写明,刷新令牌 7 天后就会失效,你每周都得重新登录一次。避开的办法是把应用发布到正式环境,或者改用服务账号。发布后的应用可能会显示「未经验证的应用」警告;Google 允许用户数少于 100 的个人用途应用点过这个警告继续使用。
在 Orkas 里连接 Search Console
Orkas 是 macOS 和 Windows 上的桌面应用,多个 AI agent 在同一个对话里协作。它内置了 Google Search Console 连接器,所以不需要 Google Cloud 项目。
- 安装 Orkas 并登录。下载 macOS 或 Windows 版。新账号送 500 积分,可以用 Orkas 内置的模型,开始时不需要 API Key。
- 打开连接器页。点侧边栏的连接器,找到 Google Search Console。用数据筛选,或者直接搜索都能找到。
- 点「连接」,用 Google 登录。点连接,选能看到你资源的那个 Google 账号,允许只读访问。卡片会移到已连接。
- 直接说你要什么。在对话里输入 @ 选 Google Search Console 连接器,或者直接描述任务。agent 会先列出你的资源,再查询你指定的那个。
- 它是只读的。Orkas 向 Google 只申请
webmasters.readonly这一个权限范围。4 个工具分别是列出资源、查询效果数据、列出站点地图、检查网址。因为都只读,Orkas 调用时不会逐次请你批准。它们不能提交站点地图,也不能请求编入索引;一次查询最多返回 25,000 行。 - 查询直接发给 Google。连接器在你的电脑上运行,直接调用 Search Console API。只有 Google 登录和刷新令牌这两步经过 Orkas 的服务器,因为应用的 Google 凭据放在那里。
- SeoGeoAgent 和你的编程 agent 都能用。SeoGeoAgent 是 Orkas 内置的 SEO agent,连上 Search Console 后,它在审计里会用你真实的点击、展示和排名。如果你装了 Claude Code、Codex、OpenCode、Hermes 或 OpenClaw,并在 Orkas 里接入了,它们会通过 Orkas 的工具桥调用这个连接器,不用各自再配 MCP。
- 需要写操作?在连接器页用添加 MCP 服务器,把社区服务器作为本地命令加进来。Orkas 另外还有 Bing Webmaster Tools 连接器。
一次能核对的首次审计
好的第一个请求,要的是一分钟内就能和 Search Console 对上的数字,还要让 agent 说明数据没覆盖到什么。把资源和两个网址换成你自己的:
用 Google Search Console 连接器查 sc-domain:example.com,取最近 28 天的完整数据:1)按日期列出总点击和总展示,以及查询行覆盖了其中多少比例;2)列出排名在第 5 到 15 位、展示至少 100 次、点击率低于 2% 的网页,按展示次数排序;3)https://example.com/new-page/ 和 https://example.com/old-page/ 的索引状态。每张表都写明日期范围,数据里没有的东西不要估算。
2026 年 11 月 9 日,我们用 Orkas 里的 Claude Code 跑过这个请求,连接器的 4 个工具都能正常用。我们不公开自己网站的 Search Console 数据,所以下面的结果是合成示例:一家虚构网店 example.com 的编造数字,用来展示一份靠谱的回答长什么样,以及每一项怎么核对。
- 按日期的总数(合成数据):3,480 次点击、151,200 次展示。看全站数据,就以这组数字为准。核对方法:打开效果报告,选同样的自定义日期和搜索类型,比较两个总数,应该很接近。差得多,通常是 agent 把查询行或网页行加起来当成了总数。
- 查询行(合成数据):642 行,合计 1,670 次点击,占总数的 48%。其余来自 Google 匿名处理的查询,这些查询在报告和 API 里都没有对应的行。这个比例很正常:Ahrefs 的研究发现,2025 年 4 月匿名查询占了 46.77% 的流量,很多网站还更高。agent 如果把查询行加起来当成你的总流量,可能差一半。
- 低点击率网页(合成数据):9 个网页排在第 5 到 15 位、展示至少 100 次、点击率低于 2%。展示最多的是
/blog/linen-care/:2,140 次展示,平均排名 6.8,21 次点击,点击率 1.0%。这些是最该先改标题和描述的页面。如果你的网站用以?lang=结尾的网址区分语言,每个语言版本都会单独占一行网页数据,最好让 agent 合并后再列。 - 网址检查(合成数据):旧页面已编入索引,新页面还没有。
https://example.com/old-page/是 9 月发的,状态是 "Submitted and indexed"(已提交并编入索引),上次抓取是 10 月 3 日;https://example.com/new-page/是检查前两天才发的,状态是 "Discovered - currently not indexed"(已发现 - 尚未编入索引)。核对方法:把同一个网址粘贴到 Search Console 顶部的检查框里。
五个容易踩的坑
- 把查询行当成总流量。Google 的效果数据说明讲得很清楚:匿名查询没有对应的行,「把所有行的点击加起来,得到的点击数和图表里的总数不会一样。」要总数,就按日期取数据,不加查询过滤。
- 拿按网页的总数和按网站的总数比。按网页分组时,搜索结果里出现的每个网址各算一次;按资源分组时,一条结果对整个网站只算一次。所以网页行加起来的展示次数,可能比网站总数还多。
- 忘了数据有延迟。数据「通常 2-3 天后才能看到」。除非明确要新数据,API 只返回最终数据,所以「最近 7 天」其实在今天之前几天就截止了。
- 资源名写错。网域资源写作
sc-domain:example.com;网址前缀资源是带末尾斜杠的完整网址,比如https://example.com/。先让 agent 列出你的资源,照它返回的名字用。 - 一次要太多。每次请求最多返回 25,000 行,按查询和网页拆分 16 个月的数据很快就满了。改成要汇总、加过滤条件或缩短日期范围,让 agent 自己逐行处理,别把所有行都贴进对话。
该选哪种接法?
| 你的情况 | 选这个 |
|---|---|
| 你在浏览器里用 claude.ai 或 ChatGPT | 托管服务器,填网址添加 |
| 你要全部工具(包括提交站点地图),也不怕折腾 Google Cloud | 社区服务器,如 mcp-gsc |
| 你想让 Claude Code、Codex 和 SEO agent 读 Search Console,又不想碰 Google Cloud | Orkas 内置连接器 |
| 网站太大,每次 25,000 行不够 | Search Console 的 BigQuery 批量数据导出,不走 MCP |
常见问题
Google 有官方的 Search Console MCP 服务器吗?
没有,截至 2026 年 11 月 9 日还没有。Google 的官方 MCP 服务器清单和 Google Cloud 的 MCP 清单里都没有 Search Console。Google 只出了 Google Analytics 的 MCP 服务器,里面没有 Search Console 数据。
Search Console MCP 要花钱吗?
Search Console API 免费,mcp-gsc 这类社区服务器和 Orkas 的连接器也免费。托管服务器一般有每月限次的免费档和付费档。你接的 AI agent 另有费用,比如 Claude 套餐或 Orkas 积分。
MCP 服务器能提交站点地图或请求编入索引吗?
有 Search Console 完整权限的话,可以提交或删除站点地图,有些社区服务器支持。Search Console API 没有请求编入索引的功能,所以对普通网页,哪个服务器都做不到。Orkas 的连接器是只读的,两样都不做。
为什么 MCP 拉的数字和 Search Console 对不上?
通常是 agent 把查询行加起来了,而查询行不含匿名查询;或者把按网页的总数和按资源的总数混在一起了。要总数就按日期取、不加查询过滤,日期范围和搜索类型与报告一致。这样两边的总数应该很接近。
能在 Claude Code 和 Codex 里用吗?
能。社区服务器用 claude mcp add 或 codex mcp add 添加,托管服务器填网址添加。在 Orkas 里,Claude Code 和 Codex 通过 Orkas 的工具桥使用内置的 Search Console 连接器,两边都不用另外设置。
什么是 Agentic SEO?这篇讲更完整的做法:agent 在真实数据上跑 SEO 工作,由人决定哪些改动上线。