用途：为 SEO 分析提供 Google 官方实时数据，衔接基于爬取的分析与 Google 真实字段数据（真实 Chrome 用户指标、真实收录状态、搜索表现与自然流量）。
主要能力：PageSpeed Insights v5 与 CrUX 字段数据（含 25 周历史趋势）；Search Console 搜索分析（点击、展示、CTR、排名）、URL 检查与批量检查、站点地图状态；Indexing API 提交 URL；GA4 自然流量与热门落地页；YouTube 视频搜索；NLP 实体、情感与分类分析；Keyword Planner 关键词与搜索量；Knowledge Graph 实体检查与 Web Risk 安全检查。
使用方式：先配置凭据，运行 python scripts/google_auth.py --check --json 检查，配置文件位于 ~/.config/codex-seo/google-api.json。按凭据分四级：Tier 0（API Key）可用 pagespeed、crux、crux-history、youtube、nlp；Tier 1（OAuth/服务账号）增加 gsc、inspect、sitemaps、index；Tier 2（配置 ga4_property_id）增加 ga4、ga4-pages；Tier 3（Ads 令牌）增加 keywords、volume。常见命令如 /seo google pagespeed <url>、/seo google gsc <property>、/seo google inspect <url>、/seo google index <url>、/seo google ga4 [property-id]。
限制：所有 API 免费但需 GCP 项目与凭据；CrUX 返回 404 表示流量不足而非鉴权错误；Search Analytics 有 2-3 天延迟；Indexing API 官方仅适用于 JobPosting 与 BroadcastEvent/VideoObject 页面，每日 200 条发布配额；URL 检查每站点每日 2,000 次；NLP 免费额度每月 5,000 单位且需启用结算；Custom Search JSON API 自 2025 年起不再对新客户开放。INP 已于 2024 年 3 月 12 日取代 FID。