claude-seo：把 SEO 审计拆成 25 个子技能和 18 个并行代理的 Claude Code 插件
Claude Code 的通用 SEO 技能。 25 个子技能 + 18 个子代理，涵盖技术 SEO、E-E-A-T、模式、GEO/AEO、反向链接、本地 SEO、地图智能、语义聚类、电子商务 SEO、国际 SEO、Google API 和 PDF/Excel 报告。可选的 DataForSEO、Firecrawl 和 Banana 扩展。
秒懂
- 它是什么？
- claude-seo 是一个面向 Claude Code 的 SEO 审计插件，用 25 个子技能和 18 个并行代理覆盖技术 SEO、E-E-A-T、Schema、GEO 等领域。它把审计变成可验证的假说，而不是一份漂亮的报告，但你需要接受它的运行成本和外部依赖。
- 适合谁用？
- 适合每天处理多个客户站点的 SEO 代理商、需要在高管评审前做第二双眼睛的内部 SEO 负责人，以及想用 15 分钟审计拿下新客户的自由顾问。不适合只想跑一次 Lighthouse 或不想维护 Python 运行时的人。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 4 天前。
- 用什么语言写的？
- 主要是 Python（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决的是审计报告不可验证的问题
传统的 SEO 审计工具输出一堆红色警告，但没人能说清为什么这条建议成立，也不知道改了之后怎么判断有没有效果。claude-seo 的定位很明确：每个建议都附带第一性原理的观察、依赖关系、一个显式的“我们怎么知道它失败了”的检查，以及一个领先指标。这是 README 里反复强调的“falsifiable, not promotional”原则。换句话说，它不给你一个结论，而是给你一个可以检验的假说。这个设计对代理商尤其有价值，因为客户可以拿着检查项去验证，而不是听你说完就完。
并行代理是它和普通脚本的分水岭
全站审计时，claude-seo 会同时派出最多 15 个专业代理，分别处理技术 SEO、内容质量、Schema.org 标记、GEO、本地 SEO 等不同领域。README 说这样站点级审计能在几分钟内完成，而不是几小时。并行不是简单的多线程，而是每个代理有独立的子技能和检查清单，最后汇总成一个带优先级的行动计划。这种架构的代价是运行时的资源消耗：你需要一个能撑住并发 Chromium 实例的机器，否则代理之间会互相争抢 CPU 和内存。文档没有给出最低硬件要求，但根据 Playwright Chromium 的常见行为，本地跑小站点可能还好，大站点建议在 CI 或云主机上执行。
安装和启动：两条路径，一个前提
安装有两种方式。插件路径要求 Claude Code 1.0.33 以上，先加 marketplace，再装插件，最后运行 /seo setup。这个 setup 会创建一个隔离的 Python 环境，并安装 Playwright Chromium，不会污染全局 Python 包或 PATH。手动路径是 git clone 后运行 install.sh 或 install.ps1，README 特意提醒不要用 irm | iex 这种远程执行脚本的方式，因为 Claude Code 的安全机制会拦截。安装后最常用的命令是 /seo audit <url> 做全站审计，/seo page <url> 做单页深度分析，/seo schema <url> 检查 Schema，/seo geo <url> 做 AI 搜索优化分析。另一个值得记的命令是 /seo doctor，它只检查运行环境而不改动系统，适合排查问题。
AI 搜索优先：GEO 和 E-E-A-T 不是包装词
这个插件的重点不是传统关键词排名，而是 AI 搜索优化。README 明确提到它对齐了 Google 的 AI Optimization Guide，包括基于问题的可引用性评分、llms.txt 的原始证据、以及针对 AI 生成产品图片的 IPTC TrainedAlgorithmicMedia 标记。它还检查 agent-friendly 页面，也就是那些能被 AI 代理轻松理解和引用的页面。这意味着 claude-seo 试图回答一个实际问题：你的内容在 AI 生成的答案里有没有被引用。这种方向对出版和电商站点很有意义，因为这些站点的流量正在被 AI 摘要截胡。但要注意，GEO 本身是一个快速变化的领域，Google 的指南更新频繁，插件的评分标准可能滞后，你需要定期更新版本。
你需要注意的失败模式和边界
claude-seo 不是万能的。它依赖外部服务来获取数据，比如 DataForSEO、Firecrawl 和 Banana 扩展，这些是可选的，但如果你不配置，某些功能可能无法工作。README 也列出了 Limitations 章节，虽然内容被截断，但可以推断它不会替代 Google Search Console 和 Lighthouse，而是补充它们看不到的东西，比如 schema 弃用、AI 可引用性差距、过期域名遗产风险、寄生 SEO 暴露和机器翻译漂移。一个明显的失败模式是：如果目标站点有反爬机制或需要登录，Playwright 抓取会失败或得到不完整数据。另一个是误报，任何自动化审计都会产生假阳性，claude-seo 的假说式建议需要人工判断，不能盲目执行。
替代方案：Codex SEO 和手动审计
如果你不用 Claude Code，而是用 OpenAI 的 Codex，作者提供了一个移植版叫 Codex SEO，它使用 TOML 代理配置、插件打包和确定性运行器，但保持相同的 SEO 工作流。这说明 claude-seo 的工作流设计是可复用的，不绑定特定模型。另一个替代方案是传统的手动审计或商业工具，比如 Screaming Frog 或 Ahrefs，但那些工具通常不提供可证伪的假说检查，也不做并行代理式的深度分析。claude-seo 的差异化在于它把审计变成一种研究过程，而不是输出一份静态报告。如果你需要的是快速抓取和标准检查，商业工具可能更顺手；如果你需要的是可验证的推荐和 AI 搜索优化，claude-seo 更对路。
维护成本和许可证：MIT 的代价是你要自己负责
项目使用 MIT 许可证，意味着你可以自由使用、修改和分发，包括商用。但维护成本不低：你需要跟上 Claude Code 的版本更新，因为插件依赖 Claude Code 1.0.33+ 的插件机制；你需要定期运行 /seo doctor 检查运行时是否健康；你还要关注 Google 的 SEO 指南变化，因为评分标准基于这些指南。README 显示项目有活跃的发布节奏，v2.2.5 在 2026 年 8 月发布，说明作者在持续修复可靠性问题。但这也意味着升级可能带来破坏性变化，你需要读 changelog。另外，社区版本需要加入 AI Marketing Hub Pro 的 Skool 社区才能使用，这涉及会员费，而公共版本是免费的，选择时要考虑清楚。
编辑结论
适合每天处理多个客户站点的 SEO 代理商、需要在高管评审前做第二双眼睛的内部 SEO 负责人，以及想用 15 分钟审计拿下新客户的自由顾问。不适合只想跑一次 Lighthouse 或不想维护 Python 运行时的人。采用前先验证三件事：你的站点是否能承受 Playwright Chromium 的并发抓取，你是否接受 DataForSEO、Firecrawl 等扩展带来的额外费用，以及你是否有时间阅读每个建议附带的“如何知道它失败”的检查。claude-seo 的价值不在于自动化，而在于把审计变成可证伪的流程，但这份严谨需要你付出配置和运维的代价。
社区笔记