seo-google

seo-google 技能概览

seo-google 能做什么

seo-google skill 让你直接接入 Google SEO APIs，而不是靠通用提示词或第三方估算去猜。它面向需要把 Search Console、PageSpeed Insights、CrUX、Indexing API 和 GA4 自然流量放在同一个工作流里查看真实字段数据的人。

适合哪些用户和任务

如果你需要验证收录情况、检查 URL、对比 impressions 和 clicks、用真实用户数据审计 Core Web Vitals，或者从 GA4 拉取自然流量趋势，就适合用 seo-google skill。它特别适合 SEO 运营、技术 SEO、内容团队，以及在给出建议前需要 Google 原生证据的 agent。

它为什么不一样

seo-google 的核心价值不是泛泛的 SEO 理论，而是 source-of-truth 数据。它把基于爬取的分析和 Google 自己的 APIs 接起来，让你可以从“这个页面看起来没问题”推进到“Search Console 显示 CTR 很低”或者“CrUX 显示移动端 INP 表现很差”。这让它比普通的自由发挥式提示词更适合做决策。

什么时候最适合用 seo-google

当任务依赖真实的 Google 数据、账号配置，或者基于 API 的诊断时，优先选 seo-google。若你只是想做内容头脑风暴、没有 Google Ads 访问权限的关键词发散，或者只需要一次不依赖实时数据的 SEO 解释，它就没那么合适。

如何使用 seo-google skill

安装并检查前置条件

在执行 seo-google install 这一步时，先通过你的 skills 工作流把 skill 加进来，然后在开始分析前确认凭据可用。这个 repo 需要已经配置好 Google API 认证，而 skill 的第一个实际依赖是 ~/.config/claude-seo/google-api.json 里有可用配置。

先提供正确的输入形状

seo-google usage 这种用法在你给出明确的 URL、property 或目标时效果最好。比较好的输入包括：“Audit https://example.com/pricing for indexation and CWV”、“Compare GSC queries for sc-domain:example.com last 28 days”，或者“Check GA4 organic landing pages for the blog section”。避免像“improve my SEO”这种过于笼统的请求，因为 APIs 需要明确目标和日期范围。

先读这些文件

要想把 seo-google 用稳，先看 SKILL.md，然后依次看 references/auth-setup.md、references/search-console-api.md、references/pagespeed-crux-api.md 和 references/ga4-data-api.md。如果你的任务涉及通知或 submit/inspect 流程，还要看 references/indexing-api.md；如果是关键词研究，再看 references/keyword-planner-api.md。

更容易拿到好结果的工作流

一个实用的工作流是：先确认认证，再识别数据源，接着定义 property 或 URL，选择日期窗口，最后只请求你真正需要的指标。比如：“Using seo-google, check GSC Search Analytics for sc-domain:example.com over the last 28 days, surface pages with high impressions but low CTR, and explain likely titles to rewrite.” 这比直接要一个宽泛的 SEO 审核更好，因为它明确告诉 skill 要抓什么、以及如何组织输出。

seo-google skill 常见问题

seo-google 只适用于 Search Console 吗？

不是。Search Console 很核心，但 seo-google skill 也覆盖 PageSpeed Insights、CrUX、Indexing API 和 GA4 的自然流量数据。如果你希望一个 skill 同时处理收录、性能和流量诊断，而不是分散成多个提示词，这一点就很重要。

我需要同时准备 API key 和 service account 吗？

通常是需要的，这样覆盖最完整。API key 足以访问 PageSpeed Insights 和 CrUX；Search Console、Indexing API 和 GA4 则需要 service account。这个 skill 在两者都配置好的情况下最有用。

seo-google 能用于 Keyword Research 吗？

可以，但有边界：seo-google for Keyword Research 依赖 Google Ads/Keyword Planner 的访问权限，这比其他 APIs 更复杂。它更适合你需要来自 Google 的搜索量或预测数据时使用，而不是只想快速发散几个话题点时使用。

什么时候不该用这个 skill？

如果你没有凭据、没有已验证的 property，或者只需要一个通用 SEO 清单，就不要用 seo-google。它也不是纯内容生成的最佳选择，因为它的强项是基于 API 的证据，而不是写作起草。

如何改进 seo-google skill

给 skill 提供能直接做决策的上下文

最快的提效方式，是把 property 类型、URL 规则、日期范围、设备重点和成功指标一起给出来。比如：“mobile CWV on /blog/ pages”、“GSC pages with impressions > 1,000 and CTR < 2%”，或者“GA4 organic traffic for the last 90 days excluding branded landing pages”。这样 seo-google 才能返回可执行的切片，而不是泛泛的总结。

一次只问一个分析方向

当你把收录、排名、Core Web Vitals 和流量混在同一个任务里时，skill 的表现通常会变差。像“先检查 URL inspection，再看 GSC，然后看 GA4”这种请求往往会让输出变得杂乱；更好的做法是先问一个方向，再根据结果继续迭代。

注意常见失败模式

最常见的阻碍是认证缺失、property 格式错误，以及要求 skill 推断它其实抓不到的数据。另一个常见问题是关键词请求过于宽泛，却没有足够的 seed terms 或者没有 Google Ads 凭据。如果你希望 seo-google 帮你做关键词研究，先说明你要的是 ideas、historical volume 还是 forecasts。

基于证据迭代，不要靠直觉

拿到第一轮结果后，就用你看到的具体异常继续收窄，比如：“Pages with high impressions but low clicks”、“URLs with poor INP only on mobile”，或者“indexing failures for recently published pages”。这样可以把 seo-google 变成一个诊断闭环，第二轮输出会比一次性的泛泛审计实用得多。