如果你已经在日常开发或写作中使用 Claude Code,想顺手给自己的网站做一次全面的 SEO 体检,又不想一上来就订阅每月上百美元的商业软件,GitHub 上的开源项目 AgriciDaniel/claude-seo 是一个常被提到的选择。
它到底能干什么、靠不靠谱、值不值得装进你的终端?下面用五个最实际的问题,把这个插件的核心功能、运行机制和局限讲清楚。
问一:它到底是什么?
简单说,Claude SEO 是开发者 Agrici Daniel 为 Claude Code 编写的一套开源 SEO 审计插件(目前 plugin.json 标注版本为 2.6.0)。它的核心思路,是把一套原本需要人工逐项核对的 SEO 检查清单,拆解并交给多个专门的 AI 代理(Agents)和本地 Python 脚本去执行。
从项目架构来看,它包含三层组件:
-
26 个子技能(Skills):由
SKILL.md文件定义,包含主控调度器、各项核心审计指令以及扩展接口,负责告诉 Claude 具体查什么、按什么标准打分。 -
19 个专项子代理(Sub-agents):每个代理有独立的角色、工具权限和绑定的模型,分别盯住技术、内容、结构化数据等不同板块。
-
本地 Python 脚本:负责网页抓取、HTML 解析、无头浏览器渲染等确定性的基础工作,再把抓回来的客观数据交给大模型做判断。
在授权和费用上,公开仓库采用 MIT 许可证开源。作者在文档中明确表示,该插件不按站点收费、没有使用次数限制,也不包含遥测追踪;用户唯一需要承担的基础成本是自己的 Claude Code 订阅或 API 额度(作者另外在付费社群提供私有版本供会员抢先体验新功能,公开版可免费使用、功能自足)。
问二:能帮网站查出什么?
一些免费在线小工具只覆盖死链、Meta 标签等基础项,而 Claude SEO 的覆盖面接近一份顾问级的初筛清单。在终端里把网址交给它后,它的检查范围涵盖六个主要方向:
-
技术 SEO 与页面速度:检查爬虫可访问性、索引状态、
robots.txt、XML 站点地图、重定向链、安全响应头,以及 Core Web Vitals(核心网页指标,已按最新标准采用 INP 替代旧的 FID)。遇到 React、Next.js 或 Vue 等依赖客户端渲染的单页应用(SPA),它会自动调用无头浏览器渲染页面,按照真实访客看到的 DOM 结构进行审计。 -
结构化数据(Schema.org):自动检测页面上的 JSON-LD 标记,验证语法错误,也能直接生成缺失的代码。比如在项目展示的一份真实报告片段中,它不仅查出某页面包含 3 个 JSON-LD 块,还精准指出:页面正文写明了两位联合创始人,但
Organization的founder属性里只写了一位,存在“内容与结构化数据不匹配”的问题。 -
内容质量与可信度(E-E-A-T):评估页面是否体现经验、专业性、权威性和可信度,排查字数过少的薄内容页(Thin Pages)和主题覆盖缺口。
-
AI 搜索可见度(GEO 与 Agentic):这是它比许多老牌爬虫更新潮的地方。
/seo geo会检查robots.txt对各类 AI 爬虫的放行情况、页面段落是否易于被直接引用,以及品牌在 Wikipedia、Reddit、YouTube 等公开渠道的提及信号,评估页面被 Google AI Overviews、ChatGPT、Perplexity 引用的潜力;/seo agentic则专门测试 AI 代理能否顺畅读取和导航你的网站。 -
本地、电商与国际化 SEO:针对本地商户检查 Google Business Profile(GBP)信号与 NAP(名称、地址、电话)一致性;针对电商检查商品 Schema;针对多语言站点检查
hreflang配置。 -
上线前后的变更监控(Drift):通过
/seo drift命令,它可以在网站改版或发版前把标题、Meta、Canonical 标签和 Schema 存为本地 SQLite 基线快照,发版后再做比对,防止代码更新意外弄丢关键标签。
跑完全套检查后,它不会只丢给你成百上千条原始报错,而是会计算出一个 0 到 100 的 SEO 健康分(Health Score),并产出一份按优先级排序的行动计划。每条修改建议都会写明判断依据、前置依赖,以及修改后如何验证效果。
问三:为什么要用一群代理来做?
做过全站审计的人都知道,SEO 的维度不仅多,而且不同维度所需的分析能力完全不同:查 robots.txt 和状态码需要严谨的规则核对,而评估一段内容是否适合被 AI 搜索引擎引用,则需要较强的语义理解与综合判断。如果把所有任务塞进同一个提示词上下文里,既慢又容易顾此失彼。
根据项目的架构说明,当你运行全站审计(/seo audit)时,主控技能 seo 会先读取首页信号,识别网站属于哪类业务(SaaS、本地服务、电商、内容出版或代理商),随后同时派生出最多 17 个专项代理并行工作。
其中,技术(seo-technical)、内容(seo-content)、结构化数据(seo-schema)、站点地图(seo-sitemap)、性能(seo-performance)、视觉渲染(seo-visual)、AI 搜索(seo-geo)和搜索体验(seo-sxo)等代理会常规启动;而本地(seo-local)、电商(seo-ecommerce)、Google 数据(seo-google)等代理则根据业务类型或本地是否配置了相应凭据按需触发。各路代理独立跑完脚本和分析后,再把结果汇总成总报告。作者称一次全站审计通常在 10 到 15 分钟内完成。
这种并行架构带来了速度,但也伴随着明确的令牌(Token)消耗代价。在 19 个子代理中,有 14 个运行在 Sonnet 模型上,但有 5 个需要复杂判断的代理默认指定使用更昂贵的 Opus 模型:
-
seo-content(内容编辑) -
seo-geo(AI 搜索分析师) -
seo-cluster(主题聚类策略师) -
seo-sxo(搜索体验设计师) -
seo-drift(变更监控)
因此,跑一次完整的 /seo audit 消耗的 Claude 计划额度,会明显高于单页检查。好在所有代理的配置都是明文 Markdown 文件,如果你觉得额度吃紧,可以直接打开本地 agents/ 目录下的对应文件,把 model 字段手动改成 Sonnet。
问四:怎么装、怎么用?
在安装之前,需要先确认本地环境满足两个硬性要求:Claude Code 版本在 1.0.33 及以上,且系统安装了 Python 3.11 到 3.14(Python 3.10 已停止维护,而 3.15 尚待 Google Ads 客户端库兼容)。
最省事的安装方式是在 Claude Code 终端内直接通过插件市场安装,只需依次运行三行命令:
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup
这里的 /seo setup 是关键一步。插件下载本身不会乱动你的系统包管理器,只有在执行 /seo setup 时,它才会在插件专属的数据目录中创建完全隔离的 Python 虚拟环境,并自动下载用于渲染动态网页的 Playwright Chromium 无头浏览器,不会污染你系统的全局 Python 环境。安装后,随时可以用 /seo doctor 做只读状态自检。如果你倾向于手动安装,也可以通过 git clone 仓库后执行 install.sh(macOS/Linux)或 install.ps1(Windows)。
配置完成后,直接在 Claude Code 中输入 /seo 系列命令即可干活。插件共有 30 个核心与扩展命令,日常最常用的有这几个:
/seo audit https://example.com # 启动并行代理,做全站审计并生成行动计划
/seo page https://example.com/pricing # 只针对某一个具体页面做深度分析
/seo technical https://example.com # 检查 9 大类技术 SEO 指标
/seo schema https://example.com # 检测、验证并生成当前页面的 JSON-LD 代码
/seo geo https://example.com # 专项评估 AI 搜索(ChatGPT/AI Overviews)准备度
/seo drift baseline https://example.com # 在改版上线前保存当前 SEO 基线快照
审计结束后,所有报告都会以 Markdown 文件(如 FULL-AUDIT-REPORT.md、ACTION-PLAN.md)和 JSON 数据的形式保存在本地硬盘上。如果你进一步用 /seo google setup 接入了自己的 Google API,还可以通过 /seo google report 把报告导出为排版好的 PDF。
问五:结果能全信吗?
在项目 README 中,作者展示了项目官网 claude-seo.md 从零开始用该插件优化的成绩:上线后头 12 周获得 1.08 万次 Search Console 点击,移动端 PageSpeed 跑分达到 99 分。不过需要注意,这是作者针对单一自有站点的自报数据,只能作为功能演示,不能当成普遍的疗效保证。
要客观评估它的真实水平,不妨结合外部评测与源码机制来看它的长板与短板:
它的长板在于“规则克制且紧跟官方文档”。
独立技术博客 andrew.ooo 在审阅其代码库后给出较高评价,认为它最难得的地方在于没有沿用过时的“SEO 民间偏方”。例如,它的质量门禁明确禁止推荐早在 2023 年就已废弃的 HowTo 结构化数据;准确记录了 Google 已对所有网站停用 FAQPage 富媒体结果(仅将其标记为普通信息而非严重错误,且不盲目吹嘘它对 AI 引用的作用);在 AI 爬虫分类上,也能准确区分 OpenAI 用于模型训练的 GPTBot 和真正用于搜索引用的 OAI-SearchBot。此外,通过插件安装时,它还带有一个 PostToolUse 钩子,每次生成或修改代码文件都会自动运行脚本校验 Schema,把占位符或废弃类型拦截在上线之前。
但在实际使用中,它有四个明显的局限不能忽视:
-
不接数据源时,没有真实搜索量与真实速度数据:默认未接入外部数据源时,它无法提供关键词搜索量、竞争度或 Google 实时排名(除被审网页外,部分检查仅读取 Wikipedia、Reddit、Common Crawl 等公开网络来源);若未接入 Google API,报告里的 Core Web Vitals 也只是实验室估算值,索引状态仅是根据页面自身信息推断的。只有配置 Google API 凭据后,才能通过 Google Ads Keyword Planner 补充部分关键词指标,而实时 SERP 排名等则需接入 DataForSEO、Ahrefs 等扩展或相应的数据源服务。
-
全站审计中的“内容诊断”偏表面:SEO 机构 Assertive Media 的从业者 Daniel Foley Carter 在实测早期版本时指出,插件给出的健康分和“严重问题”有时过于机械(例如把小型网站缺少
sitemap.xml或未配置llms.txt评为高严重度问题)。更关键的是,在全站审计模式下,它对内容的抽样不够深入,漏掉了测试者故意放置在网站上、仅有 250 到 500 词的薄内容服务页,也缺乏全站范围的重复内容比对和关键词内耗(Cannibalisation)检查。 -
不适合大型网站深度抓取:它的内置爬虫上限为 500 个页面,且带有 1 秒请求延迟。对于几百页以内的中小型网站这很友好,但面对成千上万页的大型站点,它无法替代 Screaming Frog 或 Sitebulb 等专业桌面爬虫。
-
隐私与报告页脚细节:虽然脚本在本地运行,但被分析的页面内容依然会发送给 Anthropic 的 Claude 模型进行处理;此外,社区曾有用户指出,主技能文件默认指示 Claude 在生成的报告末尾附加一行作者署名及两个 Skool 社群推广链接。如果你打算把报告直接发给客户,记得先去本地的
skills/seo/SKILL.md文件里删掉“Community Footer”这一节。
总的来看,如果你期待装上它就能“直接解雇 SEO 团队”,那大概率会失望——它无法替你做深度的内容策略、搜索意图对齐和复杂的整站架构诊断。但如果你把它当成一位驻扎在终端里的初筛助手,用来在网站上线前快速扫除技术死角、编写并校验 Schema 结构化数据、检查 AI 爬虫权限,再配合免费的 Google Search Console 与 PageSpeed API 补充真实数据,它确实能帮你省下大量枯燥的逐项排查时间。
