Claude SEO：用于 Claude Code 的 SEO 技能

Claude SEO 是一个开源的 SEO 分析插件，用于 Claude Code。 它并行运行 25 个子技能和 18 个专业代理，覆盖技术 SEO、内容质量（E-E-A-T）、Schema.org 标记、AI 搜索优化（GEO）、本地 SEO、电子商务和国际 SEO。每次审计都会生成一个优先级的行动计划，其中包含可测试的建议，这些建议基于 Google 的原始来源指南。

实际效果

一个网站于 2026 年 3 月 23 日启动，并使用此工作流运行，这是其前三个月（截至 2026 年 6 月 12 日）的 Google Search Console 总点击次数和展示次数。

适用人群

• 管理 5 个以上客户网站的 SEO 机构。 将每季度的深度审计替换为每周自动运行。同样的团队能力，审计频率提升 4 倍，每条建议都附带客户可验证的可证伪性检查。
• SaaS / 出版 / 电商公司的内部 SEO 负责人。 在管理层评审前进行二次检查。发现 GSC 和 Lighthouse 隐藏的问题：Schema 废弃、AI 可引用性差距、过期域名继承风险、寄生 SEO 暴露、机器翻译漂移。
• 自由职业 SEO 顾问。 在第一天就用 15 分钟的审计和一个真实的 0-100 分来锚定客户范围。在花一小时写提案之前，用具体的价值证明赢得合作。

运行完整审计，观看并行代理在网站中展开：

在 YouTube 上观看完整演示

快速开始

# 启动 Claude Code
claude

# 全站审计：并行子代理生成优先级行动计划
/seo audit https://example.com

# 深度单页分析：页面元素、内容质量、Schema
/seo page https://example.com/about

# Schema 标记审计：检测、验证、生成
/seo schema https://example.com

# AI 搜索优化：段落可引用性 + 基于原始来源的建议
/seo geo https://example.com

# 生成包含行业模板的站点地图
/seo sitemap generate

命令

Claude SEO 子技能生态系统：25 个模块分为 8 个类别（审计、内容、Schema、技术、AI 搜索、本地 + 地图、商务 + 国际、扩展），围绕中央编排器运行

共有 32 个用户可调用的 /seo 命令，涵盖编排器、其子技能以及 8 个 MCP 扩展。完整参考请查看 docs/COMMANDS.md。

功能

Claude SEO 检查哪些核心网页指标？

Claude SEO 测量当前三个核心网页指标：LCP（最大内容绘制，目标低于 2.5 秒）、INP（与下一次绘制的交互，目标低于 200 毫秒）和 CLS（累积布局偏移，目标低于 0.1）。INP 于 2024 年 3 月 12 日取代了 FID；FID 于 2024 年 9 月 9 日从 Chrome 的现场数据工具（CrUX API、PageSpeed Insights）中移除（Lighthouse 是实验室工具，从未报告 FID），Claude SEO 从不引用 FID。现场数据来自 Chrome 用户体验报告（CrUX）（如果可用）；实验室数据则回退到通过 PageSpeed Insights 的 Lighthouse。LCP 可以通过 /seo google CrUX 集成分解为子部分（TTFB、加载延迟、加载持续时间、渲染延迟），以定位瓶颈。移动端和桌面端分别测量。CrUX 历史（25 周趋势）包含在 Tier 0 免费凭证集中。

Claude SEO 如何评估 E-E-A-T？

E-E-A-T（经验、专业、权威、信任）根据搜索质量评估指南进行评估，该指南最近更新于 2025 年 9 月，其中 YMYL 扩展至包括政治和社会主题。经验信号：原创研究、案例研究、一手照片。专业知识：作者资质和主题深度。权威性：外部引用和品牌提及。信任度，四个维度中权重最高的：联系方式、安全的 HTTPS、透明的更正、日期戳。在对子因素进行评分之前，Claude SEO 会应用 Google 自己的“谁/如何/为什么”启发式方法，来自有用内容指南。生成式 AI 内容如果符合搜索基本要求则没问题；当用于规模化低质量页面时，就会变成垃圾内容，seo-content humanize 和 seo-content verify 正是为此设计的检测工具。

Claude SEO 支持哪些 Schema.org 类型？

