Claude SEO
把页面证据变成修复顺序
在 Claude Code 中检查单页、排查技术问题、审阅内容与结构化数据,交付有依据和复查办法的行动清单。

Claude SEO 功能演示
查看示例出处作者列出的使用环境
- Claude Code
- GitHub Star
- 24,088
- 版本
- 2.5.0
- 资料核对
- 分类
- 营销增长
先查一页,把每条结论连到证据
先确认抓到的是目标页面及其主要内容,再讨论标题、正文或标记。每条建议写清观察、依赖、修复后怎么检查,以及什么结果会推翻原判断;比一个总分更容易安排工作。
选一个任务,开始使用
安装区三条命令均在 Claude Code 会话内逐行执行。提示词中的 TARGET_URL、SITE_URL、FINAL_URL 需要替换;脚本通过插件自带启动器运行,CLAUDE_PLUGIN_ROOT 由 Claude Code 解析,不假定它已是普通终端的环境变量。
先确认采集完整度,再列出最值得处理的问题。
在 Claude Code 中安装并准备环境
三条命令在 Claude Code 会话内逐行执行。/seo setup 会下载依赖与 Chromium;随后用 /seo doctor 分别检查核心和浏览器状态。
查看作者安装说明/plugin marketplace add AgriciDaniel/claude-seo /plugin install claude-seo@agricidaniel-claude-seo /seo setup首次路径:安装 → setup → doctor → 单页证据
完成安装区三条会话命令后运行 /seo doctor。需要精确状态时,让助手使用 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" doctor --json,分别核对 ready 和 browser_ready;退出码为 0 也不能替代浏览器状态检查。若核心环境未就绪,按作者 setup 入口处理,不直接用系统 Python 绕过。建立本次审查目录,放入 brief.md 和 evidence/,再执行第一条提示词。插件安装与 /seo setup 是两个步骤;setup 会实际下载和写入运行环境。
作者安装与环境诊断说明把这段话发给 AI
以下提示词为编辑编写的任务安排,不是本站已执行的审计。首次只访问 brief.md 约定的公开目标;采集范围和是否修改文件应随任务保留。
/seo page TARGET_URL 按 brief.md 只检查这一公开页面,不扩展全站,不读取凭据或调用付费/已配置的数据扩展。读取目标、语言和页面类型;确认当前工作目录是本次审查目录,已有 evidence/。使用插件启动器,先运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run fetch_page.py "TARGET_URL" --render never --json --output evidence/page.raw.html,保存 stdout 为 evidence/page.raw.json。 检查 status_code、最终 url、error、too_large 和 output_written,并记录采集时间与重定向。命令退出正常不代表拿到了正常业务页面;错误页、登录墙或截断正文要单列。若主内容依赖 JavaScript 且 brief.md 允许渲染,在 browser_ready 为 true 时运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py "TARGET_URL" --mode always --json --output evidence/page.rendered.html,保存 stdout 为 evidence/page.rendered.json,检查 mode_used、render_engine、render_diagnostics 与实际内容。渲染会加载页面资源;超时取得的部分 DOM 不能算完整。 对保存的 HTML 运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py evidence/page.raw.html --url "FINAL_URL" --json,保存为 evidence/page.parsed.json;FINAL_URL 使用抓取后的实际地址。若有渲染文件也单独解析并比较,避免重复抓取时混入不同版本。检查标题、描述、标题层级、canonical、robots、图片和 Schema,并区分脚本提取结果与需要人工判断的内容。不要仅凭 HTML 填写真实 Core Web Vitals、Google 收录或搜索排名。 交付 PAGE-REVIEW.md 与 ACTION-PLAN.md:列出已检查/未检查范围、最多五条优先建议,每条附 URL 或原文位置、所见证据、依赖、修复后的复查方法和失败判据。有评分时解释方法和未测项,不把缺失数据算作零分。
检查你拿到的结果
- 原始响应、可用时的渲染内容,以及本地解析文件。
- 区分观察、判断和缺少数据的单页报告。
- 有证据、依赖和复查办法的优先行动清单。
进一步了解这个 Skill
Claude SEO 是 Agrici Daniel 为 Claude Code 编写的 SEO 工作流集合。Skill 负责选择检查与组织报告,本地脚本负责抓取、渲染、解析和生成文件,模型负责解释证据与提出建议。它不是拥有独立排名数据库的搜索平台,也不会因安装完成就接通所有外部数据。
它提供单页、全站、技术、内容、Schema 等不同入口。/seo page 适合先验证一页,/seo technical 聚焦抓取与实现,/seo content 评估内容是否回答用户问题,/seo schema 核对页面事实与标记。全站审计会扩大采集范围,并按业务类型、已有数据和工具选择代理。
这个项目有用的地方是要求建议附带观察依据、前后依赖、失败判据和后续指标。实际使用时应把“HTML 中发现了什么”“为什么可能有问题”“需要哪种额外数据证明”分别写出来,避免将模型判断当作搜索引擎已经给出的结论。
本页安排四条任务,从单页取证到技术排查、内容修订和结构化数据核对。作者 README 还展示了一个关于页的 Schema 报告:正文与标记中的创始人信息不一致。这个具体问题比“加了标记就更容易被引用”更容易验证。
来源与核验
资料核对
按公开提交 6be93f4 核对 29 份关键原文,并与 v2.5.0 发布提交比较;未运行作者脚本或真实审计。