AI Skills
seo-google

seo-google

热门

Google SEO API：Search Console（搜索分析、网址检查、站点地图）、PageSpeed Insights v5、CrUX 现场数据（含25周历史）、Indexing API v3 和 GA4 自然流量。提供真实的 Google 现场数据，涵盖核心网页指标、索引状态、搜索表现和自然流量趋势。当用户提到“搜索控制台”、“GSC”、“PageSpeed”、“CrUX”、“现场数据”、“索引 API”、“GA4 自然流量”、“网址检查”或“真实 CWV 数据”时使用。

1.2万Star
1769Fork
更新于 2026/7/20
获取 Skill源代码

相关 Skills

skill-creator38万homelab-vlan-segmentation24万backend-code-review15万
SKILL.md
只读
名称
seo-google
描述

Google SEO API：Search Console（搜索分析、网址检查、站点地图）、PageSpeed Insights v5、CrUX 现场数据（含25周历史）、Indexing API v3 和 GA4 自然流量。提供真实的 Google 现场数据，涵盖核心网页指标、索引状态、搜索表现和自然流量趋势。当用户提到“搜索控制台”、“GSC”、“PageSpeed”、“CrUX”、“现场数据”、“索引 API”、“GA4 自然流量”、“网址检查”或“真实 CWV 数据”时使用。

Google SEO API

直接访问 Google 自身的 SEO 数据。弥合基于爬虫的分析（现有 claude-seo 技能）与 Google 实时现场数据之间的差距：真实的 Chrome 用户指标、实际索引状态、搜索表现和自然流量。

所有 API 均免费。设置需要 Google Cloud 项目及 API 密钥和/或服务账号——运行 /seo google setup 获取分步说明。

前提条件

在执行任何命令前，检查凭据：

claude-seo run google_auth.py --check --json

配置文件：~/.config/claude-seo/google-api.json

{
  "service_account_path": "/path/to/service_account.json",
  "api_key": "<GOOGLE_API_KEY>",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789"
}

如果缺失，请阅读 references/auth-setup.md 并引导用户完成设置。

凭据层级

层级 检测条件 可用命令
0（API 密钥） 存在 api_key pagespeed, crux, crux-history, youtube, nlp
1（OAuth/服务账号） + OAuth 令牌或服务账号 层级 0 + gsc, inspect, sitemaps, index
2（完整） + 已配置 ga4_property_id 层级 1 + ga4, ga4-pages
3（广告） + 存在 ads_developer_token + ads_customer_id 层级 2 + keywords, volume

在运行命令前，始终告知检测到的层级。

快速参考

命令 功能 层级
/seo google setup 检查/配置 API 凭据 --
/seo google pagespeed <url> PSI Lighthouse + CrUX 现场数据 0
/seo google crux <url> 仅 CrUX 现场数据（p75 指标） 0
/seo google crux-history <url> 25 周 CWV 趋势分析 0
/seo google gsc <property> Search Console：点击量、展示量、点击率、排名 1
/seo google inspect <url> 网址检查：索引状态、规范 URL、抓取信息 1
/seo google inspect-batch <file> 从文件批量检查网址 1
/seo google sitemaps <property> GSC 站点地图状态 1
/seo google index <url> 向 Indexing API 提交网址 1
/seo google index-batch <file> 批量提交最多 200 个网址 1
/seo google ga4 [property-id] GA4 自然流量报告 2
/seo google ga4-pages [property-id] 热门自然流量着陆页 2
/seo google youtube <query> YouTube 视频搜索（观看量、点赞数、时长） 0
/seo google youtube-video <id> YouTube 视频详情 + 热门评论 0
/seo google nlp <url-or-text> NLP 实体提取 + 情感分析 + 分类 0
/seo google entities <url-or-text> 仅实体分析（用于 E-E-A-T） 0
/seo google keywords <seed> 来自 Google Ads 关键字规划师的关键字建议 3
/seo google volume <keywords> 从关键字规划师查询搜索量 3
/seo google entity <query> 知识图谱实体查询 0
/seo google safety <url> Web Risk 网址安全检查 0
/seo google quotas 显示所有 API 的速率限制 --

PageSpeed + CrUX

/seo google pagespeed <url>

结合 Lighthouse 实验室数据与 CrUX 现场数据。

脚本： claude-seo run pagespeed_check.py <url> --json
参考： references/pagespeed-crux-api.md
默认： 同时包含移动端和桌面端策略，所有 Lighthouse 类别。

输出合并实验室评分（时间点 Lighthouse）与现场数据（28 天 Chrome 用户指标）。CrUX 首先尝试网址级别，失败时回退到来源级别。

/seo google crux <url>

仅 CrUX 现场数据（不运行 Lighthouse）。速度更快。

脚本： claude-seo run pagespeed_check.py <url> --crux-only --json

/seo google crux-history <url>

25 周 CrUX 历史趋势。显示 CWV 指标是改善、稳定还是恶化。