JSON-LD 是首选格式（Google 明确表示偏好）。Claude SEO 检测、验证和生成 skills/seo/references/schema-types.md 中记录的活跃 Schema.org 类型，包括组织、文章、产品、本地、活动、工作、课程、软件/应用程序、服务、问答和视频模式。FAQPage：Google 于 2026 年 5 月 7 日停止为所有网站显示常见问题解答富媒体搜索结果；它没有 Google 富媒体搜索结果的好处。仅在需要非 Google 或内部语义时保留。已弃用且绝不推荐：HowTo（富媒体搜索结果于 2023 年 9 月移除）、SpecialAnnouncement（2025 年 7 月）、ClaimReview、VehicleListing、EstimatedSalary、LearningVideo、CourseInfo 轮播（全部于 2025 年 6 月退役）。替换指南：skills/seo-schema/references/deprecated-types-2024-2026.md。

Claude SEO 如何优化 AI 搜索？

与 Google 的 AI 优化指南 保持一致，该指南指出“AEO”和“GEO”是 SEO 的重新包装标签。AI 概览和 AI 模式基于与经典搜索相同的排名系统；页面必须被索引并有资格显示摘要，才能出现在任何 AI 功能中。Claude SEO 对段落可引用性（最佳 134-167 字的自包含答案块）、基于问题的标题层级、归因密度、结构化数据覆盖率以及维基百科、Reddit、YouTube 和 LinkedIn 上的实体存在进行评分。seo-geo 技能包含对三个流行迷思的基于证据的重新框架：llms.txt 目前不是引用杠杆（原始来源证据），不需要内容分块，并且 AI 特定的关键词重写是不必要的，因为同义词理解已经足够。

Claude SEO 集成了哪些 Google SEO API？

一个 4 层凭证系统让你从零密钥开始，根据需要添加数据。每一层都在其级别提供实际价值：

PDF 报告通过 WeasyPrint 生成（A4 布局），使用 matplotlib 图表，200 DPI。运行 /seo google setup 启动凭证向导。所有凭证存储在 ~/.config/claude-seo/ 下，权限为 0o600；不会检入到仓库中。

Claude SEO 如何处理本地 SEO？

三层。Google Business Profile 信号：类别、营业时间、照片、帖子、产品、属性。NAP 一致性：名称、地址、电话号码与主要目录匹配，并标记偏差。评论情报：评分趋势、情感、回复覆盖率。对于多地点商家，Claude SEO 强制执行 30 页警告阈值和 50 页硬停止，以防止门户页面违规（可配置）。/seo maps 工作流增加了地理网格排名跟踪、GBP 资料审计和竞争对手半径映射。本地 Schema 生成涵盖 LocalBusiness，包含所有必需和推荐的属性（地理坐标、营业时间、服务区域）。Phase F（v2）添加了一个 GBP 弃用检查器，用于检测已废弃的聊天字段引用和 .business.site URL。

与手动 / 机构 / 商业工具对比

成本基准：手动审计假设高级 SEO 顾问按典型机构计费费率；机构服务基于常见的发现/审计交付范围；商业工具订阅反映了 SEO 审计类别（Ahrefs、Semrush、Sitebulb、Screaming Frog）中已发布的中端定价。你的数字可能不同。

使用案例

管理 10 个客户网站的 SEO 机构负责人。 将每季度的“深度审计”仪式替换为每周一早上对每个网站运行 /seo audit。向客户发送健康评分电子邮件的时间从 4 小时缩短到 12 分钟；覆盖范围从季度变为每周，而无需增加计费工时。漂移基准在审计之间捕获回归，因此客户对话从“看看这个快照”转变为“这是本周的变化”。

50 人 SaaS 公司的内部 SEO 负责人。 在每次季度业务评审前 24 小时运行 /seo audit。捕获平台 UI 隐藏的项目（程序化页面上的损坏规范链、Google 2025 年 6 月弃用浪潮后的 Schema 弃用、侵蚀 SERP 到 AI 概览拾取的 AI 可引用性差距、收购博客资产上的过期域名继承），然后 CMO 在董事会面前问为什么自然流量下降。

自由职业 SEO 顾问，正在承接新客户。 在发现电话中运行 /seo audit。用真实的 0-100 分、3 个优先关键发现以及每条建议的可证伪性检查来锚定合作范围，而不是模糊的“我看看，然后回复你”。由于价值证明发生在通话期间，而不是提案之后，因此能达成更多留任合同。

