每次都要打开 Search Console，切到"网页"找曝光高但点击低的页面，再切到"查询"看关键词，复制 URL，检查索引状态，最后还要打开表格做对比。这些操作单独看都不难，但组合起来非常耗时。

最近发现一个开源项目 google-search-console-mcp，把 Search Console 接到 MCP 客户端（比如 Codex CLI）里，让 AI 直接读取搜索表现数据、分析页面机会、排查索引问题。你只需要给出网站 URL，AI 就能自动匹配你账号里的 Search Console 属性，整理出可执行的优化建议。

这个工具能解决哪些实际问题

Search Console 里有点击、曝光、CTR、平均排名、查询词、国家、设备等大量数据，但日常工作中我们通常是带着具体问题进去的：

• 这个月搜索流量为什么降了？
• 哪些页面曝光高但点击率低？
• 一篇文章发布后，Google 给了哪些查询词？
• 改版后，是排名掉了还是 CTR 掉了？
• 某个页面不被收录，是 canonical、robots 还是抓取问题？

google-search-console-mcp 不是一个新的 SEO 仪表盘，而是让 AI 助手可以直接调用 Search Console 数据的桥梁。它在对话中说明问题，AI 负责拉取相关页面、查询词和指标，再给出排查方向。整个过程只读取和分析数据，不会添加或删除站点，也不会提交 Sitemap。

实际使用场景

场景一：找出低点击机会页面

假设某个页面最近 28 天有 8 万曝光、800 点击，CTR 只有 1%。单看这个数字很难判断问题所在。传统做法是导出查询词，按曝光、排名、CTR 排序分析。接入 MCP 后，可以直接在对话中问：

帮我找出 https://example.com/ 最近 28 天高曝光但低点击的页面，并给出标题和摘要优化建议。

AI 会把页面和查询词放在一起分析，比如：

• 页面曝光高，但点击集中在少数几个关键词
• 某些查询词已经排进前 10，但 CTR 明显偏低
• 页面标题和用户搜索意图不够匹配

这样得到的建议会更具体，而不是泛泛地说"提升点击率"。

场景二：排查流量下滑

网站流量突然下降时，最难的是不知道从哪里开始排查。你可以直接问：

https://example.com/ 最近搜索流量下降了，帮我定位主要下滑页面和可能原因。

AI 会对比两个时间段，找出点击或曝光变化最大的页面。如果某个 URL 异常，会继续查索引状态、canonical 标签、robots.txt 和抓取记录。搜索流量变化可能和季节性、竞争页面、站点改版、Google 算法更新都有关系，但这个工具能先把第一轮线索整理出来。

安装和配置步骤

前置条件

• Node.js 20 或更高版本
• 一个已启用 Search Console API 的 Google Cloud 项目
• 你能访问目标网站的 Google Search Console
• OAuth Desktop Client JSON 文件

这里使用 OAuth 方式，通过你自己的 Google 账号授权，适合本地接入 Codex CLI。

安装项目

进入项目目录后，使用 npm 或 pnpm 安装：

npm install
npm run build

或使用 pnpm：

pnpm install
pnpm build

配置 OAuth

1. 打开 Google Cloud Console，进入已有项目或新建项目
2. 启用 Search Console API
3. 在 Credentials 页面创建 OAuth client ID
4. 配置 OAuth consent screen，应用类型选择 Desktop app
5. 下载 client secrets JSON，保存到稳定位置，例如 ~/Documents/client_secrets.json

启动服务时指定这个文件：

GSC_OAUTH_CLIENT_SECRETS_FILE=/absolute/path/to/client_secrets.json pnpm dev

第一次调用工具时，浏览器会打开 Google 登录和授权页面。授权成功后，token 会缓存在系统用户配置目录下的 google-search-console-mcp/token.json。如果想指定其他缓存目录，可以设置 GSC_CONFIG_DIR 环境变量。

接入 Codex CLI

先确认本机 Node 路径：

which node

然后编辑 Codex CLI 的配置文件（通常是 ~/.codex/config.toml）：

[mcp_servers.google_search_console]
command = "/absolute/path/to/node"
args = ["/absolute/path/to/google-search-console-mcp/dist/index.js"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE="/absolute/path/to/client_secrets.json" }

保存后重启 Codex CLI。第一次使用时，按浏览器提示登录 Google 并授权。

常用的查询示例

查看最近 28 天整体表现：

查看这个网站最近 28 天的搜索表现：https://example.com/

生成 SEO 周报：

帮我生成 https://example.com/ 最近 28 天的 SEO 周报，指出点击、曝光、CTR、平均排名和趋势变化。

分析单页关键词：

分析这个页面最近 90 天由哪些搜索词带来流量：https://example.com/blog/example-post

检查索引问题：

检查这些页面是否有索引、canonical、robots 或抓取问题：https://example.com/page-1

总结

Search Console 里有真实的搜索数据，Codex CLI 里有正在写的代码和页面。google-search-console-mcp 把两边接起来后，很多原本要手动查表的操作，就可以直接在对话中完成。它不会承诺排名提升，也不会替你决定业务方向，但能作为一个随时查 Search Console 的助手，帮你把页面、查询词、点击、曝光、排名这些线索快速整理出来。

如果你维护网站、博客、文档站或产品官网，建议先从这个问题开始测试：

查看这个网站最近 28 天的搜索表现：https://example.com/

能跑通这一步，后面做周报、查下滑、找低点击页面、看索引问题就顺手了。

项目地址：github.com/bytefer/google-search-console-mcp