外观
每天上班第一件事,我习惯先打开 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:二选一,看你走哪条路。
