📚 商业营销 进阶 📦

claude-seo

面向 Claude Code 的 SEO 插件：26 个子技能、19 个子代理、34 条 /seo 命令，把技术 SEO、E-E-A-T、Schema 与 AI 搜索检查做成可归档报告；MIT，默认本地运行。

8.3 /10 ★★★★☆
#开源免费#Agent Skills#SEO#合集

📊 评分明细

📦 打包完整度
2.1 2.1 / 2.5
🎯 实用性
2.1 2.1 / 2.5
📖 文档清晰度
1.7 1.7 / 2
👥 社区影响力
1.2 1.2 / 1.5
🔗 集成度
1.2 1.2 / 1.5

🎯 适用场景

开源免费Agent SkillsSEO合集

claude-seo 快速入门：先让审核有证据，再谈排名

这是什么？适合谁？

claude-seo 是一个面向 Claude Code 的开源 SEO 插件（MIT）。它把原本要靠人逐个工具点开的 SEO 检查，组织成 /seo 命令加一批并行子代理：技术 SEO、内容质量（E-E-A-T）、Schema 结构化数据、AI 搜索（GEO）、本地 SEO、电商与国际 SEO 都在同一套入口下。

它的产出不是「优化建议列表」，而是一份带优先级的 Markdown 报告：每条建议都要求说清依据、依赖关系，以及「怎么判断这条建议失败了」。这一点是它相对商业 SEO 工具最不一样的取舍——把可证伪写进报告结构。

适合谁：手上有多个站点、需要周期性复核的 SEO 从业者；需要在开会前拿一份有证据的体检报告的站长；以及愿意读命令输出、自己能判断优先级的开发者。不适合指望「一键把排名做上去」的人：它是审核工具，不是流量保证。

与 Screaming Frog 这类爬虫工具相比，它的差异在「要不要模型参与判断」——爬虫负责抓全量事实，claude-seo 负责组织检查项与解释；与商业 SaaS 审核平台相比，它的差异在数据去向——默认本地运行，报告留在你的机器上。

核验日期：2026-10-22。依据官方仓库 README、官方站点、GitHub API。

准备工作

  • Claude Code CLI（插件安装方式要求较新版本，官方 README 标注 1.0.33+）。
  • Python 3.10 或以上；官方建议新装环境用 3.11+（Python 3.10 于 2026 年 10 月结束支持）。
  • 一个要审核的站点，最好是你自己有权抓取的站点。
  • 可选：Playwright Chromium（官方安装脚本会询问，用于 SPA 渲染与截图）。
  • 可选：Google API 凭据（PageSpeed / CrUX / Search Console / GA4），决定你拿到的是实验室数据还是真实用户数据。
  • 时间：装完到第一份 /seo audit 报告，按 20–30 分钟预留；首次全站审核本身官方给的量级是 10–15 分钟，实际取决于站点规模与模型额度。

费用要注意：工具本身 MIT 免费，但运行在 Claude Code 上，会消耗你的订阅/API 额度。官方说明有 5 个判断型子代理（内容、GEO、SXO、关键词聚类、漂移监测）跑在 Opus 上，其余 13 个跑在 Sonnet，所以一次全站审核比早期版本更贵。

三步快速上手

第一步：安装插件（推荐路径）

在 Claude Code 中执行：

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

/seo setup 会在 Claude 的插件数据目录里建一个隔离的 Python 环境并安装 Playwright Chromium，不会往系统环境装包，也不改 PATH。装完用下面这条随时检查状态：

/seo doctor

预期结果：/seo doctor 报告运行时就绪，没有缺依赖项。如果这一步不过，后面的命令都会失败，先解决它。

第二步：手动安装（插件市场不可用时）

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

Windows PowerShell：

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

官方明确建议用 git clone 而不是 irm | iex：先让安装脚本落到本地、自己看一眼再执行，避免「下载即运行」的供应链风险。

第三步：跑第一次全站审核

claude
/seo audit https://your-site.com

预期结果：终端里能看到并行子代理展开，最后产出一份 Markdown 报告，包含一个 0–100 的健康分、按优先级排列的问题、每条的判断依据与验证方式。

先把这份报告当「检查清单」读，而不是当结论：健康分是官方定义的启发式分诊分数（triage heuristic），不是 Google 的官方指标，也不是排名预测。

如果你只想先看一个页面，用 /seo page https://your-site.com/about；想单看结构化数据，用 /seo schema <url>。

常见踩坑

以下是依据官方 README、命令说明与限制章节整理的排查路径，不是本站故障复现实录。

踩坑 1：装完了，但 /seo 命令不存在

  • 症状：Claude Code 里输入 /seo 没有任何补全或提示未知命令。
  • 原因：插件装了但没启用，或安装源写错（社区版与企业版的 marketplace 名不同）。
  • 排查：先跑 /plugin 看插件是否在已启用列表；确认 marketplace 用 AgriciDaniel/claude-seo，插件标识是 claude-seo@agricidaniel-claude-seo。

