我把 Google Search Console 接进了 Claude Code
朋友们,现在我看 GSC 数据,不再打开 GSC 后台,也不用导出 CSV,直接问 AI:
最近哪些关键词掉了?
哪些页面曝光高但没人点?
哪些页面值得进一步优化?
它就能直接查我的真实 GSC 数据,然后帮我做 SEO 分析。
如果你也有很多网站,平时经常要看 GSC 数据,可以按下面这六步配置,只需五分钟。
1. 第一步:Google Cloud Console 新建一个项目
先打开 Google Cloud Console,新建一个项目。
2. 第二步:启用 Google Search Console API
打开 API 和服务,在里面搜索 Google Search Console API,然后点击启用。
3. 第三步:建 Service Account
打开 IAM → 服务账号 → 创建。
"授予角色"那两步全部跳过,直接完成。这里不需要任何 IAM 角色。
4. 第四步:下载 JSON 密钥
点进这个服务账号:
密钥 → 添加密钥 → 创建新密钥 → JSON
把这个 JSON 文件放到本地一个地方,比如 ~/.config/gsc/service-account.json。
然后执行:
chmod 600 ~/.config/gsc/service-account.json
5. 第五步:把它加进 Search Console
复制刚刚那个服务账号的邮箱,一般长这样:[email protected]。
然后进你自己的 Google Search Console:
设置 → 用户和权限 → 添加用户 → 粘贴那个邮箱 → 权限选"完全"
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