技能介绍

要解决的问题

多数 SEO 工具给出的是"模拟"结果：Lighthouse 在实验室里跑出的分数，或者爬虫自己推断的收录状态。但真实 Chrome 用户的体验指标、页面是否真被索引、Google 自己怎么排序——只有 Google 清楚。另一个问题是数据割裂：CrUX、Search Console、GA4、Keyword Planner 分散在四个后台，口径各不相同，手工拼接既慢又容易对不上。

技能如何工作

技能把二十多条 Google 官方 API 封装成统一的命令层：

性能与字段数据：/seo google pagespeed 同时返回 Lighthouse 实验室分数与 CrUX 真实用户 p75 指标，CrUX 优先取 URL 级别，缺失时回退到 origin 级别；/seo google crux-history 输出 25 周趋势，判断 CWV 是改善、稳定还是退化。
索引状态：/seo google inspect 给出真实收录结论、robots.txt 状态、canonical 选择与移动端可用性；/seo google index-batch 可一次提交最多 200 个 URL。
搜索表现：/seo google gsc 报告近 28 天的点击、展现、CTR 与平均排名，并内置 quick-win 检测（排名 4–10、展现高的查询）。
流量与关键词：/seo google ga4 与 /seo google ga4-pages 覆盖自然流量和落地页排名；/seo google keywords、/seo google volume 使用 Ads Keyword Planner 的搜索量数据。

任何命令执行前都会检查 ~/.config/claude-seo/google-api.json，按凭证等级（Tier 0–3）限制可用命令，并先告知当前等级。分析结束后可用 /seo google report 生成 PDF 报告。

适用边界与注意点

凭证等级决定能力上限：只有 API Key 时无法访问 GSC、GA4 与 Keyword Planner；未配置 ga4_property_id 则完全没有流量数据。
Indexing API 有官方用途限制：它正式面向 JobPosting 与 BroadcastEvent/VideoObject 页面，普通内容页不应依赖它做批量提交。
数据窗口要留意：GSC 在 2025-05-13 至 2026-04-27 期间的展现、CTR 与平均排名不可靠，修复只向前生效、不回填。
NLP 输出不是 E-E-A-T 打分：实体与情感分析仅用于内容质检，不能当作 Google 的权威度评估。
AI 流量难以切分：AI Mode 的流量已计入标准 Performance 总量，想单独看 AI Overviews 的展现只能依赖生成式 AI 报告。