SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场blog-google

blog-google

营销与增长

查看项目

更新于 10-16 09:00

技能介绍

用途

blog-google 提供对 Google 各类 SEO 相关 API 的直接访问，用于博客性能与搜索表现分析。可获取真实 Chrome 用户指标、索引状态、搜索表现、实体分析、YouTube 视频发现、关键词搜索量，以及 PDF/HTML 性能报告。所有 API 在正常使用量下均免费。

使用前需准备一个 Google Cloud 项目，配置 API Key 和/或服务账号。

前置检查

运行任何命令前先检查凭据：

python3 skills/blog-google/scripts/run.py google_auth --check --json

配置文件路径：~/.config/claude-seo/google-api.json（与 claude-seo 共用），包含 api_key、oauth_client_path、default_property、ga4_property_id、ads_developer_token、ads_customer_id 等字段。若缺失，需阅读 references/auth-setup.md 并按指引完成设置。

凭据层级

  • Tier 0（API Key）：api_key 存在时可用 pagespeed、crux、crux-history、youtube、nlp
  • Tier 1（OAuth/服务账号）：在 Tier 0 基础上增加 gsc、inspect、index
  • Tier 2（完整）：配置 ga4_property_id 后增加 ga4
  • Tier 3（Ads）：配置 ads_developer_token 与 ads_customer_id 后增加 keywords

运行命令前应先向用户说明检测到的层级。

主要能力

PageSpeed + CrUX

  • /blog google pagespeed <url>：合并 Lighthouse 实验室数据与 CrUX 字段数据。脚本：python3 skills/blog-google/scripts/run.py pagespeed_check <url> --json。CrUX 优先尝试 URL 级数据，回退到 origin 级。
  • /blog google crux <url>：仅 CrUX 字段数据（无 Lighthouse），更快。脚本加 --crux-only。
  • /blog google crux-history <url>：25 周 CrUX 历史趋势，展示 CWV 指标是改善、稳定还是下降。

Search Console

  • /blog google gsc <property>：搜索分析，返回近 28 天的点击、展示、CTR、排名，含快速见效机会检测（排名 4-10 且高展示）。脚本：gsc_query --property <property> --json。
  • /blog google inspect <url>：URL Inspection，返回真实索引状态、覆盖率状态、robots.txt 状态、索引状态、页面抓取状态、canonical 选择、移动可用性、富媒体结果。支持批量：gsc_inspect --batch <file> --json。

Indexing API

  • /blog google index <url>：通知 Google 某个 URL 已更新，可用于提交新博客文章以加快索引。官方仅支持 JobPosting 与 BroadcastEvent/VideoObject 页面，需告知用户此限制。每日配额 200 次发布请求。支持批量。

GA4 流量

  • /blog google ga4 [property-id]：自然流量报告，含每日会话、用户、页面浏览量、跳出率、互动情况，默认 28 天并按自然搜索渠道组过滤。顶部落地页可用 --report top-pages。

YouTube 视频发现

  • /blog google youtube <query>：搜索与博客主题相关的 YouTube 视频，返回标题、频道、播放量、点赞、时长、描述、标签。每次搜索消耗 100 单位配额（每日 10,000 单位免费）。视频详情与评论可用 youtube_search video <video_id>。

NLP 内容分析

  • /blog google nlp <url-or-text>：Google 的实体与情感分析，可增强博客内容的 E-E-A-T 评分。免费额度每月 5,000 单位，需在 GCP 项目启用结算。仅实体提取可用 --features entities。

关键词研究（Google Ads）

  • /blog google keywords <seed>：根据种子词生成关键词想法。脚本：keyword_planner ideas "<seed>" --json。搜索量查询：keyword_planner volume "<kw1>,<kw2>" --json。需要 Google Ads 账号（Tier 3）。

报告

  • /blog google report <type>：生成带图表的专业 PDF/HTML 报告。类型包括 cwv-audit、gsc-performance、indexation、full。PDF 生成需系统库 sudo apt install libpango1.0-dev libcairo2-dev；若 weasyprint 不可用则回退到 HTML。

速率限制

  • PSI v5：240 QPM，25,000 QPD，API Key
  • CrUX + History：150 QPM（共享），无每日限制，API Key
  • GSC Search Analytics：1,200 QPM/站点，30M QPD，服务账号
  • GSC URL Inspection：600 QPM，2,000 QPD/站点，服务账号
  • Indexing API：380 RPM，200 发布/天，服务账号
  • GA4 Data API：10 并发（360 为 50），200K Core Tokens/天（360 为 2M），服务账号
  • YouTube Data：10,000 单位/天，API Key
  • NLP API：5,000 单位/月，API Key（需结算）

详细配额管理见 references/rate-limits-quotas.md。

博客工作流集成

该技能既可被用户直接调用（如 /blog google pagespeed），也可被其他博客子技能内部调用：

  • blog-seo-check：对已发布文章 URL 运行 PSI + CrUX 获取实时 CWV 数据
  • blog-rewrite：NLP 实体分析以识别 E-E-A-T 实体缺口
  • blog-geo：使用 GSC 表现数据获取真实搜索表现洞察
  • blog-audit：批量对所有已发布博客 URL 进行 CWV + 索引检查
  • blog-write / blog-rewrite：YouTube 搜索用于视频嵌入

凭据未配置时会优雅回退。

技术说明

  • INP 已于 2024 年 3 月 12 日取代 FID，不再引用 FID。
  • CrUX 返回的 CLS 值为字符串编码（如 "0.05"），脚本已处理解析。
  • CrUX 404 表示 Chrome 流量不足，而非鉴权错误。
  • Search Analytics 数据有 2-3 天延迟。
  • Indexing API 官方仅适用于 JobPosting/BroadcastEvent 页面。
  • 所用 Google API 在正常使用量下均免费。

错误处理

  • 未配置凭据：运行 /blog google setup，列出 Tier 0 命令。
  • 服务账号缺少 GSC 访问权限：在 GSC > 设置 > 用户 > 添加 client_email。
  • CrUX 数据不可用（404）：Chrome 流量不足，以 PSI 实验室数据作为回退。
  • GA4 属性未找到：在 GA4 管理 > 属性详情中查找属性 ID。
  • Indexing API 配额超限：每日 200 次上限，优先处理最重要 URL。
  • 速率限制（429）：等待后以指数退避重试。