示例输出

Claude SEO 生成真实的 Markdown 报告作为其主要交付物。以下是 /seo schema https://rankenstein.pro/about 审计的前约 50 行原文。插件实际产生的结构、标题和评分格式如下所示。

# Schema Markup Report: rankenstein.pro/about

**URL:** https://rankenstein.pro/about
**Date:** 2026-02-09
**Format Detected:** JSON-LD (3 blocks) | No Microdata | No RDFa

---

## Summary

| Metric | Value |
|--------|-------|
| **JSON-LD Blocks** | 3 |
| **Schema Types** | Organization, WebSite, SoftwareApplication |
| **Critical Issues** | 2 |
| **Warnings** | 5 |
| **Passed Checks** | 18 |
| **Overall Grade** | B+ (solid foundation, actionable gaps) |

---

## Existing Schema Validation

### 1. Organization (`@id: #organization`)

| Property | Value | Status | Notes |
|----------|-------|--------|-------|
| `@context` | https://schema.org | Valid | |
| `@type` | Organization | Valid | Active type |
| `@id` | https://rankenstein.pro#organization | Good | Enables cross-referencing |
| `name` | Rankenstein | Valid | |
| `description` | Present, 200+ chars | Good | Descriptive and keyword-rich |
| `url` | https://rankenstein.pro | Valid | Absolute URL |
| `logo` | ImageObject with @id, url, width, height, caption | Excellent | Well-structured |
| `foundingDate` | "2024" | Imprecise | Year-only accepted but ISO 8601 preferred |
| `areaServed` | "Worldwide" | Text | Works but `GeoShape` is more semantic |
| `contactPoint` | email + contactType | Valid | Consider adding `telephone` |
| `founder` | 1 Person (Daniel Agrici) | Incomplete | Page describes two co-founders; second missing |
| `sameAs` | 5 social profiles | Good | GitHub, X, LinkedIn, YouTube, Reddit |
| `knowsAbout` | 6 topics | Good | Relevant topical signals |

**Critical Issue:** The `founder` property only includes Daniel Agrici. Benjamin Samar (Co-Founder & Technical Director) is displayed on the page but absent from the schema. This creates a content-schema mismatch that can confuse search engines.

其他审计输出遵循相同的格式：FULL-AUDIT-REPORT.md（总审计）、GEO-ANALYSIS.md（AI 搜索就绪性）、LOCAL-SEO-ANALYSIS.md（GBP 和引文），以及通过 WeasyPrint + matplotlib 生成的生产级 PDF（封面、目录、执行摘要、数据部分、建议、方法论，完整网站审计大约 32 页 A4）。

架构

Claude SEO 审计信号流：/seo audit 进入编排器，分发给 25 个子技能和最多 15 个并行审计代理，然后通过评分引擎汇聚成优先级报告

该插件遵循 Agent Skills 标准，采用 3 层架构（指令、编排、执行）。技能和代理从 skills/seo-*/ 和 agents/seo-*.md 自动发现。编排器（skills/seo/SKILL.md）处理行业检测（SaaS、本地、电商、出版、代理），并行调度最多 15 个代理，并通过 10 原则框架 进行综合，然后发出行动计划。完整架构：docs/ARCHITECTURE.md。

方法论

Claude SEO 10 原则方法论：PERCEIVE、ANALYZE、VALIDATE 和 ACT 阶段，10 个原则按象限排列

每次审计都遵循 10 个原则，分为四个阶段。每条发出的建议都包含四个字段：它所基于的首要原则观察、与其他建议的依赖关系、“我们如何知道这失败了？”检查以及要监控的领先指标。

完整方法论：skills/seo/references/thinking-framework.md。

v2 新特性

v2.0.0 是插件历史上最大的版本。六个构建阶段，全部已发布：

