用途:把基于爬虫的 SEO 分析与 Google 官方实时数据打通,获取真实 Chrome 用户指标、真实收录状态、搜索表现与自然流量。所有 API 免费。
使用方式:需要 Python 3.10+ 与 Google API 客户端库,安装命令为 bash extensions/google/install.sh。配置文件位于 ~/.config/seo-skills/google-api.json,含 service_account_path、api_key、default_property、ga4_property_id 等字段。执行前先用 python scripts/google_auth.py --check --json 检查凭据。凭据分四级:Tier 0(API Key)可用 pagespeed、crux、crux-history、youtube、nlp、entity、safety;Tier 1(OAuth/服务账号)增加 gsc、inspect、sitemaps、index;Tier 2(配 GA4)增加 ga4、ga4-pages、ga4-referrals、ga4-channel-mix、ga4-properties;Tier 3(Ads 令牌)增加 keywords、volume。运行命令前应先说明检测到的级别。
主要能力:pagespeed 合并 Lighthouse 与 CrUX 现场数据,crux-history 给出 25 周 CWV 趋势;gsc 输出 28 天点击、展示、CTR、排名并识别第 4-10 位快赢机会,支持 --ai-overview 过滤 AI Overview/AI Mode 展示;inspect 与 inspect-batch 返回 Google 真实收录判定、规范化与抓取信息;sitemaps 查看已提交站点地图状态;index/index-batch 提交索引(官方仅适用于 JobPosting 与 BroadcastEvent/VideoObject,每日 200 条);GA4 系列报告可按落地页与渠道筛选,referrals 默认统计主流 AI 助手来源引荐;keywords/volume 提供 Keyword Planner 数据;另有 YouTube 搜索与视频详情、NLP 实体与情感、知识图谱、Web Risk 安全检查、quotas 配额表与 report 报告生成。
限制:需自备 Google Cloud 项目与凭据,部分功能需启用结算或对应 API;各 API 有配额限制(如 PSI 240 QPM、URL Inspection 2000 QPD/站点、GA4 ~25K tokens/day);未提供价格与付费方案信息。