踩坑 2：/seo doctor 报运行时未就绪

  • 症状：命令能进，但每个审核都中途失败，提示缺 Python 包或浏览器。
  • 原因：隔离环境没建好，或 Playwright Chromium 在安装时被跳过。
  • 排查：重新跑 /seo setup；需要 SPA 渲染时务必装上 Chromium。官方说明该环境不改系统 Python，所以不要用「全局 pip 装一个」来绕过。

踩坑 3：SPA 站点审出一堆空页面问题

  • 症状：Next.js / React 站点报告大量「内容为空」「缺 H1」。
  • 原因：客户端渲染页面在抓取时拿到空壳；官方渲染器能自动识别空 div#root 并切 Playwright，但依赖滚动或交互才加载的内容仍会漏。
  • 排查：先确认是渲染问题还是真实问题——用浏览器打开同一 URL 对比；必要时单独触发视觉子代理，把 Playwright 快照与原始 HTML 的结论对照着看。官方在限制章节里明确列出这类边界。

踩坑 4：Core Web Vitals 全是「实验室估算」

  • 症状：报告给了 LCP/INP/CLS 分数，但没有真实用户数据。
  • 原因：免费档默认不发第三方请求，没有 CrUX 凭据时只能用 Lighthouse 实验室数据。
  • 排查：按官方四级凭据体系补：Tier 0 一个 API Key 就能拿到 PageSpeed Insights 与 CrUX（含 25 周历史）；要 Search Console 与 Indexing API 再加 OAuth 或服务账号；GA4 与 Keyword Planner 再往上加。凭据存放在 ~/.config/claude-seo/，权限 0600。

踩坑 5：把 0–100 健康分当 Google 评分

  • 症状：把分数发给客户或老板，被追问「Google 官方多少分」。
  • 原因：该分数是工具自己的加权启发式，用来排序问题优先级。
  • 排查：对外只讲「问题清单 + 证据 + 验证方式」，分数标注为工具内部指标；官方 README 也在功能说明中写明了这一点。

踩坑 6：一次全站审核把额度烧掉

  • 症状：审核跑很久，或中途因额度/轮次上限停下。
  • 原因：全站审核最多并行 17 个子代理，其中 5 个跑在 Opus 上，站点越大消耗越高。
  • 排查：先用 /seo page 或 /seo technical 验证流程与产出质量，再跑全站；把审核频率按周而不是按天安排。

踩坑 7：装了扩展就以为有数据

  • 症状：SE Ranking、Profound、Bing 等扩展命令报未配置。
  • 原因：扩展是可选 MCP 服务，各自需要账号与密钥，核心插件不含这些数据。
  • 排查：按 extensions/<name>/docs/ 的说明逐个配置；没配就从报告里剔除对应章节，不要把「未取到数据」读成「没有问题」。

初级用法

1. 用 /seo page 做单页体检

针对落地页、产品页这类关键单页跑一次，重点看标题层级、可索引性、结构化数据与内容质量四项。单页审核成本低，适合改动后立即复跑。

2. 用 /seo schema 修结构化数据

它会检测现有 JSON-LD、按 Google 现行规则校验、再生成缺失的类型。注意官方对已退役类型的处理：HowTo 的富媒体结果 2023 年 9 月已移除，FAQPage 的富媒体结果在 2026 年 5 月停止对所有站点展示——这类标记留着不产生富媒体收益，报告会给出替换建议。

3. 用 /seo geo 检查 AI 搜索可引用性

按官方对齐的 Google AI 优化指南，检查段落是否自足、问答式标题层级、归因密度与结构化数据覆盖。它同时反驳了几个流行说法（例如 llms.txt 目前不是引用杠杆），报告里给的是带出处的判断，不是营销话术。

高级玩法

1. 用 /seo drift 做回归监测

先 baseline 存一次快照，之后 compare 对比，history 看趋势（本地 SQLite）。这是把「季度大审」变成「每周看变化」的关键：客户沟通从「看这张快照」变成「这周变了什么」。

2. 用 /seo agentic 检查 Agent 可读性

按 Lighthouse 的 Agentic Browsing 类别计分，同时检查 AI 爬虫可达性、llms.txt、Markdown 交付、ai-catalog.json 与 WebMCP。站点要进入 AI 助手的分发链路时，这一项比传统 SEO 指标更直接。

3. 用 /seo google 生成带图表的 PDF 报告

配置好凭据后可以把 Search Console 与 Core Web Vitals 数据做成 A4 版式 PDF（官方用 WeasyPrint 与 matplotlib 出图）。对外交付时比截图更规范，也便于留档对比。

