我把 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 文件放到本地一个地方,比如: ``bash ~/.config/gsc/service-account.json ` 然后执行: `bash chmod 600 ~/.config/gsc/service-account.json ` ## 5. 把它加进 Search Console 复制刚刚那个服务账号的邮箱,一般长这样: `text xxx@xxx.iam.gserviceaccount.com ` 然后进你自己的 Google Search Console: 设置 → 用户和权限 → 添加用户 → 粘贴那个邮箱 → 权限选 完整 Search Console 设置中的用户和权限页面 Search Console 添加用户弹窗,邮箱粘贴服务账号地址,权限选完整 ## 6. 告诉 AI 怎么用 这是我给 Claude Code 用的 prompt,供大家参考: `text 我已经配好了 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 的收录 / 规范 / 抓取状态 · 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: `text 最近 7 天哪些关键词掉了? 哪些页面曝光高但 CTR 低? 哪些页面值得继续优化? 哪些关键词可以单独做新页面? `` 还能结合 Claude Code 的 routine,让它每天或每周自动跑一次 GSC 分析,定时给你生成一份网站表现报告。 这样,你就能拥有一个定时运行的 SEO 助手,持续帮你发现网站增长机会。