• Phase A：全面无头渲染。 共享的 scripts/render_page.py，使用 Playwright Chromium 以及 trafilatura 和 htmldate。每个审计子代理通过 --render auto 获得 SPA 感知的获取（自动检测 Next.js、React、Vue、Nuxt、Astro islands）。关闭了限制 v1.x 的 SPA 限制。
• Phase B：符合 QRG 的内容质量关卡。 填充检测器和 AI 模式人性化工具，针对 QRG §4.6.5 和 §4.6.6，声明验证扫描器，通过 WHOIS 进行过期域名继承检查，原始来源 Google 更新日志。
• Phase C：技术深度和 CWV 深度。 通过 CrUX 进行 LCP 子部分（TTFB、加载延迟、加载持续时间、渲染延迟）、Speculation Rules 和 bfcache 检测、IndexNow 提交器（用于 Bing / Yandex / Seznam / Naver）、Unlighthouse 多页面 Lighthouse 包装器。
• Phase D：Schema 完整性。 四个显式生成器（Reservation、OrderAction、DiscussionForumPosting、ProfilePage），电子商务 Schema 验证器（hasMerchantReturnPolicy、shippingDetails、MemberProgram、欧盟 energyEfficiencyClass、ProductGroup 变体），双重验证器（Rich Results Test 加 Schema Markup Validator）。
• Phase E：AI 搜索重新框架和 5 个新的 MCP 扩展。 Ahrefs、SE Ranking（AI 声量份额）、Profound（LLM 引用追踪器）、Bing Webmaster 加 IndexNow、Unlighthouse。加上根据 Google 2024 年 11 月网站声誉滥用政策 的寄生 SEO 风险扫描器。
• Phase F：本地、国际和隐私优化。 Google Business Profile 弃用检查器（聊天字段和 .business.site URL，Q&A 视为类别/地区限制）、DMA consent-mode-v2 点击诊断、根据 2025 年 1 月 QRG 的机器翻译质量标志。

测试覆盖率从 v1.9.9 的 39 个增长到 v2 的 410 个；url_safety 套件单独运行 91 个 SSRF 和 DNS 重新绑定绕过案例，关闭了混淆 IPv4、FQDN 尾随点和重定向重新绑定绕过类别。完整迁移说明和破坏性更改：docs/MIGRATION-v1-to-v2.md。

自 v2.0.0 以来

• v2.1.0（2026 年 5 月）：货币刷新。 2026 年 5 月核心更新，Google I/O 2026（Gemini 2.5 定制版本驱动 AI 模式），FAQ 富媒体搜索结果于 2026-05-07 退役（QAPage 仍然是真实问答页面的类型，但 FAQ 标记本身不再产生富媒体搜索结果）。
• v2.2.0（2026 年 6 月）：安全性和可移植性。 安装程序凭证注入修复，SSRF 权限混淆绕过已关闭，Google API 密钥移至 X-Goog-Api-Key 标头，秘密扫描 CI 关卡，Windows/macOS 修复；套件达到 326。
• v2.2.1（2026 年 6 月）：Google 货币重新确认 + 完整命令审计。 Lighthouse 13.4.0 新增 Agentic Browsing 类别，Google Search 忽略 llms.txt，内部重新加权的 E-E-A-T 评分卡（信任最高，根据 Google 的“信任最重要”）；每个 /seo 命令和子命令均已审计，COMMANDS.md 达到 100% 覆盖率。
• v2.2.2（2026 年 7 月）：全面审查维护。 修正了 GBP Q&A 处理、AI 模式模型命名、图像模型 ID、钩子输入行为，并添加了严格的引用图一致性关卡。
• v2.2.3（2026 年 7 月）：提示卫生对齐。 在不改变行为、路由或输出合同的情况下，规范化了整个提示表面的强调和标点符号。
• v2.2.4（2026 年 7 月）：社区维护。 添加了托管跨平台运行时和安全站点地图发现，修复了 GSC 分页和总计，替换了已删除的 Bing 端点，修复了扩展和 Windows 可移植性差距，并协调了每个开放的问题和拉取请求。

限制

两个值得坦诚相告的实际边界。

重度客户端 hydration 时机。 Phase A 的无头渲染器开箱即用地处理大多数 SPA（--render auto 检测空的 <div id="root"> 外壳并切换到 Playwright）。仍然会产生噪声结果的情况：hydration 与折叠下方滚动位置绑定的页面、在用户交互后获取关键内容的页面（模态框打开、标签页点击）、存在竞态条件的第三方小部件挂载的页面。对于这些情况，建议手动触发 seo-visual 子代理，并将其 Playwright 快照与原始 HTML 子代理的发现进行比较。

