用途:为博客提供 Google 官方数据的性能与 SEO 分析,通过 /blog google 子命令调用各 API。
主要能力:
- PageSpeed Insights 与 CrUX:合并 Lighthouse 实验数据与 28 天真实 Chrome 用户字段数据;crux 仅取字段数据,crux-history 提供 25 周核心网页指标趋势。
- Search Console:查询 28 天点击、展示、CTR、排名,默认 dimensions=query,page,含位置 4-10 的快速提升机会检测;inspect 返回索引状态、规范网址、robots、移动可用性与富结果;index 通过 Indexing API 通知 URL 更新。
- GA4:自然搜索流量日报,可查热门落地页。
- YouTube:按主题搜索视频(标题、频道、观看、点赞、时长等),用于视频嵌入。
- NLP:实体抽取、情感与内容分类。
- Google Ads 关键词:由种子词生成关键词创意与搜索量。
- report:生成 cwv-audit、gsc-performance、indexation、full 四类 PDF/HTML 报告。
使用方式:先检查凭据 python3 skills/blog-google/scripts/run.py google_auth --check --json;配置文件为 ~/.config/claude-seo/google-api.json。凭据分四级:Tier 0 API Key 支持 pagespeed、crux、crux-history、youtube、nlp;Tier 1 加 OAuth/服务账号后支持 gsc、inspect、index;Tier 2 配置 ga4_property_id 后支持 ga4;Tier 3 加 Ads 令牌与客户 ID 后支持 keywords。各命令均以 python3 skills/blog-google/scripts/run.py 调用对应子命令。
适用场景:已发布博客文章的网页性能审计、索引状态核查、搜索表现分析、主题与关键词研究、内容实体审查及视频素材发现;也可被 blog-seo-check、blog-rewrite、blog-geo、blog-audit 等子技能内部调用,凭据缺失时优雅降级。
限制:Indexing API 官方仅面向 JobPosting 与 BroadcastEvent/VideoObject 页面,日配额 200 条发布请求,不能替代 URL Inspection 的请求编入。CrUX 返回 404 表示 Chrome 流量不足而非鉴权错误。Search Analytics 数据有 2-3 天延迟;规范网址修复后 Google 可能保留重复聚类最多两周,此时应报 PENDING_REEVALUATION。NLP 需启用 GCP 计费,免费额度 5,000 单位/月;Google Ads 需合格账号与开发者令牌,未经用户明确同意不得启用计费或发起付费请求。INP 已于 2024 年 3 月 12 日取代 FID。Search Console 生成式 AI 专属报告尚无 API,应标记为不可用。PDF 生成需 sudo apt install libpango1.0-dev libcairo2-dev,失败时回退 HTML。费用、具体价格与其它平台支持信息暂未提供。