[Github] Claude SEO – 在 Claude Code 中完成 SEO 与 AI 搜索审计

Claude SEO（claude-seo）是一款开源的 Claude Code 插件：输入网站或页面地址，它会围绕技术 SEO、内容、结构化数据和 AI 搜索可访问性展开检查，再把发现整理成有优先级的修复计划。它适合已经在用 Claude Code、希望把网站检查和后续修改放进同一工作环境的站长与 SEO 团队。插件采用 MIT 许可证，使用时仍需承担 Claude Code 的用量。

把问题排成修复顺序

网站检查的难处，往往出现在拿到报告以后：标题要改、图片太大、结构化数据缺字段，究竟先处理哪一项？Claude SEO 把检查拆给不同的专长代理，分别查看抓取与索引、内容质量、Schema、性能和 AI 搜索，再汇总问题、依据与处理顺序。它也会识别 SaaS、本地服务、电商、出版内容等业务类型，调整检查重点。

全站审计会输出完整报告、按严重程度排列的行动清单和各专项发现。拿到这些文件后，你可以继续追问某个问题影响哪些页面、该改模板还是单篇内容，以及修改后怎样复查。网站检查由此接上了后续维护工作。

以商品页为例，页面文字、商品结构化数据和图片需要对得上；对文章站，正文能否被抓取、页面之间有没有合理内链，则是另一组问题。Claude SEO 的价值在于把这些关系放在一起分析。报告里的健康分是项目自定规则汇总的结果，不能当成 Google 对网站的评分。

先装好运行环境

截至 2026 年 10 月 24 日核验，最新公开 Release 为 v2.5.0，发布于 10 月 22 日；仓库最近一次提交也在当日。当前版本要求 Python 3.11–3.14，并已安装、配置好 Claude Code。插件安装路径要求 Claude Code 1.0.33 或更高版本。看到旧教程写 Python 3.10+ 时，要按当前要求准备环境。

在 Claude Code 会话里依次运行下面三条命令。它们是插件命令，不是直接粘进 PowerShell 或 Bash 的系统命令：

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

前两条添加公开插件市场并安装插件；/seo setup 再建立隔离的 Python 运行环境、准备 Chromium 浏览器。安装插件本身不会自动完成依赖配置，因此不要漏掉最后一步。随后运行：

/seo doctor
/seo

/seo doctor 用于只读检查运行环境，/seo 则展示可用入口。确认运行环境就绪、命令能被识别后，再提交目标网址。Chromium 用于 JavaScript 页面渲染和截图；如果浏览器依赖没有准备好，原始 HTML 分析仍可能可用，但不能据此认定已经看到了页面渲染后的全部内容。

Windows、macOS 和 Linux 另有手动安装说明；第一次使用优先沿用上面的插件路径，较容易分清插件安装与运行环境配置各自在哪一步。如果插件装好后没有入口，可继续查看站内的Claude Code Skill 不显示或不自动触发排错。

从一个页面开始

第一次接触时，可以先把自己网站上一条公开页面的完整地址交给 /seo page。它检查页面标题、摘要、标题层级、canonical、robots、结构化数据和图片等项目，输出页面评分、问题列表与修改建议。先用单页判断报告是否抓住了真实问题，也方便控制 Claude 用量。

下面沿用官方文档的示例域名说明命令格式，使用时换成自己的实际网址：

/seo page https://example.com/pricing

不同范围有各自入口，不必每次都跑全站：

需要扩大到整个网站时，运行 /seo audit https://example.com。审计会按站点情况组织专项检查；部分代理依赖业务类型、已有基线或外部 API 凭据，并非每次都把所有代理启动一遍。当前全站审计说明把抓取上限设为 500 页，并要求遵守 robots.txt，因此大型网站不能仅凭一次报告就认为全站已经覆盖。

全站审计结束后，重点找工作目录中的 {domain}-audit/ 文件夹：

• FULL-AUDIT-REPORT.md：查看全貌、检查结论和各类问题。
• ACTION-PLAN.md：按 Critical、High、Medium、Low 查看处理顺序。
• findings/：回查技术、内容、Schema、性能等专项依据。
• audit-data.json：保存结构化审计数据，可用于后续报告生成。

判断一次检查有没有完成，先看报告覆盖了哪些 URL、哪些检查没有取到数据，再从高优先级问题里抽一项回到原页面核对。例如报告指向错误 canonical，就核对页面实际输出的 canonical 与应当保留的地址；修正后重跑对应检查，确认该项发现消失或已有明确解释。单纯把总分提高几分，无法说明问题真的解决了。

GEO 分数该怎么看

/seo geo 把 AI 爬虫访问、内容是否容易被引用、品牌提及等线索纳入检查；项目另有 /seo agentic，关注 AI 代理访问和使用网站的条件。这些入口适合帮助发现访问阻碍、表达不清和机器读取方面的问题。

但工具给出的“可引用性”或“就绪度”评分，只能作为排查线索，不能证明某个 AI 系统一定会引用该页。Google 对 AI Overviews 与 AI Mode 的说明仍强调基础 SEO：页面需可索引、可展示摘要，内容有帮助，结构化数据与可见正文一致；不要求额外的 AI 文本文件或专用 Schema。因此，不宜把缺少 llms.txt 单独理解为无法进入 Google AI 搜索的原因。

同样要分清页面线索和实际数据。HTML 可以暴露大图、缺少尺寸属性等潜在性能问题，却测不出真实用户的 Core Web Vitals，也无法独立确认 Google 当前是否收录某页。需要这类证据时，可通过 /seo google setup 配置相应 Google API；CrUX、Search Console、GA4 等数据还取决于对应服务的配置和访问权限。

对批量生成页面的网站，报告中的标题长度、内容篇幅或可读性规则也要结合页面语言与用途判断。它们能提示问题，不能代替对搜索意图和内容质量的阅读。无需为了消除每条提示，把本来清楚的文章改成同一种模板。

免费和本地各指什么

Claude SEO 的公开版本采用 MIT 许可证，没有插件自身按站点收费的门槛；但 Claude Code 的订阅额度或 API 用量、可选外部服务费用仍需单独考虑。全站检查涉及多代理调用，通常会比单页分析消耗更多模型用量。README 中的“10–15 分钟”是项目方对审计耗时的描述，本文未运行完整审计，不能把它作为不同网站都能达到的时间保证。

报告和运行环境保存在本机，也不代表整个分析过程离线。项目 README 明确说明，交给 Claude Code 分析的页面和数据会发送给 Anthropic 的 Claude 模型；启用第三方扩展或 API 后，还会发生对应服务的数据传输。处理客户网站或非公开材料时，需要先确认这些材料允许进入所选模型与服务。

如果你已经在用 Claude Code 维护网站，Claude SEO 可以把专项检查、报告文件和围绕证据的追问接在一起。若任务主要是大规模 URL 抓取、完整外链数据库或长期排名跟踪，仍需配合专门的数据工具；Claude SEO 更适合承担分析和安排修复的那一段工作。

项目入口

• GitHub 仓库：AgriciDaniel/claude-seo
• 安装说明：INSTALLATION.md
• 版本发布：Releases
• Google AI 搜索说明：https://developers.google.com/search/docs/appearance/ai-features