Google SEO 数据助手
直接调用 Google SEO API，获取真实的搜索、索引、体验和自然流量数据。
文档说明凭据层级、OAuth 范围、服务账号权限、API 限额、Indexing API 的适用限制，并强调本地配置与凭据保护；但对写入型操作未明确要求逐次用户确认，批量索引可能产生外部副作用，且数据流、回滚和报告文件清理策略不完整，因此扣分。
命令、脚本、错误场景和退避策略描述较清楚，仓库还提供 CI 与测试证据；但本次仅静态阅读，未复现 seo-google 关键路径，脚本可用性、依赖安装、异常输出和边界行为仍无法确认，且文档存在批量数量等潜在不一致，因此不超过静态上限并扣分。
触发词、用户可调用属性、参数提示、凭据层级和主要使用场景明确，覆盖 GSC、CWV、GA4、索引和关键词分析；但边界条件、非适用场景、中文输出支持及中国大陆网络可达性说明不足，核心能力依赖 Google 海外服务，因此扣分。
SKILL.md 具备分层章节、命令表、前置条件、参考文档、输出格式和错误处理；仓库上下文提供 MIT、版本、作者、CI、安全策略和维护线索，但选定技能自身缺少明确 changelog、维护责任与更新路径，且部分依赖和输出约定仍需到其他文件确认，因此扣分。
技能直接覆盖真实 Google SEO 数据采集并定义 JSON、报告和指标输出，具有相对手工查询的便利性；但静态材料没有验证代表性输出或端到端完成度，部分功能需要多级凭据、Google 配额和额外配置，报告生成还依赖复杂环境，因此按静态上限保守扣分。
文档包含 API 参考、配额、认证步骤、错误处理和部分仓库 CI/测试证据，提供了一定审计线索；但没有针对该技能关键命令的可复现执行结果或独立交叉验证，本次也未执行任何脚本，因此只能给有限分数。
- 在执行 /seo google index 或 index-batch 前，应增加明确的逐次确认、目标 URL 范围和可逆性说明；Indexing API 误用可能造成不必要的外部通知。
- Google API、GA4、GSC 和 Google Ads 功能依赖外部账户、权限、配额及网络可达性；中国大陆用户可能无法稳定使用核心功能。
- 文档中的批量索引数量、数据新鲜度和 API 限额应在脚本实现与参考文档之间统一，并补充关键命令的可复现测试。
- 服务账号 JSON、API 密钥和 GA4/GSC 数据属于敏感信息，使用前应确认本地文件权限、日志脱敏和输出文件存储范围。
这个 Skill 能做什么，适合哪些场景？
这是 claude-seo 仓库中的一个独立技能，专注于 Google SEO API，而不是整个仓库的完整 SEO 审计能力。它连接 Search Console、PageSpeed Insights、CrUX、Indexing API、GA4，以及部分 YouTube、Natural Language、Knowledge Graph 和 Web Risk 服务。技能可返回 Core Web Vitals、索引状态、搜索表现和自然流量趋势，并支持生成 PDF/HTML 报告。使用它通常需要本地 Python 脚本、网络访问和相应的 Google 凭据。
它首先运行 google_auth.py 检查凭据，并根据已配置的 API key、OAuth/服务账号、GA4 属性和 Google Ads 凭据识别可用权限层级。随后可运行 PageSpeed Lighthouse 与 CrUX 查询、25 周 CrUX 趋势、Search Console 查询和 URL Inspection、站点地图状态、Indexing API 提交、GA4 自然流量报告、YouTube 查询、Google NLP 实体分析、Google Ads 关键词建议与搜索量查询、Knowledge Graph 实体检查和 Web Risk 安全检查。分析结果以 JSON 等结构化数据输出，也可通过 google_report.py 生成 Core Web Vitals、Search Console、索引或综合 PDF 报告。
- SEO 顾问需要核实某个页面的真实 Core Web Vitals，而不仅是 Lighthouse 实验室估算时，可使用 PageSpeed 和 CrUX 数据。
- 网站负责人需要确认 Google 是否收录页面、选择了哪个规范 URL 或是否存在抓取问题时，可使用 URL Inspection。
- SEO 团队需要查看最近 28 天的点击、展示、CTR、排名和高展示量关键词机会时，可使用 Search Console 查询。
- 增长团队需要将自然搜索会话、用户、页面浏览量、跳出率和参与度汇总到 GA4 报告时，可使用 GA4 命令。
- 需要批量检查或提交 URL 时，可使用批量 URL Inspection 或 Indexing API；但 Indexing API 受页面类型和配额限制。
这个 Skill 有哪些优点和局限？
- 直接使用 Google 自有数据源，可获得 CrUX 现场数据、Search Console 表现、真实索引状态和 GA4 自然流量。
- 凭据分为多个层级，可从仅 API key 的 PageSpeed/CrUX 功能逐步扩展到 Search Console、GA4 和 Google Ads。
- 支持 25 周 CrUX 历史趋势、批量 URL 检查、JSON 输出和 PDF 报告生成。
- MIT 许可，随开源 claude-seo 集合发布。
- 需要本地 Python 脚本、Google Cloud 项目和相应权限；不同命令并非都能在无凭据时运行。
- Indexing API 官方用途限于 JobPosting 和 BroadcastEvent/VideoObject 页面，并有每天 200 次发布配额。
- Search Analytics 数据存在约 2 至 3 天延迟，URL Inspection 每个站点每天限制 2,000 次。
- CrUX 返回 404 可能表示 Chrome 用户流量不足；没有现场数据时只能依赖 PageSpeed 实验室数据。
- SKILL.md 没有证明其在 Claude Code 之外的平台可直接使用；Codex 或模型 API 场景需要适配命令、脚本和执行环境。
如何安装这个 Skill？
该技能随 AgriciDaniel/claude-seo 仓库的完整集合安装。Claude Code 1.0.33+ 可运行：/plugin marketplace add AgriciDaniel/claude-seo，然后运行 /plugin install claude-seo@agricidaniel-claude-seo。也可执行：git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git，然后运行 bash claude-seo/install.sh。源材料没有提供仅安装 skills/seo-google/SKILL.md 的独立安装步骤。
如何使用这个 Skill？
先配置 Google 凭据，并按技能说明检查：python3 scripts/google_auth.py --check --json。随后可使用 /seo google setup、/seo google pagespeed <url>、/seo google crux <url>、/seo google crux-history <url>、/seo google gsc <property>、/seo google inspect <url>、/seo google sitemaps <property>、/seo google ga4 [property-id>、/seo google youtube <query> 或 /seo google nlp <url-or-text> 等命令。完成分析后，可使用 /seo google report <type> 生成报告。具体命令依赖相应凭据层级。
这个 Skill 与同类方案有什么区别？
它不是完整的爬虫或全站 SEO 审计工具，而是为 claude-seo 其他分析技能补充 Google 的现场数据、索引状态和搜索表现。与仅依赖 Lighthouse 的分析相比，它增加了 CrUX 真实用户指标；与仅查看 Search Console 的人工流程相比，它提供了命令化查询、批量检查和报告生成。