1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | claude-seo |
| 作者/维护者 | Agrici Daniel（个人开发者，独立维护） |
| 来源链接 | https://github.com/AgriciDaniel/claude-seo |
| 许可证 | MIT（来自 GitHub API） |
| GitHub Stars | 11,499（来自 GitHub API） |
| Forks | 1,678（来自 GitHub API） |
| 最新版本 | v2.2.0（2026-06-12 发布，来自 GitHub Releases） |
| 安装方式 | Claude Code 插件市场一条命令，或 git clone + install.sh |
2. 功能介绍与亮点
面向网站的开源 SEO 分析插件，在 Claude Code 内以 /seo 系列指令编排 24 个子技能与 18 个专项子代理，并行完成技术 SEO、内容质量（E-E-A-T）、Schema.org 结构化数据、AI 搜索优化（GEO/AEO）、本地 SEO、电商与多语言 SEO 审计。
核心亮点：
- 零门槛可用：无需任何 API Key 即可跑满全部 25 个子技能，四级凭据体系让 Google 官方数据（PageSpeed、Search Console、GA4）按需渐进解锁
- 可证伪的建议：每条推荐都附带“依据的第一性原理”“依赖关系”“如何验证失败”“领先指标”四项，不是笼统的“建议优化标题”
- SPA 原生支持：v2 内置 Playwright 无头渲染，自动识别 Next.js/React/Vue 等前端框架的空壳 DOM 并切换渲染模式
- 安全工程扎实：针对“审计目标恶意反打”场景做了 SSRF/DNS 重绑定专项防护，83 个相关回归测试，合并前强制 8 维安全审查
3. 适用场景
所属分类：内容创作与知识管理
面向用 Claude Code 管理网站或博客内容的独立站长、SEO 从业者与内容团队，在发布前或季度复盘时一条指令生成结构化审计报告与优先级行动清单，替代人工逐项排查或按月付费的商业审计工具。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——遵循 Agent Skills 标准，
.claude-plugin打包，/plugin marketplace add一条命令安装，README 与全部文档均以 Claude Code 为唯一目标平台 - Codex：❌ 不支持（有独立移植版）——作者另建
AgriciDaniel/codex-seo仓库做 TOML 代理与确定性运行器的 Codex 专用移植，本仓库本身不直接兼容 Codex - OpenClaw：❓ 未验证——未见官方文档或已抓取材料提及
- Hermes Agent：❓ 未验证——同上，仅依据已抓取材料判断，未为此单独发起搜索
5. 推荐理由
开源免费的网站 SEO 审计技能，25 个子技能零 API Key 即可用，把商业审计工具数百美元/月的能力和数小时人工审计压缩到一条指令、十余分钟出结构化行动清单。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 11,499 stars、1,678 forks（来自 GitHub API 实测数据）已处于同类开源 SEO 工具头部区间，且 v1.9.0 起吸纳 5 位外部贡献者持续共建，GitHub Discussions 上也有真实用户实测反馈（#40、#48） |
| 可用性 | 8 | 零 API Key 即可跑满全部 25 个子技能，插件市场一条命令安装、/seo audit <网址> 触发即用、安装后无需重启；但 Windows 平台凭据文件权限收紧为空操作需自行加固、深度动态渲染场景仍可能有噪声需人工交叉核对，故未给满分 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.3 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 执行 Python 脚本与可选 Playwright/Chromium 无头渲染，范围明确限定于抓取用户指定 URL 做审计 |
| ② 运行时联网外发 | 按设计需要联网抓取审计目标站点；作者文档公开了 SSRF 威胁模型（私有 IP、DNS 重绑定、30x 跳转到内网等 7 类攻击面），url_safety.py 统一做 DNS 锁定预检，52+ 项回归测试覆盖各绕过手法 |
| ③ API Key / 凭据 | 可选，四级递进；OAuth 令牌落盘于 ~/.config/claude-seo/，代码对每次写入强制 0o600 权限且不落盘 client_secret，凭据不进代码仓库 |
| ④ 可疑指令（注入迹象） | 通读 SKILL.md 编排逻辑与 Quick Start 未发现注入迹象；安装文档明确提醒“不要用 irm | iex，用 git clone 以便执行前先审查脚本” |
| ⑤ 作者/组织信誉 | 个人开发者独立维护（非机构出品），但设有正式安全策略（90 天协调披露）、PR 合并前 8 维安全审查 + 326 项测试门禁，工程规范度高于同规模社区项目均值 |
| ⑥ License 是否明确 | 明确，MIT |
| ⑦ 最近维护时间 | 活跃，最近一次提交 2026-07-06，距今 10 天内；依赖版本变更均标注对应 CVE 修复 |
7. 跟同类 Skills 相比的优势
| Skill / 工具 | 定位 | 与本技能的差异 |
|---|---|---|
| claude-obsidian（同作者） | Obsidian 笔记库自组织第二大脑 | 面向个人知识管理而非网站审计，与本技能场景不重叠 |
| Screaming Frog / Ahrefs Site Audit（作者自述对比的知名商业竞品） | 商业 SEO 爬虫与审计工具 | 链接图谱抓取更深更快，但按月/按域名付费、结果需人工二次解读；本技能开源免费、结论自带可证伪检验，二者可通过 MCP 扩展互补而非替代 |
| guizang-social-card-skill | 小红书/公众号图文卡片生成 | 面向社交内容视觉生产，不做搜索引擎技术审计 |
8. 用户评价
该技能目前可查到 2 条来自 GitHub Discussions 的独立用户留言：
- 来源：GitHub Discussions #40（“Can I use this for my localhost:3000”），用户 aakashpuree 实测反馈——标题/描述/内链等页面级检查可直接对本地端口生效，但 PageSpeed、Core Web Vitals 等需要 Google 服务器可达的检查项对纯本地地址无效，建议配合 ngrok 暴露公网地址
- 来源：GitHub Discussions #48（“Is llms.txt really useful?”），用户 DanielElite 评论“llms.txt 就像一块路牌——很多人觉得没用，却没人敢把它拆掉”，呼应本技能在 GEO 子技能中对 llms.txt 效力的审慎立场
9. 其他补充
作者围绕同一工作流延伸出多个姊妹项目：claude-blog（SEO 结论驱动的博客写作）、banana-claude（SEO 配图生成）、codex-seo（Codex 移植版），可与本技能组合成“审计→写作→配图”的内容生产链路；v1.9.0 起接受社区贡献，README 列出 5 位外部贡献者及其提交的子技能。
10. 安装使用方式
- 插件市场一条命令（Claude Code ≥1.0.33）：
/plugin marketplace add AgriciDaniel/claude-seo后/plugin install claude-seo@agricidaniel-claude-seo - 手动安装（macOS/Linux）：
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git后执行bash claude-seo/install.sh - 手动安装（Windows）：同样
git clone后以 PowerShell 执行install.ps1 - 触发方式：
claude启动后直接输入/seo audit <网址>等指令；首次使用 Google 数据类功能前需运行/seo google setup走凭据向导 - 安装后注意：无需重启；核心功能零配置可用，接入 Playwright 渲染或 Google/DataForSEO 等扩展需额外安装依赖或申请凭据
11. 注意事项
- 单人维护（非机构/团队出品），需自行评估长期维护的可持续性风险
- 深度动态渲染场景（滚动触发的内容、弹窗后加载的内容）仍可能产生噪声结果，官方文档建议此时交叉核对
seo-visual子代理的渲染快照 - Windows 平台上凭据文件权限收紧（
0o600）为空操作，需改用目录级 ACL 自行加固 - OpenClaw、Hermes Agent 生态兼容性未经验证；Codex 用户须改用独立的
codex-seo移植版而非本仓库