用途：回答“所有站点整体表现如何”这类问题；单独的站点工具需要多次手动导出才能覆盖整个账号。
主要能力：一次性审计账号下全部 GSC 属性，按点击与展示排序并给出环比变化；按站点对比关键词，区分新增、上升、下降、丢失等区间，并标出 CTR 缺口（高展示、排名前十、点击率偏低）。数据以约 3 天的 GSC 延迟自动做偏移。各属性的两个周期并行抓取，属性较多时也能在数秒内完成；单个周期查询行数上限为 25,000。
使用方式：需要具备 https://www.googleapis.com/auth/webmasters.readonly 权限的 OAuth refresh token。设置环境变量：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。运行命令示例：python3 scripts/audit_gsc.py 进行完整审计（排名加前 12 个站点的关键词 diff）；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。
解读要点：先看点击再看展示，避免单个大站点掩盖其他站点的增长；区分品牌词与非品牌词；整站头部词崩塌通常不是 SEO 问题，应先核查域名归属与解析状态；多语言站点不要跳过无法阅读语言的查询；返回 403 的属性表示已验证但无权访问搜索分析数据，脚本会照常报告。
限制：最常见的配置失败是刷新 token 时出现 unauthorized_client，原因是 refresh token 与所用的 id/secret 来自不同的 OAuth 客户端，需要匹配签发该 token 的那一对。其他限制（如价格、平台支持范围）暂未提供。