脚本： claude-seo run crux_history.py <url> --json
参考： references/pagespeed-crux-api.md

输出包含每个指标的趋势方向、百分比变化以及每周 p75 值。

Search Console

/seo google gsc <property>

搜索分析：最近 28 天的点击量、展示量、点击率、排名。

脚本： claude-seo run gsc_query.py --property <property> --json
参考： references/search-console-api.md
默认： 28 天，维度=查询、页面，类型=网页，限制=1000。

包含快速获胜检测：排名 4-10 且展示量高的查询。totals 块来自独立的无维度聚合查询，因为查询级别的行可能省略匿名化的低流量数据。仅当 totals_complete 为 true 时，将总计视为全站数据。--limit 限制返回的总维度行数，而非每次分页请求的大小。

GSC 中的 AI 界面（2026 年）：

  • 生成式 AI 表现报告（2026-06-03 发布），专门展示 AI 概览 + AI 模式 的可见性。仅展示量（无点击/点击率/排名/查询）；维度：页面/国家/设备/日期（太平洋时间）；限制 1,000 行；最新数据为初步数据；另有一个独立的 Discover 生成式 AI 报告。正在向部分属性推出。
  • AI 模式已纳入标准表现总计（网页搜索类型），AI 模式中的点击（外部链接点击）和展示量已计入常规报告，因此您无法从总计中清晰分离“经典”与“AI”流量。请使用生成式 AI 报告获取仅展示量的 AI 可见性。
  • 数据可靠性警告： GSC 记录错误导致 2025-05-13 至 2026-04-27 期间的展示量、点击率和平均排名不可靠（点击量未受影响；仅向前修复，无回溯）。请谨慎对待跨越该窗口的展示量/点击率/排名趋势；修复后预计展示量会明显下降。

/seo google inspect <url>

网址检查：来自 Google 的真实索引状态。

脚本： claude-seo run gsc_inspect.py <url> --json

返回：判定（通过/失败）、覆盖状态、robots.txt 状态、索引状态、页面抓取状态、规范 URL 选择、移动端可用性、富媒体搜索结果。

/seo google inspect-batch <file>

从文件批量检查（每行一个网址）。每个网站每天限制 2,000 次。

脚本： claude-seo run gsc_inspect.py --batch <file> --json

/seo google sitemaps <property>

列出已提交的站点地图及其状态、错误、警告。站点地图内容仅报告提交数量；URL Inspection API 才是判断特定网址是否被索引的索引状态真相。

脚本： claude-seo run gsc_query.py sitemaps --property <property> --json

Indexing API

/seo google index <url>

通知 Google 网址更新。

脚本： claude-seo run indexing_notify.py <url> --json
参考： references/indexing-api.md

Indexing API 官方仅用于 JobPosting 和 BroadcastEvent/VideoObject 页面。始终告知用户此限制。每日配额：200 次发布请求。

/seo google index-batch <file>

从文件批量提交网址。跟踪配额使用情况。

脚本： claude-seo run indexing_notify.py --batch <file> --json

GA4 流量

/seo google ga4 [property-id]

自然流量报告：每日会话数、用户数、页面浏览量、跳出率、互动率。

脚本： claude-seo run ga4_report.py --property <id> --json
参考： references/ga4-data-api.md
默认： 28 天，过滤为自然搜索渠道组。

GA4“AI 助手”渠道（约 2026-05-13 上线）： GA4 新增了原生 AI 助手 默认渠道组。被识别 AI 助手引荐的会话会获得 medium=ai-assistant。Google 识别的来源包括 ChatGPT、Gemini、Claude、Deepseek、Copilot、Grok，该渠道排除 Google AI 概览 / AI 模式。如有需要，请单独验证 Perplexity；不受支持的来源可能仍归入引荐流量，且大多数 AI 会话无引荐来源，归入直接流量，因此该渠道会低估 AI 流量。仅向前，无回溯。

/seo google ga4-pages [property-id]

按会话数排名的热门自然流量着陆页。

脚本： claude-seo run ga4_report.py --property <id> --report top-pages --json

YouTube（视频 SEO）

一些第三方研究报告 YouTube 提及与 AI 可见性之间存在 0.737 的相关性。请将其视为依赖于方法论的信号。免费，仅需 API 密钥。

/seo google youtube <query>

在 YouTube 上搜索视频。返回标题、频道、观看量、点赞数、时长。

脚本： claude-seo run youtube_search.py search "<query>" --json
参考： references/youtube-api.md
配额： 每次搜索 100 个单位（每天免费 10,000 个单位）。

/seo google youtube-video <video_id>

详细视频信息 + 标签 + 前 10 条评论。

脚本： claude-seo run youtube_search.py video <video_id> --json
配额： 2 个单位（视频详情 + 评论）。

NLP 内容分析

Google NLP 实体/情感输出用于内部内容质量检查。请勿将其视为 Google E-E-A-T 评分。

/seo google nlp <url-or-text>

完整 NLP 分析：实体、情感、内容分类。

