GSC 组合审计
回答“所有网站表现如何?”这一问题,覆盖 Search Console 账户中的每个属性,这是单个网站工具无法回答的问题,除非手动导出几十次。
设置
需要具有 https://www.googleapis.com/auth/webmasters.readonly 范围的 OAuth 刷新令牌:
export GOOGLE_GSC_CLIENT_ID=... # 或 GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=... # 或 GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com" # 可选,逗号分隔
pip install requests
最常见的设置失败原因是令牌刷新时出现 unauthorized_client。 这意味着刷新令牌是为与您配对的 id/secret 不同的 OAuth 客户端颁发的。随着时间的推移,添加了 Google 集成的账户通常会有多个客户端;请匹配发行令牌的那一对。
运行
python3 scripts/audit_gsc.py # 完整:排名 + 前 12 个网站的关键词差异
python3 scripts/audit_gsc.py portfolio # 仅排名表格
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90 # 季度环比
标志: --days(时间窗口,与紧接其前的窗口进行比较), --site(可重复), --top, --limit, --min-clicks。
各部分及其含义
| 部分 | 解读方式 |
|---|---|
| 新增 | 上一周期点击量为零的查询。增长实际来自这里。 |
| 上升 | 增长 ≥50%。检查排名是否也随之变动——如果没有,说明需求上升,而不是您的排名上升。 |
| 下降 | 基于真实基础下降 ≥40%。排名能告诉您是哪种下降: 排名下降 = 排名损失;排名不变但点击量崩盘 = 上方的展示位抢走了点击(AI 摘要、新的 SERP 功能或查询形态改变)。 |
| 丢失 | 之前有排名,现在无数据。 |
| 点击率差距 | ≥1,500 次展示,排名前 10,点击率低于 2%。标题和描述重写,这是最廉价的收获。 |
解读
- 首先报告点击量,其次才是展示次数。 一个大型属性可能会推高整体展示次数,以至于掩盖其他所有网站都在增长的事实。
- 将品牌词与非品牌词分开。 如果一个网站的全部关键词集就是自己的品牌名(或竞争对手的拼写错误),那么无论点击量看起来多好,它都没有获客引擎。请在报告中直截了当地说明。
- 整个网站在其核心品牌词上崩盘通常不是 SEO 问题。 在诊断排名问题之前先检查所有权:
whois <domain> | grep -i "registrar\|updated date",同时检查域名是否仍能解析。过期、转移或存在争议的域名会产生教科书式的排名断崖,任何 SEO 工作都无法修复。 - 组合表格中的“新增”意味着在上一时间窗口内点击量为零,对于最近上线的网站来说,这是上线事件,而非数据缺失。
- 不要跳过您无法阅读的语言中的查询。 在多市场网站上,增长通常来自非英语长尾词;请翻译有趣的查询,而不是过滤掉它们。
- 返回 403 错误的属性已通过 listing 验证,但未通过搜索分析验证。脚本会报告该问题,而非隐藏它。
备注
- GSC 数据大约有 3 天的延迟;脚本会自动补偿这一点。
- 两个时间周期会并行获取每个属性的数据,因此包含 40 个属性的账户也只需几秒钟。
- 每个周期的查询行数上限为 25,000 行,远高于任何单个网站在 28 天窗口内返回的数据量。