默认本地，无富化。 免费层级默认不进行第三方 API 调用（审计仍然会获取你指向的目标 URL）。添加 Google API 凭证（Tier 0 到 3）可以解锁真实现场数据和实时索引状态；没有它们，核心网页指标只是实验室估计，索引状态从页面级信号推断。添加 MCP 扩展（Ahrefs、DataForSEO、SE Ranking、Profound）同样可以解锁竞争和 AI 引用数据，但需要它们各自的账户。

要求

• Python 3.10+
• Claude Code CLI
• 可选：Playwright Chromium — install.sh 会提供安装选项（你可以跳过提示）；仅 SPA 渲染和截图需要
• 可选：用于富化 CWV / GSC / GA4 数据的 Google API 凭证（参见 /seo google setup）

扩展

可选的 MCP 服务器为审计管道添加实时数据。Claude SEO 为 8 个服务器提供了扩展；插件核心无需任何扩展即可工作。

DataForSEO

实时 SERP 数据、关键词研究、反向链接、页面分析、内容分析、商家列表、AI 可见性检查和 LLM 提及追踪。23 个数据命令，涵盖 9 个 API 模块。

./extensions/dataforseo/install.sh   # 需要 DataForSEO 账户
/seo dataforseo serp best coffee shops
/seo dataforseo ai-mentions your brand

完整 DataForSEO 文档：extensions/dataforseo/README.md。

Firecrawl

通过 Firecrawl MCP 服务器进行全站爬取和 URL 发现。

./extensions/firecrawl/install.sh
/seo firecrawl crawl https://example.com

完整 Firecrawl 文档：extensions/firecrawl/README.md。

Banana：AI 图片生成

通过 Claude Banana 创意总监管道生成 SEO 图片（OG 预览、博客英雄图、产品照片、信息图）。

./extensions/banana/install.sh
/seo image-gen og "Professional SaaS dashboard"

完整 Banana 文档：extensions/banana/README.md。

Ahrefs、SE Ranking、Profound、Bing Webmaster、Unlighthouse（v2 新增）

Phase E 新增的五个扩展：

• Ahrefs： 官方 @ahrefs/mcp 服务器，提供反向链接和自然数据
• SE Ranking： AI 声量份额（ChatGPT、Gemini、Perplexity、AI 概览、AI 模式）
• Profound： LLM 引用追踪器，带时间序列数据
• Bing Webmaster： Bing 站长工具加 IndexNow 统一
• Unlighthouse： MIT 许可的多页面 Lighthouse 运行器

设置指南位于 extensions/<name>/docs/ 下；集成说明：docs/MCP-INTEGRATION.md。

生态系统

Claude SEO 是 Claude Code 技能家族的一部分，可以干净地相互操作：

工作流示例：

1. /seo audit https://example.com：识别内容差距和技术问题
2. /seo backlinks https://example.com：分析链接概况和竞争对手差距
3. /seo geo https://example.com/blog/post：评分 AI 引用就绪性
4. /blog write "target keyword"：创建 SEO 优化的博客文章（Claude Blog）
5. /seo image-gen hero "blog topic"：生成英雄图片（Banana 扩展）

常见问题解答

Claude SEO 是什么？

Claude SEO 是一个开源的 SEO 分析插件，用于 Claude Code。它并行运行 25 个子技能和 18 个专业代理，覆盖技术 SEO、内容质量、Schema.org 标记、AI 搜索优化、本地 SEO、电子商务和国际 SEO。审计生成一个优先级行动计划，其中每条建议都包含其所基于的首要原则观察、与其他建议的依赖关系、“我们如何知道这失败了？”检查以及一个领先指标。该插件采用 MIT 许可，不包含任何专有跟踪，无需第三方 API 富化即可工作；审计仍然会联系你分析的目标 URL。与 Google 的 AI 优化指南 和 2025 年 9 月的质量评估指南保持一致。

Claude SEO 与 Screaming Frog 或 Ahrefs Site Audit 有何不同？

