2026年2月底,GitHub上一个名为claude-seo的仓库收获了3500个Star。短短五个月后,这个数字飙升至12.3K Star、1.8K Fork。作者Daniel Agrici独自维护,采用MIT协议开源。安装后,你只需在Claude Code里敲下一行指令 /seo audit https://你的站点,大概十分钟,就能拿到一份从0到100分的网站体检报告,所有问题按严重程度排好序。
围观者大致分为两派。一派认为,这简直是Ahrefs的免费平替,每月能省下几百美金的订阅费;另一派则质疑,AI生成的SEO建议不能轻信,即便审计得分再高,不涨流量也是白搭。
这两拨人争论的,其实并非同一件事。这篇文章将深入剖析三个层面:它到底内置了什么能力、从SEO工具链中抽走了哪一环,以及我们能从这个案例中提炼出怎样的判断法则——下次你再看到一个爆火的AI Skill,完全可以用同一套标准来衡量它值不值得安装。

一、它到底内置了什么
先感受一下它的体量:包含25个子技能、18个专家Agent、32条用户命令以及8个可选扩展。
安装起来也只是一条命令的事:
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup
它的依赖项只有Claude Code、Python 3.10+ 和 Git。另外,你可以选择性安装Playwright Chromium,用于渲染SPA页面和截图。
这25个子技能里,一半是SEO从业者再熟悉不过的基础科目:技术审计(涵盖可爬性、可索引性、Core Web Vitals、URL结构)、E-E-A-T内容评估(完全对齐2025年9月版的Google质量评估员指南)、Schema标记校验(兼容JSON-LD / Microdata / RDFa三种格式)、hreflang国际化核验、sitemap质检以及图片优化。
另一半则是近两年才兴起的新科目:
- GEO / AI搜索:专门针对AI Overviews、ChatGPT、Perplexity、Bing Copilot进行可见度优化。
- Maps Intelligence:实现7×7地理网格排名追踪,提供25项Google商家资料清单和评论情报。
- SEO Drift Monitoring:对页面的SEO状态做版本管理,用SQLite存储基线,内置17条比对规则,并将改动按严重程度分级——这相当于给你站点的SEO状态装了一个Git。
- Topic Clusters:利用SERP结果重叠度进行语义聚类,产出枢纽-分支式(hub-and-spoke)内容架构。
- Programmatic SEO:具备批量生成页面的能力,并自带薄内容检测闸门。
当你执行 /seo audit 时,中央调度器(orchestrator)会先识别站点类型(从SaaS、本地服务、电商、媒体、代理商这五类中筛选),然后并行拉起最多15个子代理,其中8个常驻运行,7个按条件触发。
在工程实现上,最值得关注的一处设计叫“渐进式披露”(Progressive Disclosure):元数据常驻内存,指令仅在激活时加载,参考资料按需拉取。仓库自身规定每个SKILL.md文件不得超过500行、5000个token,reference文件不超过200行。25个技能全塞在一个插件里还没把上下文窗口撑爆,靠的就是这条铁律。 对于任何想开发多技能包的人来说,这个设计思路比SEO知识本身更值得借鉴。
二、数据从哪来,这决定了它的天花板
在默认模式下,它不调用任何第三方API,只抓取你指定的目标URL,全程在本机运行。这正是它敢于宣称“无需注册、无速率限制、无需信用卡”的底气所在。
但这也意味着,在裸装状态下,它拿不到你的真实数据。Core Web Vitals只有实验室估算值,索引状态全靠页面信号推断,你无法看到Search Console里的真实数据。
想要获取真实数据,就得接入Google API,分为四个档位:
| 档位 |
需要什么 |
换来什么 |
| Tier 0 |
一个API key |
PageSpeed、CrUX、25周CrUX历史趋势 |
| Tier 1 |
+ OAuth或服务账号 |
Search Console查询、URL检查、Indexing API |
| Tier 2 |
+ GA4配置 |
自然流量、落地页、设备与国家拆分数据 |
| Tier 3 |
+ Ads token |
Keyword Planner搜索量与竞争度 |
再往外延伸,就是MCP扩展的世界了:DataForSEO提供实时SERP、关键词和外链数据;Firecrawl负责全站爬取;还有Ahrefs官方server、SE Ranking(分析ChatGPT/Gemini/Perplexity/AI Overviews的AI声量份额)、Profound(追踪LLM引用)、Bing Webmaster以及Unlighthouse。
这份扩展清单本身就是一个明确的信号:claude-seo没打算自己造数据,它把所有需要高昂采集成本的部分都外包了出去。 作者在README里写得很坦诚——它不打算取代Screaming Frog在链接图层面的深度爬取,也不打算替代Ahrefs的自有外链索引。如果你想深入了解这些热门开源实战项目背后的架构思想,会发现这种清晰的边界感至关重要。
三、三层拆解法:它抽走了哪一段
这里,我们可以引入一个模型来分析。
SEO工具链,本质上是一个三层结构:
数据层——包含外链索引、真实SERP排名、搜索量、抓取日志等。这一层的核心成本是采集成本:你必须养爬虫、买代理、跑通数十亿页面的索引。Ahrefs和Semrush这类工具的核心资产就在于此。
判断层——负责将一堆原始数据,翻译成“该改什么、先改哪个”的具体建议。这一层的核心成本是经验成本:你需要知道hreflang少了自引用标签会引发什么问题,知道FAQ富媒体结果已经退役就不该再堆砌对应的Schema,知道E-E-A-T在医疗类站点和工具类站点上的权重天差地别。过去,这种判断力要么被打包在SaaS订阅费里卖给你,要么以顾问的日费形式卖给你,而且它曾是三层中最不透明的一层。
执行层——真正去修改代码、调整模板、补全标记、重写标题。在过去,这一层完全由人来完成,工具到最后只会扔给你一份PDF报告。
claude-seo所做的事情,就是把判断层单独剥离出来,变成一堆可读、可改的markdown文件,然后免费开源。
它抽走的,是三层里最昂贵、也最容易复制的那一层。 外链索引你复制不了,因为采集成本是硬门槛;但“看到某个信号该给什么建议”这类知识,属于可编码的经验,一旦被写成文件,边际成本就趋近于零。
顺带发生的第二件事更有意思:因为它运行在Claude Code里,宿主Agent天生就能读取你的代码库、改动你的文件,所以判断层和执行层被牢牢地焊在了一起。传统工具的审计流程止于报告,你得自己动手去改;claude-seo则在审计完成后,可以直接帮你把Schema补上、把hreflang修好、把sitemap重新生成。审计和动手,在同一个进程里闭环了。
这个三层拆解法,可以复用到任何一个突然爆火的AI Skill上。你只需要问三个问题:
- 它抽的是哪一层? 抽数据层的,大概率站不稳,因为那一层的护城河建在采集成本上,光有逻辑根本复制不出来。抽判断层的,最容易成立,因为经验知识本来就适合文本化。
- 它的宿主Agent能不能顺手做执行? 能,价值就翻倍;不能,那它就只是一个更聪明的报告生成器。
- 它有没有诚实地标注自己够不到的层? claude-seo明确表示不碰外链索引和深度爬虫。这种对能力边界的坦诚,反而是它可信度的来源。
四、为什么偏偏在2026年火了
这个时间点绝非偶然。
2026年的搜索环境已经彻底变了形:超过80%的Google搜索以零点击告终;一旦AI Overviews被触发,第一位自然结果的点击率会骤降58%到61%,在信息型查询中最高降幅可达61%;Gartner预测,2026年传统自然搜索流量整体将下滑25%;行业内,已经有20%到30%的SEO预算正在向AI搜索优化迁移。
排到第一名,不再等同于拿到点击。被AI答案引用,已经成了新的可见度货币。
这件事对老一代工具链的杀伤,主要集中在判断层。数据层分毫未损——外链还是那个外链,排名还是那个排名。但拿到这些数据后该给出什么建议,这套逻辑在AI摘要接管流量入口后,已经大面积失效。老工具的判断层急需重写,而重写判断逻辑的当口,恰好就成了新玩家挤进来的绝佳窗口。
有意思的是,claude-seo在其方法论文档里,直接将GEO和AEO定性为SEO的换皮版,拒绝承认它们是独立学科。这个判断,与市面上大量兜售GEO课程的声音背道而驰。但它自己的GEO技能,却又实实在在地覆盖了四个主流AI搜索平台。嘴上不承认这是新学科,手上却老老实实地把所有新平台的规则都实现了一遍——在一个仅靠蹭GEO热度就能涨粉的赛道里,这种姿态称得上是一种难得的克制。
五、它会在哪里出错
一个拥有12K Star的项目,值得被认真地挑剔。
动态渲染是它已知的软肋。 项目自身也承认,那些依赖于用户交互才加载内容的场景(比如打开弹窗、滚动到特定位置才拉取数据)会产生充满噪声的结论。官方给出的解法是用 /seo visual 子代理进行对比复核,但这前提是,你得知道哪个地方需要去复核。
评分不等于排名。 这是所有SEO审计工具的通病,AI版本的工具只是让这个问题更具迷惑性了——一份结构工整、有严重度分级、且每条都附带证据的报告,读起来会比真实世界的因果逻辑可靠得多。审计报告衡量的,只是站点符合已知最佳实践的程度,而排名是由竞争格局、外链权重、内容供需关系共同决定的。在审计跑到99分和流量真正上涨之间,还隔着无数变量。
AI生成的判断,可能会出现看起来非常合理的错误。 项目对此做了一层工程上的对冲:强制要求每条建议都必须附带四样东西——所依据的观察、依赖关系、如果结论错了该如何发现的验证方法、可监控的先行指标。这套名为“四阶段方法论”(PERCEIVE / ANALYZE / VALIDATE / ACT)的设计,其目的不在于让AI少犯错,而是把每一条建议都变得可证伪,至少让你知道该去校验哪里。
安全性是需要紧跟版本的。 v2.2.x系列曾修复过SSRF绕过和凭证注入漏洞。一个会主动向你指定的URL发起请求,并且还持有你Google OAuth令牌的工具,其攻击面天生就比普通的命令行工具要大。它现在拥有410多条测试用例,其中91条专门用于测试SSRF和DNS重绑定,这个数字是从v1.9.9时代的39条涨上来的——增速本身就说明了先前趟过的坑。装了它就千万别停留在老版本上。
关键结论
- claude-seo用五个月时间,从3.5K Star涨到12.3K Star。它的核心筹码,是将SEO的判断层写成了一套免费开源的文件,而其数据能力从头到尾都是外接的。
- 它的能力天花板由数据层决定:裸装状态下只有实验室数据,接上Google API的四个档位才能获取真实数据,而外链和SERP数据仍需外接DataForSEO、Ahrefs这类付费数据源。
- 它与传统工具最大的不同,在于将审计和执行置于同一个进程——报告生成后,能立刻动手修改你的代码。
- 数据层、判断层、执行层的三层拆解法,可以用于衡量任何一个AI Skill:抽判断层的项目最容易成立,抽数据层的多半立不住,而能在判断的同时顺手完成执行的,价值会直接翻倍。
- 2026年,AI Overviews压低了六成点击率,导致老一代工具的判断逻辑大面积过期,这为新判断层的出现打开了窗口——而这个窗口不会永远敞开。