小技巧

  • 先 /seo doctor 再 /seo audit，把环境问题挡在审核之前。
  • 审核对象用测试环境或自己有权限的站点，避免对第三方站点做高频抓取。
  • 报告里每条建议都找「怎么判断这条失败了」，只保留能验证的项，其余的降级为待观察。
  • 凭据只放 ~/.config/claude-seo/，不要写进仓库或提示词里。
  • 站点规模大时先跑 /seo sitemap 看结构，再决定 audit 的范围。

常见问题 FAQ

Q1：它是免费的么？

A：插件本身 MIT 免费。但它在 Claude Code 里跑，会消耗你的 Claude 订阅或 API 额度；扩展需要各自的账号。代码免费不等于运行零成本。

Q2：和 Screaming Frog 这类爬虫是替代关系吗？

A：不是。爬虫负责抓全量事实（状态码、标题、链接图），claude-seo 负责组织检查项、按证据给优先级、写报告。两者可以一起用：爬虫出事实，它出判断。

Q3：没有 Google API 凭据能用吗？

A：能。免费档默认不调用第三方 API，产出的是基于页面本身的检查与实验室指标。要真实用户数据（CrUX）与索引状态，再按四级凭据体系加。

Q4：报告里的分数能对外报吗？

A：可以报，但要写清是工具内部启发式分数，不是 Google 指标。对外更有说服力的是问题清单、证据链接与验证方式。

Q5：支持中文站点吗？

A：命令不限制语言，检查项对中文站点同样适用。实际输出语言受模型与提示词影响；中文站点的 E-E-A-T 判断建议人工复核，尤其涉及资质与作者身份时。

Q6：多久跑一次合适？

A：官方给的场景是「周更审核 + 变化对比」。小站每月一次全站 audit、关键页改动后跑 /seo page 更实际；高频跑全站主要是烧额度。

进阶学习：从一次审核到可持续的 SEO 流程

按能力链推进，比按时段安排更有效：

  1. /seo doctor + /seo page：先把单页审核跑稳，学会读报告里的证据段。
  2. /seo technical：按 9 个技术类别（可爬取、可索引、安全、URL 结构、移动、Core Web Vitals、结构化数据、JS 渲染、IndexNow）逐项对齐自己的站点。
  3. /seo schema：对照 skills/seo/references/schema-types.md 处理已退役类型，别在无收益的标记上花时间。
  4. /seo drift baseline → compare：建立可回归的基线，这是把审核变成流程的分界线。
  5. /seo geo 跑通后，再读 skills/seo-geo/references/llmstxt-evidence.md，理解为什么「加个 llms.txt」不是引用杠杆。
  6. 扩展按需接：SE Ranking 看 AI Share-of-Voice、Profound 看 LLM 引用时间序列、Unlighthouse 做多页 Lighthouse；没账号就先跳过。
  7. 想改判定逻辑，直接读 SKILL.md 与 docs/COMMANDS.md——它是本地文件，MIT 允许你按自己的标准调整。

使用边界与声明

本文基于官方文档和公开资料整理，AI 辅助生成，MagicNetWorld 尚未完成独立实测。安装步骤、命令清单与限制说明来自官方 README；星级、fork、开放事项数与推送时间为 2026-10-22 通过 GitHub API 读取的快照（官方站点页脚标注的 17.5K 星星是 2026-09-24 的旧快照，以 API 现读为准）。本站未运行该插件，未验证任何站点的排名变化；报告质量与模型额度、站点结构强相关。

参考链接

📊 评分与标签

核验口径：已按现行口径通过，待按新证据契约复核

评分说明

总分 8.3/10 · P_优选

核验日期：2026-10-22。按 Agent Skill 的可安装性、实用性、文档、社区与兼容性评价，不把作者公布的流量增长案例当作本站复现结果。采集阶段的百分制不是本评分的换算来源。评分依据可追溯至公开来源。

📊 可观测社区指标（采集日期：2026-10-22）

  • GitHub 公开 API：19,567 stars、2,844 forks，41 个开放事项（含 PR）。
  • pushed_at 为 2026-10-21T20:34:20Z，即北京时间 2026-10-22 04:34；不触发长期未更新提示。
  • 许可 MIT；官方 README 记录的版本为 v2.4.2（2026 年 10 月）。官方站点页脚标注的 17.5K 星星是 2026-09-24 的快照，本文以 API 现读为准。

