10分钟用Claude Code完成全站SEO审计
通过开源插件claude-seo，在Claude Code中零配置完成专业级SEO审计。教程带你跑完全站技术+内容诊断，拿到带优先级和验证方法的可执行修复清单，适合独立开发者、SEO从业者和站长快速上手。
10分钟用Claude Code完成全站SEO审计
团队有个SaaS官网改版后organic traffic不升反降，产品经理急着排查。传统SEO审计要么手工过页面，要么买商业工具爬全站，动辄几小时。用开源项目 claude-seo 在 Claude Code 里完成一次完整SEO诊断，从安装到输出一份带优先级的审计报告，10分钟搞定。
这不是一个「AI写SEO博客」的工具，而是一个审计分析插件——帮你发现问题、排出优先级、给出可验证的修复建议。
前置条件
开始前准备好：
- Claude Code CLI（
claude --version≥ 1.0.33）。去 claude.ai/claude-code 按官方指引安装。 - Python 3.10+（
python3 --version确认）。审计引擎底层调用Python脚本做页面渲染和数据处理。 - 一个想审计的网站URL——演示用
developer.mozilla.org，内容丰富能看到真实分析结果。
不需要Google API Key、不需要购买第三方服务，核心功能零配置可用。
安装与启动
打开Claude Code，在终端执行：
bash
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup/seo setup 会在Claude插件数据目录下创建隔离的Python虚拟环境，并安装Playwright Chromium用于渲染SPA页面。这步完成后环境干净可用，不会污染全局Python。
安装完运行 /seo doctor 检查状态，看到类似输出说明一切就绪：
[✓] Python venv ready
[✓] Playwright Chromium installed
[✓] All 25 sub-skills loaded
[✓] 18 specialist agents available为什么不推荐 curl | bash 直接执行？Claude Code安全机制会将这种供应链风险行为标记。git clone 能让你先检查脚本内容再决定是否执行，更透明安全。
跑一次全站审计
环境就绪后，输入：
bash
/seo audit https://developer.mozilla.org这一步触发全站点并行审计，orchestrator同时派出最多15个specialist agent分别检查：
- 技术SEO（Core Web Vitals、canonical、robots、sitemap）
- 页面内容与E-E-A-T质量
- Schema.org结构化数据完整度
- AI搜索可见性（GEO）
- 本地SEO、电商SEO等维度
通常10~15分钟出结果。每个agent只负责一个切面，互不阻塞，所以比商业工具快。
审计完成后输出一份 Markdown格式的审计报告，关键区块包括：
| 区块 | 说明 |
|---|---|
| Summary | 整体分数（0-100）、关键发现数量 |
| Technical SEO | Core Web Vitals、canonical、robots、sitemap |
| Content / E-E-A-T | 内容质量评分、作者信息、引用来源 |
| Schema Markup | JSON-LD检测、缺失/废弃类型提醒 |
| AI Search Readiness | 段落可引用性评分、llms.txt检查结果 |
| Action Plan | 按优先级排列的修复清单，附带「怎么知道修复没生效」的验证方法 |
Action Plan 最实用——每条建议不是模糊的「优化meta描述」，而是像这样：
Critical: 3 pages missing canonical tags → redirect chain could dilute link equity.
How would we know this failed? Check GSC Coverage report for duplicate canonical warnings within 7 days.
Leading indicator: Canonical coverage ratio should reach 95%+.
这就是作者设计的 "falsifiable" 理念：每条建议带验证方法和前瞻指标，照做了就知道有没有效果。
按需深入：单页、Schema、AI搜索
全站审计给大局观，日常工作中你可能只想看具体页面或某个维度。
单页深度分析
bash
/seo page https://developer.mozilla.org/en-US/docs/Web/HTTP适合改完页面后立刻复查。检查单个页面的on-page元素、内容质量、结构化数据、内部链接密度，比整站跑一遍快得多。
Schema标记审计
bash
/seo schema https://developer.mozilla.org/en-US/docs/Web/HTTP输出包括：检测到的JSON-LD区块数量、各类型Schema属性完整性、已废弃类型提醒。很多站点的schema是几年前写的，Google已经退役了某些类型但没人更新，审计一跑就能看到。
AI搜索可见性检查
bash
/seo geo https://developer.mozilla.org/en-US/docs/Web/HTTP这是个亮点功能，会做几件事：
- 计算每个段落的可引用性分数（citability score）
- 检查基于提问的标题层级结构
- 检测维基百科、Reddit、YouTube、LinkedIn等外部实体关联度
- 明确辟谣：
llms.txt目前并非引用杠杆（Google已证实忽略该文件）、不需要专门做内容分块、不需要重写关键词
常见问题
Q：SPA（Next.js / React）站点审计结果准吗？
准。v2版本引入Playwright Chromium的headless渲染器，会自动检测SPA特征（如空的 <div id="root"> shell）并切换到渲染模式。极少数场景（滚动驱动hydration或用户交互后才加载内容）可能产生噪声，建议对比 seo-visual 的Playwright截图做交叉验证。
Q：跑 /seo audit 卡住了怎么办？
先跑 /seo doctor 确认环境状态。最常见原因是Playwright Chromium未正确安装，重新运行 /seo setup 即可。仍有问题可查看 docs/TROUBLESHOOTING.md。
Q：审计结果能导出吗？
默认输出Markdown到本地文件（如 FULL-AUDIT-REPORT.md、SCHEMA-REPORT.md）。接入Google API后可生成PDF。所有文件都在本地，不上传任何第三方服务器。
小结
这篇教程带你跑通了在Claude Code中安装claude-seo、用 /seo audit 跑全站并行审计、用 /seo page、/seo schema、/seo geo 按需深入。如果你手头有任何正在运营的站点——公司官网、个人博客、SaaS Landing Page——现在就可以打开Claude Code试跑一次。10分钟后拿到的不再是模糊的「SEO需要优化」结论，而是一份按优先级排列、每条附验证方法的可执行行动清单。