脚本： claude-seo run nlp_analyze.py --url <url> --json 或 --text "..."
参考： references/nlp-api.md
免费层级： 每月 5,000 个单位。需要在 GCP 项目上启用结算。

/seo google entities <url-or-text>

仅实体提取（更快，配额更少）。

脚本： claude-seo run nlp_analyze.py --url <url> --features entities --json

关键字研究（Google Ads）

黄金标准的关键字量数据。需要 Google Ads 账号。

/seo google keywords <seed>

根据种子词生成关键字建议。

脚本： claude-seo run keyword_planner.py ideas "<seed>" --json
参考： references/keyword-planner-api.md
需要： 配置中的 Ads 开发者令牌和客户 ID（层级 3）。

/seo google volume <keywords>

特定关键字的搜索量（逗号分隔）。

脚本： claude-seo run keyword_planner.py volume "<kw1>,<kw2>" --json

补充

/seo google entity <query>

知识图谱实体查询。验证品牌存在。

参考： references/supplementary-apis.md
使用知识图谱搜索 API，需要 API 密钥。

/seo google safety <url>

Web Risk API 检查恶意软件/社交工程标记。

参考： references/supplementary-apis.md

/seo google quotas

显示速率限制表。阅读 references/rate-limits-quotas.md。

报告

在任何分析命令后，提供生成 PDF/HTML 报告的选项。

/seo google report <type>

生成包含图表和分析的专业 PDF 报告。

脚本： claude-seo run google_report.py --type <type> --data <json> --domain <domain> --format pdf

类型 输入 输出
cwv-audit PSI + CrUX + CrUX 历史数据 核心网页指标审计，包含仪表盘、时间线、分布
gsc-performance GSC 查询数据 Search Console 报告，包含查询表、快速获胜
indexation 批量检查数据 索引状态，包含覆盖饼图
full 所有数据合并 综合 Google SEO 报告（所有部分）

工作流程：

  1. 运行数据收集命令（pagespeed、gsc、inspect-batch 等）
  2. 将 JSON 输出保存到文件：claude-seo run pagespeed_check.py <url> --json > data.json
  3. 生成报告：claude-seo run google_report.py --type cwv-audit --data data.json --domain <domain>

约定： 完成分析后，建议：“生成报告？使用 /seo google report <type>”

速率限制

API 每分钟 每天 认证
PSI v5 240 QPM 25,000 QPD API 密钥
CrUX + 历史 150 QPM（共享） 无限制 API 密钥
GSC 搜索分析 1,200 QPM/站点 30M QPD 服务账号
GSC 网址检查 600 QPM 2,000 QPD/站点 服务账号
Indexing API 380 RPM 200 次发布/天 服务账号
GA4 数据 API 10 并发 ~25K 令牌/天 服务账号

跨技能集成

  • seo-audit：生成 seo-google 代理以获取实时 CWV + 索引数据（条件性）
  • seo-technical：使用 pagespeed_check.py 获取实时 CWV 现场数据
  • seo-performance：CrUX 现场数据补充 Lighthouse 实验室数据
  • seo-sitemap：GSC 站点地图状态显示提交数量、错误和警告；使用 URL Inspection 获取索引状态真相
  • seo-content：GSC 查询数据指导关键字定位
  • seo-geo：在可用时使用 GSC 生成式 AI 表现报告以及 AI 概览/AI 模式/Discover 生成式 AI 包含/排除控制

输出格式

  • CWV 指标：交通灯评级（良好 / 需要改进 / 较差）
  • 表现报告：带可排序列的表格
  • 始终包含数据新鲜度说明
  • 将报告保存为 GOOGLE-API-REPORT-{domain}.md
  • Markdown/LLM 模板位于 assets/templates/：cwv-audit-report.md、gsc-performance-report.md、indexation-status-report.md；与 google_report.py 的 PDF 管道不同

技术说明

  • INP 于 2024 年 3 月 12 日取代 FID。请勿引用 FID。
  • CrUX 中的 CLS 值为字符串编码（例如“0.05”）。脚本处理解析。
  • CrUX 404 = 流量不足，而非认证错误。
  • 搜索分析数据有 2-3 天延迟。
  • round_trip_time 于 2025 年 2 月取代了 CrUX 中的 effectiveConnectionType。
  • 自定义搜索 JSON API 已对新客户关闭（2025 年）。

错误处理

场景 操作
未配置凭据 运行 /seo google setup。列出仅需 API 密钥即可使用的层级 0 命令。
服务账号缺少 GSC 访问权限 报告错误。指示：将 client_email 添加到 GSC > 设置 > 用户 > 添加。
CrUX 数据不可用（404） 报告 Chrome 流量不足。建议使用 PSI 实验室数据作为后备。
GA4 属性未找到 报告错误。展示如何在 GA4 管理 > 属性详情中找到属性 ID。
Indexing API 配额超限 报告每天 200 次的限制。建议优先处理最重要的网址。
速率限制（429） 等待并使用指数退避重试。报告哪个 API 达到限制。