📦 可安装性 2.0/2.5

  • Claude Code 内两条命令即可装：/plugin marketplace add AgriciDaniel/claude-seo + /plugin install claude-seo@agricidaniel-claude-seo，随后 /seo setup 建隔离运行时；官方另给 macOS/Linux 与 Windows 的手动安装脚本。来源：安装章节。
  • 门槛清晰但非零：需要 Claude Code CLI（插件路径标注 1.0.33+）与 Python 3.10+，SPA 渲染还需 Playwright Chromium；官方建议新环境用 3.11+。来源：Requirements。
  • 竞品对比 1（Screaming Frog SEO Spider）：桌面安装包，双击即可爬站；claude-seo 的安装面更轻，但依赖宿主 Agent 与 Python 运行时。来源：Screaming Frog。
  • 竞品对比 2（Semrush Site Audit）：纯 SaaS，注册即用、无需本地环境；claude-seo 省掉了订阅门槛，换来了本地依赖维护。来源：Semrush。

🎯 实用性 2.2/2.5

  • 34 条 /seo 命令覆盖全站审核、单页分析、技术 SEO、内容质量、Schema、GEO、本地 SEO、回链与漂移监测，产出的是可归档的 Markdown/PDF/JSON 报告，而不是只能在线看的看板。来源：命令表。
  • 报告结构要求每条建议带「依据 + 依赖 + 如何判断失败」，这种可证伪的写法在实际交付中比分数更有用；但审核效果仍取决于模型判断，本站未验证其检出准确率。来源：Methodology。
  • 竞品对比 1（Screaming Frog）：爬虫强在事实采集的完整性（状态码、标题、链接图），claude-seo 强在组织检查项与解释；两者互补而非替代。来源：Screaming Frog。
  • 竞品对比 2（Ahrefs Site Audit）：商业工具的外链与索引数据是自有数据库，claude-seo 无凭据时只看页面本身；数据深度不同，不能按功能名对齐。来源：Ahrefs。

📖 文档质量 1.8/2.0

  • README 体量接近一份产品文档：安装、命令、功能、方法论、限制、需求、卸载、扩展与 FAQ 齐全，另有 docs/COMMANDS.md 做逐命令参考。来源：官方 README。
  • 难得的是把边界写在明面上：明确 0–100 健康分是启发式分诊分、明确 SPA 水合的漏检场景、明确免费档只用实验室数据。少量扣分来自信息重复（首页与站点对子技能数量的表述不完全一致）。来源：Limitations。
  • 竞品对比 1（Semrush）：商业工具的帮助中心与学院体系更完整；claude-seo 的优势是把判定逻辑摊开成可读文件。来源：Semrush。
  • 竞品对比 2（Anthropic Skills 官方示例）：官方示例更适合学习技能结构；claude-seo 是一套完整业务实现，阅读成本更高但可直接用。来源：Anthropic Skills。

👥 社区活跃 1.4/1.5

  • 19,567 stars、2,844 forks，pushed_at 距核验不足一天；README 的更新日志从 v2.1.0 一路记到 v2.4.2，说明仍在持续维护。来源：GitHub API、更新日志。
  • 41 个开放事项（含 PR）数量不高，但本站未统计响应时长与合并速度，不作 SLA 推断。
  • 竞品对比 1（Screaming Frog）：商业产品有正式支持渠道；claude-seo 是个人主导的开源项目，求助靠 issue。来源：Screaming Frog。
  • 竞品对比 2（Semrush）：企业级支持与培训是订阅的一部分；开源项目的支持强度不能按同一标准衡量。来源：Semrush。

🔗 兼容性 0.9/1.5

  • 明确面向 Claude Code：插件形式、/seo 命令、子代理与 Opus/Sonnet 模型分工都绑定该宿主；官方另有一个需要会员权限的社区镜像。来源：官方 README。
  • 操作系统覆盖 macOS、Linux、Windows（含 PowerShell 安装脚本），这一点是加分项；但换到其它编码助手或自建流程时，命令与子代理机制不可直接迁移。来源：安装章节。
  • 竞品对比 1（Screaming Frog）：跨平台桌面软件，与编辑器无关；claude-seo 与宿主 Agent 强绑定。来源：Screaming Frog。
  • 竞品对比 2（Semrush）：浏览器即用，不依赖本地运行时；claude-seo 的本地化是隐私优势，也是兼容性成本。来源：Semrush。

评分依据可追溯至公开来源；分数为基于能力与限制的编辑判断，不是实测审核准确率、排名效果或安全认证。

标签说明

  • 开源免费：MIT 许可；运行消耗 Claude Code 订阅/API 额度，扩展需各自账号。来源：LICENSE。
  • Agent Skills：以 Claude Code 插件与子技能形式组织的可加载技能集。来源：官方 README。
  • SEO：核心用途是技术 SEO、内容质量、结构化数据与 AI 搜索可引用性审核。来源：功能章节。
  • 合集：包含 26 个子技能、19 个子代理与 34 条命令，不是单一技能。来源：官方 README。

局限与声明

本文基于公开资料整理，未安装插件、未运行审核、未验证任何站点的排名或流量变化，也未做安全审计。作者公布的三个月增长图为作者自述，不能当作工具效果证明。报告质量与模型额度、站点结构、凭据配置强相关。

来源核实