Claude SEO

把页面证据变成修复顺序

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

作者 AgriciDaniel

Claude SEO 功能演示

Claude SEO 功能演示

查看示例出处

作者列出的使用环境

  • Claude Code
GitHub Star
24,088
版本
2.5.0
资料核对

先查一页,把每条结论连到证据

先确认抓到的是目标页面及其主要内容,再讨论标题、正文或标记。每条建议写清观察、依赖、修复后怎么检查,以及什么结果会推翻原判断;比一个总分更容易安排工作。

选一个任务,开始使用

安装区三条命令均在 Claude Code 会话内逐行执行。提示词中的 TARGET_URL、SITE_URL、FINAL_URL 需要替换;脚本通过插件自带启动器运行,CLAUDE_PLUGIN_ROOT 由 Claude Code 解析,不假定它已是普通终端的环境变量。

按单页证据、技术实现、内容或标记选择

先确认采集完整度,再列出最值得处理的问题。

  1. 在 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 会实际下载和写入运行环境。

    作者安装与环境诊断说明
  2. 把这段话发给 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 或原文位置、所见证据、依赖、修复后的复查方法和失败判据。有评分时解释方法和未测项,不把缺失数据算作零分。

  3. 检查你拿到的结果

    • 原始响应、可用时的渲染内容,以及本地解析文件。
    • 区分观察、判断和缺少数据的单页报告。
    • 有证据、依赖和复查办法的优先行动清单。
    查看这项任务的作者说明
进一步了解这个 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 发布提交比较;未运行作者脚本或真实审计。