seo-google

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 报告（所有部分）

工作流程：

运行数据收集命令（pagespeed、gsc、inspect-batch 等）
将 JSON 输出保存到文件：claude-seo run pagespeed_check.py <url> --json > data.json
生成报告：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 达到限制。

你可能还喜欢

herdr

24Kagent-workflows

Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, commands, or another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.

herdrdev

获取

herdr

17Kagent-workflows

Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, terminals, commands, or communication with another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.

ogulcancelik

获取

skill-creator

385Kagent-workflows

Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.

steipete

获取

继续探索

浏览 agent-workflows 热门 Skills 最近更新

seo-google

相关 Skills

Google SEO API

前提条件

凭据层级

快速参考

PageSpeed + CrUX

/seo google pagespeed <url>

/seo google crux <url>

/seo google crux-history <url>

Search Console

/seo google gsc <property>

/seo google inspect <url>

/seo google inspect-batch <file>

/seo google sitemaps <property>

Indexing API

/seo google index <url>

/seo google index-batch <file>

GA4 流量

/seo google ga4 [property-id]

/seo google ga4-pages [property-id]

YouTube（视频 SEO）

/seo google youtube <query>

/seo google youtube-video <video_id>

NLP 内容分析

/seo google nlp <url-or-text>

/seo google entities <url-or-text>

关键字研究（Google Ads）

/seo google keywords <seed>

/seo google volume <keywords>

补充

/seo google entity <query>

/seo google safety <url>

/seo google quotas

报告

/seo google report <type>

速率限制

跨技能集成

输出格式

技术说明

错误处理

你可能还喜欢

herdr

herdr

skill-creator

继续探索

`/seo google pagespeed <url>`

`/seo google crux <url>`

`/seo google crux-history <url>`

`/seo google gsc <property>`

`/seo google inspect <url>`

`/seo google inspect-batch <file>`

`/seo google sitemaps <property>`

`/seo google index <url>`

`/seo google index-batch <file>`

`/seo google ga4 [property-id]`

`/seo google ga4-pages [property-id]`

`/seo google youtube <query>`

`/seo google youtube-video <video_id>`

`/seo google nlp <url-or-text>`

`/seo google entities <url-or-text>`

`/seo google keywords <seed>`

`/seo google volume <keywords>`

`/seo google entity <query>`

`/seo google safety <url>`

`/seo google quotas`

`/seo google report <type>`