不同的覆盖范围，不同的权衡。Screaming Frog 在链接图级别爬取得更深入、更快速；它专为爬取而构建，Claude SEO 不试图取代它。Ahrefs Site Audit 带来专有的反向链接索引和链接情报；Claude SEO 通过其 MCP 扩展与 Ahrefs 集成，而非竞争。Claude SEO 的领先之处：对话式 LLM 原生工作流、建议可证伪性（每条发现都带有明确的失败模式检查）、开源 MIT 许可且无按域名定价、与 Google 原始来源指南一致的 AI 搜索优化，以及基于原始来源的 Schema 弃用跟踪。在 Screaming Frog 或 Ahrefs 最擅长的方面使用它们；当你想要 LLM 驱动的综合、对话式迭代以及在你其他 Claude Code 工作流的同一环境中进行 AI 搜索优先审计时，使用 Claude SEO。

Claude SEO 是否适用于单页应用程序（Next.js、React、Vue）？

是的。v2 的 Phase A 提供了一个共享的无头渲染器（scripts/render_page.py），由 Playwright Chromium 支持。审计子代理调用 render_page.py --mode auto，它会自动检测 SPA 特征（空的 <div id="root"> 外壳、单个 bundle 脚本、hydration 标记）并切换到渲染后的获取。较低级别的 scripts/fetch_page.py 包装器支持 --render auto 作为可选的包装器模式；其默认值为 --render never 以进行原始 HTTP 获取。使用 render_page.py --mode always 或 fetch_page.py --render always 强制渲染。内容提取使用 trafilatura 进行样板移除。发布日期来自 htmldate。已知细节：具有滚动绑定 hydration 或交互后内容获取的页面仍然会产生噪声结果；有关这些边缘情况的推荐 seo-visual 交叉检查工作流，请参阅限制部分。

Claude SEO 使用哪些 Google API，它们是否必需？

都不需要。Claude SEO 在零 API 密钥的情况下完全可用。一个 4 层凭证系统让你逐步升级：Tier 0（仅 API 密钥）解锁 PageSpeed Insights、CrUX 和 CrUX 历史（25 周趋势数据）。Tier 1（+ OAuth 或服务账号）添加 Search Console，包含查询、URL 检查、站点地图状态，以及用于符合条件的 JobPosting 页面或 VideoObject 页面中的 BroadcastEvent 的 Indexing API；该 API 不保证索引。Tier 2（+ GA4 媒体资源配置）添加自然流量、热门着陆页和设备/国家细分。Tier 3（+ Ads 开发者令牌）添加关键词规划师搜索量和竞争数据。凭证设置向导通过 /seo google setup 运行。所有凭证存储在 ~/.config/claude-seo/ 下，文件权限为 0o600；不会检入到仓库中，也不会传输到 Google 自身端点之外。

Claude SEO 是免费的吗？

是的。MIT 许可，完全开源，无按域名定价，无遥测，插件本身不施加 API 配额。核心插件和所有 25 个子技能无需任何付费服务即可工作。某些可选的 MCP 扩展封装了付费服务（DataForSEO、Ahrefs、Profound、SE Ranking），你需要自带账户凭证；它们是可选的，插件完全无需它们即可工作。Google API（PageSpeed Insights、Search Console、Indexing、GA4）来自 Google，免费提供，但有正常的账户配额限制，并且需要你自己的凭证。如果你想要商业支持或开源插件之外的企业功能，这不属于本项目的一部分。

Claude SEO 与常规 SEO 工具在 AI 搜索方面有何不同？

大多数 SEO 工具将 AI 搜索视为一个独立的优化学科。Claude SEO 遵循 Google 自己的立场，即 AEO 和 GEO 是 SEO 的重新包装标签。AI 概览和 AI 模式基于与经典搜索相同的排名系统；资格门槛是正常索引。Claude SEO 对段落可引用性（134-167 字的自包含答案块）、基于问题的标题层级、归因密度以及维基百科、Reddit、YouTube 和 LinkedIn 上的实体存在进行评分。它明确拒绝三个影响者迷思：llms.txt 作为引用杠杆、为 AI 进行内容分块以及 AI 特定的关键词重写。对于电商网站，Claude SEO 根据 Google Merchant Center 政策审计 AI 生成产品图片的 IPTC TrainedAlgorithmicMedia 要求。

文档

• 安装指南
• 命令参考：每个 /seo 命令的深度说明
• 架构：3 层设计、自动发现、并行调度
• 迁移 v1 → v2：破坏性更改、六个工作阶段
• MCP 集成：集成说明；扩展设置位于 extensions/<name>/docs/ 下
• 故障排除