我把 Google Search Console 接进了 Claude Code

把 Google Search Console 接进 Claude Code

朋友们,现在我看 GSC 数据,不再打开 GSC 后台,也不用导出 CSV,直接问 AI:

最近哪些关键词掉了?

哪些页面曝光高但没人点?

哪些页面值得进一步优化?

它就能直接查我的真实 GSC 数据,然后帮我做 SEO 分析。

如果你也有很多网站,平时经常要看 GSC 数据,可以按下面这六步配置,只需五分钟。

1. 第一步:Google Cloud Console 新建一个项目

先打开 Google Cloud Console,新建一个项目。

Google Cloud Console 新建项目

2. 第二步:启用 Google Search Console API

打开 API 和服务,在里面搜索 Google Search Console API,然后点击启用。

搜索 Google Search Console API

启用 API

启用完成

3. 第三步:建 Service Account

打开 IAM → 服务账号 → 创建。

"授予角色"那两步全部跳过,直接完成。这里不需要任何 IAM 角色。

创建服务账号

跳过角色授予

4. 第四步:下载 JSON 密钥

点进这个服务账号:

密钥 → 添加密钥 → 创建新密钥 → JSON

添加密钥

下载 JSON 密钥

把这个 JSON 文件放到本地一个地方,比如 ~/.config/gsc/service-account.json。

然后执行:

chmod 600 ~/.config/gsc/service-account.json

5. 第五步:把它加进 Search Console

复制刚刚那个服务账号的邮箱,一般长这样:[email protected]。

然后进你自己的 Google Search Console:

设置 → 用户和权限 → 添加用户 → 粘贴那个邮箱 → 权限选"完全"

GSC 用户和权限设置

添加服务账号邮箱

6. 第六步:告诉 AI 怎么用

这是我给 Claude Code 用的 prompt,供大家参考:

我已经配好了 Google Search Console 的 service account,密钥在 ~/.config/gsc/service-account.json。

请写一个零依赖的 node 脚本 scripts/gsc.mjs,让你以后能直接查我的 GSC 数据。

要求:
- 不要 npm install googleapis。用 node 内置的 crypto 自己签 RS256 JWT 换 access token,scope 用 webmasters.readonly
- token 缓存到 ~/.config/gsc/token-cache.json,55 分钟有效期,别每条命令都重新换一次
- 子命令:
  · sites 列出可访问的 property,配置自检用
  · query Search Analytics 查询
  · inspect <url> 单条 URL 的收录 / 规范 / 抓取状态
  · sitemaps sitemap 提交状态和错误数
- query 支持:--dim(query/page/country/device/date,逗号分隔)、--days / --from / --to / --limit / --offset、--page-contains / --query-contains / --country / --device / --type / --json
- 默认输出对齐的表格,--json 输出原始 JSON

这几个坑请直接避开:
- GSC 数据延迟 2-3 天。--days N 的窗口要截止到 3 天前,别截止到今天
- domain property 的 siteUrl 是 sc-domain:example.com 格式,要 encodeURIComponent
- rowLimit 上限 25000,超了 API 会直接报错
- 如果返回 403,提示我大概率是没把 service account 邮箱加进 Search Console 的用户和权限列表

写完先跑 node scripts/gsc.mjs sites 验证,把我的 property 打出来。

最后把用法写成 docs/gsc-cli.md,并在 CLAUDE.md 里加一行指针指向它,这样以后新对话你自己就能找到。

配好之后,你就可以直接问 AI:

最近 7 天哪些关键词掉了?

哪些页面曝光高但 CTR 低?

哪些页面值得继续优化?

哪些关键词可以单独做新页面?

还能结合 Claude Code 的 routine,让它每天或每周自动跑一次 GSC 分析,定时给你生成一份网站表现报告。

这样,你就能拥有一个定时运行的 SEO 助手,持续帮你发现网站增长机会。

原文链接:https://coreychiu.com/blogs/connect-google-search-console-to-claude-code