我把 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 Cloud 快速访问区的「API 和服务」入口

在 API 库中搜索 Google Search Console API

Google Search Console API 详情页的启用按钮

3. 建 Service Account

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

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

IAM 和管理中的服务账号列表页

创建服务账号表单,名称填 gsc-reader,后两步可跳过

4. 下载 JSON 密钥

点进这个服务账号:

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

服务账号密钥标签页,点击添加键并选择创建新密钥

创建私钥弹窗,键类型选择 JSON

把这个 JSON 文件放到本地一个地方,比如:

1~/.config/gsc/service-account.json

然后执行:

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

5. 把它加进 Search Console

复制刚刚那个服务账号的邮箱,一般长这样:

然后进你自己的 Google Search Console:

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

Search Console 设置中的用户和权限页面

Search Console 添加用户弹窗,邮箱粘贴服务账号地址,权限选完整

6. 告诉 AI 怎么用

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

1我已经配好了 Google Search Console 的 service account, 2密钥在 ~/.config/gsc/service-account.json。 3 4请写一个零依赖的 node 脚本 scripts/gsc.mjs,让你以后能直接查我的 GSC 数据。 5 6要求: 7- 不要 npm install googleapis。用 node 内置的 crypto 自己签 RS256 JWT 8 换 access token,scope 用 webmasters.readonly 9- token 缓存到 ~/.config/gsc/token-cache.json,55 分钟有效期, 10 别每条命令都重新换一次 11- 子命令: 12 · sites 列出可访问的 property,配置自检用 13 · query Search Analytics 查询 14 · inspect <url> 单条 URL 的收录 / 规范 / 抓取状态 15 · sitemaps sitemap 提交状态和错误数 16- query 支持:--dim(query/page/country/device/date,逗号分隔) 17 --days / --from / --to / --limit / --offset 18 --page-contains / --query-contains / --country / --device / --type / --json 19- 默认输出对齐的表格,--json 输出原始 JSON 20 21这几个坑请直接避开: 22- GSC 数据延迟 2-3 天。--days N 的窗口要截止到 3 天前,别截止到今天 23- domain property 的 siteUrl 是 sc-domain:example.com 格式,要 encodeURIComponent 24- rowLimit 上限 25000,超了 API 会直接报错 25- 如果返回 403,提示我大概率是没把 service account 邮箱 26 加进 Search Console 的用户和权限列表 27 28写完先跑 node scripts/gsc.mjs sites 验证,把我的 property 打出来。 29 30最后把用法写成 docs/gsc-cli.md,并在 CLAUDE.md 里加一行指针指向它, 31这样以后新对话你自己就能找到。

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

1最近 7 天哪些关键词掉了? 2哪些页面曝光高但 CTR 低? 3哪些页面值得继续优化? 4哪些关键词可以单独做新页面?

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

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