用途:把基于爬虫的分析与 Google 实时数据打通,获取真实 Chrome 用户指标、索引状态、搜索表现与自然流量。
主要能力:
- Tier 0(仅 API Key):pagespeed、crux、crux-history(25 周趋势)、youtube、youtube-video、nlp、entities、entity、safety。
- Tier 1(OAuth/服务账号):上述加 gsc(点击、展示、CTR、排名)、inspect 与 inspect-batch、sitemaps、index 与 index-batch。
- Tier 2(配置 ga4_property_id):再加 ga4、ga4-pages。
- Tier 3(Ads 令牌与客户 ID):再加 keywords、volume。 另有 /seo google setup、/seo google quotas、/seo google report。
使用方式:先检查凭据 python scripts/google_auth.py --check --json,配置位于 ~/.config/seo-skills/google-api.json。运行前先说明检测到的档位;执行命令后脚本以 --json 输出。完成后可生成 PDF/HTML 报告,例如 python scripts/google_report.py --type cwv-audit --data data.json --domain <domain>。
限制与注意:所有 API 免费,但需 Google Cloud 项目与凭据;Indexing API 官方仅面向 JobPosting 与 BroadcastEvent/VideoObject,每日 200 次发布配额;URL Inspection 每站每日 2,000 次;CrUX 404 表示流量不足而非鉴权错误;Search Analytics 有 2-3 天延迟;NLP 免费额度 5,000 单位/月且需启用结算;Custom Search JSON API 自 2025 年起不再接受新客户。其他收费、平台与效果细节暂未提供。