Skip to content

让 Claude Code 自己去读 GSC,我不用每天手动捞数据了

每天上班第一件事,我习惯先打开 GSC,把查询报告和页面报告各翻一遍,然后关掉,第二天再重复一遍。单看一天也就十来分钟,说不上累,但它属于那种每天都必须做、结果又跟昨天差不了多少的活,可你要是不去看一眼,心里总觉得缺了点什么。

我烦的从来不是分析那一部分,分析我是愿意做的。我烦的是捞数据这个动作,它明明可以不吃我的时间。

现在这一步不用我做了。

我在终端里敲一句话:这周哪些词开始有排名了。它就会自己去 GSC 把最近七天和上七天的数据拉下来对着比,然后回我:有三个新词进了前二十,还有一个从 18 位掉到了 30 位,让我留意一下。整个过程我没有打开过 GSC 的网页。

下面说说怎么弄的。

原理一句话 ​

MCP 可以理解成 Claude Code 的一个外接插头,你给它插上一个能连 GSC 的,它就替你查,查回来的东西它自己会组织。MCP 到底是什么我就不在这展开了,你看到这篇文章多半已经听过;如果你完全没听过,那这篇对你可能也用不上。

接之前先备齐四样东西 ​

你需要有一个 Google Cloud 项目,把 Search Console API 打开,生成一份 OAuth 凭证,最后回到 GSC 里,把这个凭证授权给你名下的站点。前三样在 Cloud 控制台里点几下就有了,不算麻烦,真正麻烦的是最后一样。

配置的过程 ​

先说建项目、开 API。在 Google Cloud Console 里新建一个项目,然后到"API 和服务"里搜 Search Console API,把它启用就行。

接着建 OAuth 凭证,类型选"桌面应用",拿到的 client id 和 client secret 先存好,后面要用。

然后是最关键的一步,授权。这一步的目的是拿到一个能长期使用的 token,也是整个过程里最容易卡住的地方。卡在哪呢?在于 Cloud 项目和 GSC 其实是两回事:你在 Cloud 里把项目建好了,并不代表 GSC 认识它。你必须要回到 GSC,手动把你这个账号加进去,如果不加,API 拉回来的数据永远是空的。我第一次配的时候就卡在这里,对着一片空数据查了半天,还以为是自己哪一步配错了。

最后是把它接到 Claude Code。我用的是一个现成的开源项目:AminForou/mcp-gsc,它专门做的就是"把 GSC 接到 AI 助手",Claude Desktop、Cursor、Codex CLI 都支持。把上面准备好的凭证填进它的配置里,再把这个 server 注册给 Claude Code,配完之后你在 Claude Code 里问一句"我有哪些站点",如果能答上来,就算通了。

具体的命令和配置文件我放在文章最后,你可以直接照着抄。

接好之后能问什么 ​

能问的东西比我预想的多,我平时最常问的是这三个:这周和上周比,哪些词涨了、哪些词跌了;哪些页面展示量很高但点的人很少,这种说明有人看到了它,只是标题没能把人留住,该改;还有就是围绕某个词帮我写一个文章大纲。

最后这条我觉得挺有用。以前我要想选题基本靠拍脑袋,现在它给我的方向,是盯着我自己那批真实的关键词来的。

几个容易踩的坑 ​

数据是空的。 大概率是授权那一步没做,账号没有在 GSC 里加进去。

它不实时。 GSC 本身就有数据延迟,当天的数据往往要等两三天才稳定下来,你要是想看实时数据,它给不了。

站点多了要说清楚。 如果你手上管着好几个站,问的时候不指明是哪一个,它可能会读错。

最后 ​

每天手动去捞数据这件事,说实话你忍着,也没人在意你忍不忍。我只是碰巧会写点代码,顺手把自己从这件事里摘了出来。

你每天最机械的那件事,是什么?

附:完整操作步骤 ​

下面用到的 MCP server 是 AminForou/mcp-gsc,包名 mcp-search-console。整个流程分三步。

第 1 步:拿到 Google 的凭证 ​

先进 Google Cloud Console,新建(或选一个)项目,在"API 和服务"里启用 Search Console API。

然后建凭证,两种方式选一种:

  • OAuth(推荐):建 OAuth client ID,类型选"桌面应用",把下载下来的 JSON 存到一个固定位置,比如 ~/Documents/client_secrets.json。第一次用的时候会弹浏览器让你登录,登录一次之后 token 会自己缓存。
  • 服务账号:建一个 service account,生成 JSON key 下载存好,然后把这把账号的邮箱加到 GSC 的"设置 - 用户和权限"里,给它完整权限。这条路适合无人值守的场景。

第 2 步:装 uv,写配置 ​

这个项目推荐用 uvx 来跑,先装 uv:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uv --version

确认能打印出版本号就行。然后找到 uvx 的完整路径,配置里要写全路径:

bash
which uvx

接着写 MCP 配置,在 Claude Code 里可以写进 .mcp.json:

json
{
  "mcpServers": {
    "gscServer": {
      "command": "/你的完整路径/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/Users/你的用户名/Documents/client_secrets.json"
      }
    }
  }
}

用的是服务账号的话,把 env 换成:

json
{
  "GSC_CREDENTIALS_PATH": "/path/to/your-service-account.json",
  "GSC_SKIP_OAUTH": "true"
}

改完记得把 Claude Code 完全退出再打开。

第 3 步:验证 ​

问它一句"列出我的 GSC 站点"。能列出站点,就成了;如果没反应,让它"调用 get_capabilities"看一下授权状态。

几个可用的环境变量 ​

  • GSC_DATA_STATE:默认 all,设成 final 就只返回已确认的数据(会滞后两三天)。
  • GSC_ALLOW_DESTRUCTIVE:默认 false。设成 true 才会放开添加/删除站点、删除 sitemap 这类操作。你要只是查数据,保持默认就行。
  • GSC_OAUTH_CLIENT_SECRETS_FILE / GSC_CREDENTIALS_PATH:二选一,看你走哪条路。