夜雨聆风Overall Score: 27/100On-Page SEO: 30/100Content Quality: 10/100Technical SEO: 35/100Schema/Structured: 0/100Performance (CWV): 95/100AI Search Readiness:10/100
这是 claude-seo 对 example.com 打的单页分。example.com 本来就是个空壳测试页，分低正常。但注意看分布：性能 95，技术 SEO 35，内容质量 10，Schema 0，AI 搜索就绪度 10。
性能这么好，内容却几乎零分。这个反差本身就是信息——我见过太多真实的站，服务器又快又稳，但 Meta 描述缺失、正文 17 个词、Schema 全空，被 AI 搜索的抓取器判定为低价值页面。
这次推荐的，就是这个能打出这份报告的东西：claude-seo。
claude-seo 全景
它是给 Claude Code 装的 SEO 分析插件，25 个 sub-skill 加 18 个专家 Agent，32 条 /seo 命令。全站审计时最多 15 个专家 Agent 并行开跑，10 到 15 分钟出一份带优先级、带修复建议、带 falsifiability 检查的完整报告。
我没光看 README，是真装了真跑了。装的过程还翻了几次车，先讲坑。
本文状态：已实测。 实测环境：Linux + Claude Code 2.1.233 + Python 3.13，安装了 v2.2.4。
在 Claude Code 里装是最省事的，三条命令：
/plugin marketplace add AgriciDaniel/claude-seo/plugin install claude-seo@agricidaniel-claude-seo/seo setup
第一条把 GitHub 仓库注册成插件市场，第二条安装插件本身，第三条创建隔离的 Python 运行时（依赖装进 Claude 自己的数据目录，不污染全局环境）。装完跑 /seo doctor 随时检查环境。
claude-seo 安装流程
不想走插件市场也行，手动 clone 然后跑 install.sh，效果一样。我就用的手动路径，结果踩了坑，先讲这个坑。
git clone https://github.com/AgriciDaniel/claude-seo.gitcd claude-seochmod +x install.sh./install.sh
默认安装脚本会创建一个隔离的 Python 虚拟环境，拉 requirements.txt 里的依赖，然后装 Playwright Chromium。问题就出在这个「拉依赖」上。
默认 PyPI 源在国内慢得离谱，第一次 install.sh 跑了 5 分钟直接超时失败，报错只有一行：Core Python runtime setup failed。不是依赖本身装不上，是网络。
把 pip 源换成清华镜像，重跑 setup，一分钟装完：
$ PIP_INDEX_URL=https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple ./bin/claude-seo setupCreating isolated Claude SEO environment...Claude SEO runtime is ready.
还有个隐蔽坑：setup 超时会把 .setup.lock 留在技能目录里。第二次跑 setup 会直接报「another Claude SEO setup is already running」，哪怕根本没有 setup 进程在跑。删掉这个锁文件重跑就行。
装完顺手跑了 /seo doctor，环境就绪，报告显示 v2.2.4、Python 3.13，Chromium 未装（只影响截图类命令，审计类全都能跑）。
真跑了三条命令。
第一条 /seo schema https://example.com，耗时 2 分钟。它检测出页面零 structured data，然后自动生成 JSON-LD 模板，WebSite、Organization、BreadcrumbList、WebPage 全给了，还给了优先级行动计划和验证清单。
claude-seo 工作流程
最有价值的部分是它把「过时技巧」标得明明白白：HowTo 富结果 2023 年就下线了，FAQPage 的富结果 2026 年 5 月 7 日被谷歌全部停用，ClaimReview、CourseInfo、EstimatedSalary 这些也在 2025 年被退役。你搜 SEO 文章时最常见的那些「赶紧加 FAQ 结构化数据」的建议，它直接给你标成废弃。
第二条 /seo page https://example.com，单页深分析，7 大类 40 多项逐项打分。
| Element | Score | Notes ||---------|-------|-------|| Title Tag | 2/10 | 14 chars, target 50-60 || Meta Description | 0/10 | Missing entirely || Word Count | 0/10 | ~17 words (homepage min: 500) || Internal Links | 0/10 | None || Security Headers | 2/10 | Missing XFO, HSTS, CSP || OG / Twitter | 0/10 | None |
每一条都带修复方式。Meta 缺失就给你一行可以直接粘的标签，正文太薄就告诉你首页最低 500 词这个阈值，安全头缺失就把该加的四个头名字列出来。
claude-seo 实测审计报告
第三条我跑的 /seo technical 超时了（全站技术审计太重），但这不影响结论——核心命令都验证过能跑通。
它跟你看到的普通 SEO 工具有什么不一样。
最不一样的一点是 falsifiability。每一条建议除了告诉你「该改什么」，还会告诉你「怎么验证这条建议有没有生效」，外加一个先行指标。不是让你信它，是给你一个可证伪的检查点。
第二个不一样是数据不离开你的机器。审计过程全程本地跑，默认零 API key。想接谷歌 Search Console、GA4 这些真实数据，按需往上加凭据就行，有四层档位，第一层免费的 PageSpeed 和 CrUX 就能拿到 25 周趋势。凭据存在 ~/.config/claude-seo/，权限 600，不进 git。
第三个是它对齐的是谷歌一手文档。Google 的 AI 优化指南（2026 年 5 月版）、2025 年 9 月更新的质量评分指南、INP 替代 FID 这种时间线，它都跟到了。顺带澄清了几个流行误区：llms.txt 目前不是引用杠杆、AI 专用关键词改写没必要。
谁最需要它。
claude-seo 适用人群
SEO 机构，每周一早上对每个客户站跑一遍 /seo audit，交付从季度变周报，还不用加价。SaaS 公司的内部 SEO，季度业务评审前一天跑一轮，把平台 UI 埋掉的坑先挖出来——程序化页面的 canonical 链断裂、谷歌 2025 年 6 月那一波 schema 退役之后失效的旧标记、收购来的老域名历史包袱。自由职业顾问，第一次跟客户通话就把报告甩出来，先给一个 0-100 的真实分数和三个高优先级发现，再谈合作。
我用 example.com 这种空壳站测不出它的上限，但它的下限已经很清楚了：免费、本地、可验证、跟谷歌一手标准。你的站如果有真实流量，值得让 Agent 先扫一遍。
来源：https://github.com/AgriciDaniel/claude-seo
关注Agent技能库，每天认识一个可用的AI Agent Skill。