Blog Google：博客性能数据技能
通过 Google API 获取博客速度、索引、搜索、流量和关键词数据。
证据显示按凭据层级限制 API 能力、要求先检查凭据，并记录 API 密钥、服务账号、配额和部分权限说明；但配置包含敏感凭据路径，/index 及批量提交会产生外部写入，未明确逐次确认、撤销或回滚机制，也未充分披露所有数据流，因此扣分。
SKILL.md 提供命令、配额和错误处理表，脚本对 404、429、请求异常及无效数据有处理；但大量命令指向未提供的 scripts/run.py，认证检查和 auth-setup.md 中的脚本路径也不一致，关键路径无法由所给文件复现，故明显扣分。
描述、命令参数、凭据 Tier 和错误场景较清晰，覆盖性能、GSC、GA4、NLP、YouTube 和关键词研究；但非适用边界、语义误触发防护、中文输出支持及中国大陆网络可达性没有证据，核心能力依赖 Google 海外服务，故扣分。
具备 frontmatter、MIT 许可、版本号、参数提示、快速参考、前置条件、参考文档、模板、配额和排障说明；但选定技能缺少独立变更日志、明确维护责任和更新路径，且仓库描述中的版本信息存在不一致，故未给高分。
命令目标和输出格式基本明确，报告模板可直接生成 HTML/PDF，且覆盖多类 Google SEO 数据；但静态材料未证明代表性输出可用，命令与实际提供脚本路径不一致，用户可能需要额外修复，故仅给有限分数。
提供 API 端点、请求字段、阈值、配额和一个趋势脚本，具有一定审计性；但没有选定技能关键路径的独立执行证据，README 的测试与 CI 属于仓库级声明且未覆盖所需 run.py 命令，交叉验证和事实/推断区分不足，故扣分。
- 执行 /index 或批量 indexing_notify 前应获得明确用户确认，并说明该 API 官方适用范围及不可逆的外部影响。
- 在安装或运行前核对 scripts/run.py、google_auth.py 及其他引用文件是否实际存在；当前所给材料存在路径不一致。
- Google API、YouTube、GA4、GSC 和 Ads 功能可能受大陆网络、账号权限、配额和计费状态影响；不要将“免费”理解为无条件可用。
- 不要把 API 密钥、OAuth 客户端或服务账号文件提交到仓库；建议进一步限制文件权限和 API 范围。
这个 Skill 能做什么，适合哪些场景？
Blog Google 是 claude-blog 仓库中的一个可调用技能，专门为博客性能分析提供 Google API 数据。它可读取 PageSpeed Insights、CrUX、Search Console、URL Inspection、Indexing API、GA4、Google NLP、YouTube 和 Google Ads Keyword Planner 数据。功能按 API 密钥、OAuth 或服务账号、GA4 属性和 Google Ads 凭据分层开放。结果可用于性能诊断、索引检查、搜索表现分析、关键词研究以及 PDF 或 HTML 报告生成。
技能首先检查共享配置文件 ~/.config/claude-seo/google-api.json 中的凭据，并根据凭据层级开放命令。它通过 Python 脚本调用 Google API，执行 Lighthouse 与 CrUX 性能检查、25 周 Core Web Vitals 趋势分析、Search Console 查询分析、URL 索引检查、Indexing API 提交、GA4 自然流量报告、NLP 实体与情感分析、YouTube 视频搜索和 Google Ads 关键词建议。它还可生成包含图表的 PDF 或 HTML 报告，并在凭据缺失、配额超限或数据不可用时返回相应处理建议。
- 博客运营者想检查已发布页面的 Lighthouse 实验室数据和真实 Chrome 用户 Core Web Vitals。
- SEO 团队需要查看 Search Console 的点击、展示、CTR、排名，并发现排名第 4 至第 10 位的机会关键词。
- 网站管理员需要确认某个 URL 的索引状态、规范链接、抓取状态和移动可用性。
- 内容团队需要为文章寻找相关 YouTube 视频，或用 NLP 实体分析补充 E-E-A-T 内容审查。
- 营销团队拥有 GA4 或 Google Ads 凭据，需要生成自然流量报告或获取关键词规划数据。
这个 Skill 有哪些优点和局限？
- 覆盖页面速度、真实用户体验、索引、搜索表现、GA4、NLP、YouTube 和关键词规划等多类 Google 数据。
- 采用凭据分层机制，只有 API 密钥时也可使用 PageSpeed、CrUX、YouTube 和 NLP 等功能。
- 支持 25 周 CrUX 历史趋势、批量 URL 检查以及 PDF/HTML 报告。
- 明确说明 Search Analytics 延迟、CrUX 流量不足和 Indexing API 页面类型限制等重要边界。
- 需要 Google Cloud 项目及相应 API 凭据；Search Console、GA4 和关键词规划功能需要更高权限或额外账号配置。
- NLP 免费额度为每月 5,000 单位且要求启用 GCP 计费；其他 API 也有配额限制。
- Indexing API 官方仅适用于 JobPosting 和 BroadcastEvent/VideoObject 页面，不能视为通用博客索引提交工具。
- PDF 生成可能需要系统级 Pango 和 Cairo 库；提供材料没有列出该单独技能的专属测试套件。
如何安装这个 Skill？
该技能随 AgriciDaniel/claude-blog 集合安装。README 提供的 Claude Code 安装方式是先添加 marketplace：/plugin marketplace add AgriciDaniel/claude-blog，然后安装：/plugin install claude-blog@agricidaniel-claude-blog。也可克隆仓库后运行其安装脚本；具体安装脚本流程属于整个集合，而非本技能单独安装。安装后需重启 Claude Code。
如何使用这个 Skill？
先运行 python3 skills/blog-google/scripts/run.py google_auth --check --json 检查凭据。可使用 /blog google pagespeed <url>、/blog google crux <url>、/blog google crux-history <url>、/blog google gsc <property>、/blog google inspect <url>、/blog google index <url>、/blog google ga4 [property-id>、/blog google nlp <url-or-text>、/blog google youtube <query>、/blog google keywords <seed>、/blog google report <type> 或 /blog google quotas。运行命令前应先向用户说明检测到的凭据层级。Google Cloud 凭据的完整设置步骤未包含在提供的材料中；材料仅说明缺失凭据时应参考 references/auth-setup.md。