Claude SEO(也以域名 claude-seo.md 闻名)是由 AgriciDaniel 构建的 Claude Code 开源通用 SEO 技能。拥有超过 5,300 个 GitHub 星标和 MIT 许可,它是 Claude 生态系统中受欢迎的 SEO 技能——将您的终端变成完整 SEO 机构,配备 17 个斜杠命令、7 个并行子代理,以及与 Google SEO API、DataForSEO 和 GEO(生成式引擎优化)的深度集成。
最新版本:v1.7.0(2026 年 3 月 28 日)——MIT 许可下免费开源
目录
- 什么是 Claude SEO?为什么它很重要?
- 17 个斜杠命令
- GEO:2026 年旗舰功能
- Google SEO API 集成
- 架构:三层金字塔
- DataForSEO MCP 扩展
- EEAT 分析与质量门
- 安装指南
- 常见问题
什么是 Claude SEO?为什么它很重要?
Claude SEO 不是 SaaS 平台或浏览器扩展功能。它是一个技能——一组打包的指令和子代理,在 Claude Code(Anthropic 的命令行 AI 助手)内部执行。安装后,您可以直接从终端执行 17 个专业 SEO 命令中的任何一个。
? Claude Code(通过 Claude SEO 技能)
--> /seo audit https://yoursite.com
--> /seo geo https://yoursite.com
--> /seo google report core-web-vitals
该技能专为 SEO 专业人士、内容营销人员、代理商老板和开发者设计,他们需要快速、可重复、自动化的 SEO 分析,而不需要在十多种不同工具之间切换。一切通过 Claude Code 的终端界面运行,结果以结构化报告、图表甚至企业级 PDF 的形式返回。
谁开发的?
创建者 AgriciDaniel 将 Claude SEO 设计为一个通用层,位于 Claude Code 的代理能力之上。他没有为每个 SEO 领域(技术审核、内容分析、结构化数据生成、本地 SEO)建立单独工具,而是将它们统一为一套命令,由一个复杂的多代理协调系统支撑。
17 个斜杠命令
Claude SEO 配备 17 个斜杠命令,每个涵盖一个独立的 SEO 领域。以下是完整列表:
| 命令 | 用途 |
|---|---|
/seo audit <url> | 完整网站审核,并行子代理委派 |
/seo page <url> | 深度单页分析 |
/seo sitemap <url> | 分析现有 XML 网站地图 |
/seo sitemap generate | 使用行业模板生成新的网站地图 |
/seo schema <url> | 检测、验证并生成 Schema.org 标记 |
/seo images <url> | 图片优化分析 |
/seo technical <url> | 跨 9 个类别的技术 SEO 审核 |
/seo content <url> | E-E-A-T 与内容质量分析 |
/seo geo <url> | AI Overviews / 生成式引擎优化 |
/seo plan <type> | 策略性 SEO 规划(saas、本地、电商、发布者、代理商) |
/seo programmatic <url> | 程序化 SEO 分析与规划 |
/seo competitor-pages <url> | 竞争对手比较页面生成 |
/seo local <url> | 本地 SEO 分析(GBP、引用、评论、地图包) |
/seo maps [command] | 地图情报(地理网格、GBP 审核、评论、竞争对手) |
/seo hreflang <url> | Hreflang/i18n SEO 审核与生成 |
/seo google [command] [url] | Google SEO API(GSC、PageSpeed、CrUX、Indexing、GA4) |
/seo google report [type] | 生成含图表的 PDF/HTML 报告 |
命令详解
**完整网站审核(/seo audit)**是旗舰命令。执行时,Claude SEO 会并行派遣多个子代理——一个负责技术分析、一个负责内容质量、一个负责结构化数据检测、一个负责网页速度等。每个子代理在其独立的上下文中运行并汇报结果。主代理随后将所有内容整合为一份优先级报告。
**单页分析(/seo page)**是轻量级版本——深入分析单个 URL,涵盖标题标签、元描述、标题结构、内容长度、内部链接、图片优化以及 Core Web Vitals(如有)。
**结构化数据检测(/seo schema)**扫描页面上的三种结构化数据格式:JSON-LD、Microdata 和 RDFa。它根据 Schema.org 标准验证每个检测到的结构化数据,并能实时生成遗漏的标记——包括 Article、Product、FAQ、LocalBusiness、VideoObject、BroadcastEvent 等。
**策略规划(/seo plan)**专为 SEO 策略开发设计。它支持五种网站类型:SaaS、本地商家、电子商务、发布者和代理商。针对每种类型,它根据行业最佳实践生成优先级排序的行动计划。
GEO:2026 年旗舰功能
GEO——生成式引擎优化——是 2026 年最重要的 SEO 发展。传统 SEO 为 Google 经典的蓝色链接搜索结果进行优化。GEO 则为大型语言模型在搜索引擎中生成的 AI 答案进行优化。
GEO 为什么重要
Google AI Overviews、ChatGPT Search、Perplexity 和其他 AI 驱动的搜索引擎现在服务了相当大比例的搜索查询。当用户问"什么是适合小型企业的最佳 CRM?“时,AI 搜索引擎可能会生成一个综合多个来源的答案——但只引用其中少数几个。GEO 就是要让您的内容成为那些被引用的来源之一。
Claude SEO 如何处理 GEO
/seo geo <url> 命令执行全面的 GEO 审核:
- AI 可引用性分析——评估您的内容结构是否便于 AI 模型提取和引用。最佳段落通常为 134-167 字,信息丰富且范围清晰。
- llms.txt 支持——检查
llms.txt的存在与质量,这是告诉 AI 爬虫如何解释您网站的新兴标准(类似robots.txt,但针对 LLM)。 - 实体清晰度——分析关键实体(人物、产品、概念)是否以明确无歧义的语言定义。
- 权威信号——衡量 AI 模型在决定是否引用来源时会考虑的品牌权威指标。
- AI 用结构化数据——验证结构化数据标记是否足够完整,让 AI 系统能以程序化方式解析和理解您的内容。
Claude SEO 还包含针对 GEO 活动的质量门——30 个以上本地页面触发警告,50 个以上页面在未经事先审核的情况下强制停止,防止薄弱的内容被大量优化以迎合 AI 搜索。
Google SEO API 集成
1.7.0 版本引入了与五个 Google API 的直接集成,让 Claude SEO 能够在不离开终端的情况下提取实时 Google 数据。
API 凭证层级
该技能实现了4 层凭证系统:
| 层级 | 验证方式 | 可用的 API |
|---|---|---|
| 0 | 仅 API 密钥 | PageSpeed Insights、CrUX、CrUX History |
| 1 | + OAuth / 服务账号 | + Google Search Console、URL Inspection、Indexing API |
| 2 | + GA4 设置 | + Google Analytics 4 自然流量 |
| 3 | + Ads 令牌 | + Keyword Planner |
您可以做的事
- PageSpeed Insights + CrUX——实验室和现场 Core Web Vitals 数据:Largest Contentful Paint (LCP)、Interaction to Next Paint (INP)、Cumulative Layout Shift (CLS)。目标:LCP < 2.5s、INP < 200ms、CLS < 0.1。
- Search Console——热门查询、URL 检查、网站地图提交状态、点击率分析。
- Indexing API——以程序化方式通知 Google 页面已添加、更新或移除。
- GA4——自然流量趋势、热门落地页、设备分布、国家分布。
- PDF/HTML 报告——生成含嵌入式图表的 A4 格式企业报告(由 WeasyPrint 和 matplotlib 驱动)。
架构:三层金字塔
Claude SEO 建立在一个三层金字塔模型上,专为效率和可扩展性设计。
┌─────────────────────┐
│ 指令层 │ SKILL.md(渐进式揭露)
│ (~60 tokens) │
├─────────────────────┤
│ 协调层 │ 7+ 个并行子代理
│ (隔离上下文) │ 将任务分派给工作者
├─────────────────────┤
│ 执行层 │ MCP 服务器、API、工具
│ (Firecrawl, Google, │
│ DataForSEO, etc.) │
└─────────────────────┘
第 1 层:指令层
一个轻量级的 SKILL.md 文件,带有定义 17 个命令的 YAML frontmatter。渐进式揭露意味着每个命令仅在调用时加载其完整指令,静止时基础 token 成本维持在约 60 tokens。
第 2 层:协调层
七个在隔离上下文中运行的并行子代理。当您执行 /seo audit 时,协调器会分派专门的代理处理技术 SEO、内容质量、结构化数据分析、网页速度、内部链接、图片优化和安全性。每个代理独立运行,仅汇报其发现——代理之间没有上下文污染。
第 3 层:执行层
实际的工具调用——用于实时数据的 MCP 服务器(Firecrawl 用于爬取、DataForSEO 用于 SERP 数据、Google API 用于性能指标)、用于解析和分析的本地脚本,以及报告生成管线。
DataForSEO MCP 扩展
除了内置的 Google 集成之外,Claude SEO 还支持扩展系统,以 DataForSEO MCP 作为其旗舰附加组件。
DataForSEO 扩展在 9 个 API 模块中新增了 22 个命令:
- 实时 SERP 数据(Google、Bing、YouTube 等)
- 关键字研究和建议
- 反向链接分析
- 页面内 API 分析
- 商家列表和引用
- AI 可见性检查和 LLM 提及追踪
使用包含的安装脚本安装:
./extensions/dataforseo/install.sh
安装后,您可以执行如下命令:
/seo dataforseo serp best coffee shops
/seo dataforseo keywords "SEO tools"
/seo dataforseo backlinks https://example.com
还有一个Banana AI 图片生成扩展,可使用创意总监管线搭配 Gemini 图片生成,创建 SEO 优化的视觉内容(OG 图片、主图、信息图)。
E-E-A-T 分析和质量门
E-E-A-T 框架
Claude SEO 根据 Google 的 E-E-A-T 框架(经验、专业知识、权威性、可信度)评估内容,更新至 2025 年 9 月的质量评估指南。分析检查:
- 经验——内容是否展示了第一手或实际经验?
- 专业知识——是否显示了作者资历、资格或相关背景?
- 权威性——网站或作者是否被认为是该领域的可信来源?是否有来自权威域的高质量反向链接?
- 可信度——网站是否安全(HTTPS)、对其业务是否透明、无欺骗性做法?
质量门
Claude SEO 实施严格的护栏以防止低质量的大量生成:
| 情境 | 警告 | 强制停止 |
|---|---|---|
| GEO/位置页面 | 30+ 页面 | 50+ 页面 |
| 程序化 SEO | 100+ 页面 | 500+ 未经审核 |
| 薄弱内容 | 按页面类型检测 | 防止门页 |
这些门旨在防止 SEO 垃圾邮件,并与 Google 的质量指南保持一致。如果触发强制停止,Claude SEO 将拒绝继续,直到您执行完整审核或调整范围。
其他技术能力
- Core Web Vitals 监控(LCP < 2.5s、INP < 200ms、CLS < 0.1)
- 结构化数据标记检测,涵盖 JSON-LD、Microdata 和 RDFa 格式
- Hreflang/i18n 多语言网站审核
- 图片优化分析(替代文字、尺寸、压缩、延迟加载)
- 地图情报通过
/seo maps——地理网格排名追踪、Google Business Profile 审核、评论情感分析、竞争对手半径映射
安装指南
插件安装(推荐用于 Claude Code 1.0.33+)
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@AgriciDaniel-claude-seo
手动安装(Unix/macOS/Linux)
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh
快速开始
# 启动 Claude Code
claude
# 执行完整网站审核
/seo audit https://example.com
# 分析单个页面
/seo page https://example.com/about
# 检查结构化数据标记
/seo schema https://example.com
# 为 AI 搜索优化
/seo geo https://example.com
# 获取 Google 性能数据
/seo google psi https://example.com
常见问题
Claude SEO 完全免费吗?
是的。Claude SEO 在 MIT 许可下发布,完全免费使用。唯一的潜在成本是 Claude Code 的使用费(token 消耗)以及可选的 Google API 或 DataForSEO 付费 API 密钥(如果您启用这些集成)。
Claude SEO 能与其他 AI 代码工具一起使用吗?
原始的 claude-seo 是为 Claude Code 设计的,但创建者也发布了 codex-seo——一个针对 Codex 改编的移植版本,具有 26 个工作流程和 24 个基于 TOML 的代理。
我需要 Google API 密钥吗?
对于基本 SEO 分析(审核、页面、结构化数据),不需要密钥。Google API 是可选的,可以使用 4 层凭证系统逐步设置。
Claude SEO 支持哪些类型的网站?
Claude SEO 适用于任何公开可访问的网站。/seo plan 命令专门支持五个垂直领域:SaaS、本地商家、电子商务、发布者和代理商。
Claude SEO 可以生成报告吗?
是的。自 v1.7.0 起,/seo google report [type] 命令生成带嵌入式图表的 A4 格式 PDF 报告,适用于客户交付物或内部文档。
Claude SEO 与传统 SEO 工具相比如何?
Ahrefs、Semrush 和 Moz 等传统 SEO 工具提供宽广的仪表板和历史数据。Claude SEO 专注于可操作、AI 驱动的分析,通过终端界面交付——在 GEO、结构化数据生成和多代理并行审核方面特别强大。许多用户两者结合:使用 Claude SEO 进行深入分析和自动化工作流程,使用传统工具进行排名追踪和反向链接监控。
总结
Claude SEO 代表了一个新类别的 SEO 工具——代理式 SEO,由 AI 协调而非传统仪表板驱动。凭借 17 个命令、7 个并行子代理、针对 AI 搜索引擎的 GEO 优化、直接的 Google API 集成,以及连接 DataForSEO 和图片生成管线的扩展系统,它提供的功能否则需要一个专家团队和多个付费订阅。
2026 年版(v1.7.0+)是迄今为止功能最丰富的版本,带来了 Google SEO API、GEO 分析、PDF 报告和增强的安全防护。对于准备好从命令行工作并拥抱 AI 原生工作流程的 SEO 专业人士来说,Claude SEO 是工具箱中必不可少的补充。
mindmap
root((Claude SEO\n2026))
审核
完整网站审核
单页分析
技术 SEO
内容质量
AI 搜索 (GEO)
AI Overviews
ChatGPT Search
Perplexity
llms.txt
Google API
PageSpeed + CrUX
Search Console
Indexing API
GA4
PDF 报告
结构化数据与数据
JSON-LD
Microdata
RDFa
VideoSchema
本地与地图
GBP 审核
地理网格追踪
评论分析
引用
扩展
DataForSEO (22 个命令)
Banana AI 图片
Firecrawl 反向链接本文基于对 AgriciDaniel/claude-seo 存储库、claude-seo.md 文档和社区分析的研究。所有技术细节截至 2026 年 5 月。
