Agentic-SEO-Skill

1. 基本信息

项目	内容
名称	Agentic-SEO-Skill
作者/维护者	Bhanunamikaze（个人开发者，独立维护，接受社区 PR）
来源链接	https://github.com/Bhanunamikaze/Agentic-SEO-Skill
许可证	MIT（来自 GitHub API）
GitHub Stars	784（来自 GitHub API）
Forks	128（来自 GitHub API）
最新版本	v3.0.1（2026-05-14 发布，来自 GitHub Releases）
安装方式	一条命令在线安装脚本，或 `git clone` + `install.sh`，支持按 IDE 分别指定安装目标

2. 功能介绍与亮点

面向网站、博客与 GitHub 仓库的开源 SEO 分析技能，以 seo 系列指令编排 16 个专项子技能与 10 个专项子代理，覆盖技术 SEO、内容质量（E-E-A-T）、Schema.org 结构化数据、站点地图、图片优化、AI 搜索优化（GEO/AEO）、多语言 hreflang、竞品对比页生成，以及 GitHub 仓库自身的可发现性审计。

核心亮点：

原生多工具适配：不是“通用文档改改路径”式兼容，而是为 Claude Code、Codex CLI、Antigravity IDE、Claude Cowork、Cursor、Windsurf、Continue.dev、GitHub Copilot、Cline 九种工具分别生成各自原生的技能/规则文件格式
零门槛起步：核心审计功能无需任何 API Key 即可运行，PageSpeed、Google Search Console、Knowledge Graph 等外部数据源均为可选增强，缺失时自动降级并给出提示
网络请求做了正经的安全加固：内置 safe_http 公共模块，对目标 URL 做协议校验与私有/回环/内网 IP 拦截，限制最大重定向次数与响应体大小
有真实第三方在用：GitHub Issues 中有外部用户提交的具体技术缺陷报告（如 readability.py 段落计数逻辑问题），并有多名非作者贡献者提交过合并请求

3. 适用场景

所属分类：内容创作与知识管理

面向使用 Claude Code、Codex 等 AI 编程工具管理网站或博客内容的独立站长、SEO 从业者与内容团队：在内容发布前或定期复盘时，用一条指令跑通站点技术健康度、内容质量与结构化数据审计，产出结构化的问题清单与优先级修复方案，替代人工逐项排查。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——README 明确列出 ~/.claude/skills/seo 安装路径，install.sh --target claude 一条命令安装
Codex：✅ 原生支持——同一仓库直接提供 ~/.codex/skills/seo 安装路径与 --target codex 选项，无需额外的移植仓库
OpenClaw：❓ 未验证——README 兼容性列表未提及，仅依据已抓取材料判断，未为此单独发起搜索
Hermes Agent：❓ 未验证——同上

5. 推荐理由

开源免费的 SEO 审计技能，16 个子技能零 API Key 即可用，且是少数把 Claude Code 与 Codex 都做成一等公民支持（而非其中一个靠独立移植仓库）的同类技能，另外还原生适配 Cursor、Windsurf 等主流 AI 编程工具。

6. 评分

维度	分数	说明
受欢迎程度	7	GitHub 784 stars、128 forks；GitHub Issues/PR 记录显示至少 3 个独立外部账号有实际互动——具名用户提交过带复现步骤的技术缺陷报告，另有多名非作者贡献者提交过合并请求
可用性	9	一条命令在线安装，支持 9 种 IDE/Agent 工具并各自生成原生格式文件；核心功能零配置可用，CI 对脚本清单与参考文档新鲜度做自动校验；最近一次提交为 2026-07-17，维护活跃
安全性	8	见下方安全检查清单
综合	8.0	三项均值

安全检查清单：

检查项	结果
① Shell 命令及权限范围	安装脚本仅在本地复制文件到各 IDE 的技能目录，不需要提权；审计脚本为纯 Python，执行范围明确限定于抓取用户指定的目标网址
② 运行时联网外发	按设计需要联网抓取被审计的目标站点，属功能本身；`safe_http.py` 模块对 URL 做协议白名单校验，并解析域名拒绝私有/回环/内网/链路本地地址，防止把审计功能滥用为内网探测通道
③ API Key / 凭据	全部可选（PageSpeed、Knowledge Graph、GitHub Token、Search Console），存放于本地 `.env` 文件（已加入 `.gitignore`），文档逐项说明每个凭据的获取渠道与最小权限范围（GitHub Token 建议只读）
④ 可疑指令（注入迹象）	通读 SKILL.md 编排逻辑与安装脚本未发现注入或隐蔽外发迹象
⑤ 作者/组织信誉	个人开发者独立维护，65 次提交均为可读的功能性说明；未发现刷星迹象——fork 数与 issue/PR 互动量同步增长，无“仓库首页 SEO 操纵”式提交记录
⑥ License 是否明确	明确，MIT
⑦ 最近维护时间	活跃，最近一次提交距今约 6 天；有 Dependabot 自动维护依赖版本

7. 跟同类 Skills 相比的优势

Skill / 工具	定位	与本技能的差异
claude-seo（同类头部竞品）	开源网站 SEO 审计插件，25 个子技能，专为 Claude Code 打造	星标基数远高于本技能，但官方明确不直接支持 Codex（需切换到作者另建的 codex-seo 移植仓库）；本技能把 Claude Code 与 Codex 做成同一仓库内的一等公民，并额外覆盖 Cursor、Windsurf、Continue.dev 等 7 种工具
guizang-social-card-skill	小红书/公众号图文卡片生成	面向社交媒体视觉内容生产，不做搜索引擎技术审计，与本技能场景互补而非重叠
Screaming Frog / Ahrefs Site Audit（业界知名商业竞品）	商业 SEO 爬虫与审计 SaaS	链接图谱抓取规模更大，但按月/按域名付费；本技能开源免费、无使用量限制，适合个人站长与小团队日常复盘

8. 用户评价

该技能目前在 GitHub Issues 中可查到具名用户的真实技术反馈：

来源：GitHub Issues #21，用户 db88-create 提交的缺陷报告——指出 readability.py 在 HTML 段落用单换行分隔时会把多个 <p> 标签误判为同一段落，并给出具体的可复现案例（14 个 <p> 标签的博客文章被计为 1 段）
来源：GitHub Issues #17，用户 Roalkege 提问如何配置 PageSpeed API Key，反映出该功能在缺少密钥时会给出明确的降级提示（“Fix: 用 --api-key 重跑 pagespeed.py”）而非静默失败

9. 其他补充

README 额外提供了“建议的 GitHub 仓库描述与 Topics”模板供使用者参考，属于面向仓库维护者的常规文档惯例；仓库同时维护一份独立 Wiki，收录完整的 89 个脚本清单与安装排障指南。

10. 安装使用方式

在线一条命令（Linux/macOS）：curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online --target claude（--target 可换成 codex、cursor、global、all 等）
在线一条命令（Windows PowerShell 7+）：先 irm .../install.ps1 -OutFile install.ps1，再 powershell -ExecutionPolicy Bypass -File .\install.ps1 --online --target claude
从源码安装：git clone 后执行 bash install.sh --target <工具名>，支持项目级安装（--project-dir）
触发方式：安装后在对应工具中输入 seo audit <网址>、seo technical <网址> 等指令触发对应子技能
安装后注意：无需重启；核心审计功能零配置可用，接入 Google 系数据源需自行申请 API Key 并写入本地 .env

11. 注意事项

单人维护（非机构出品），需自行评估长期维护的可持续性
OpenClaw、Hermes Agent 生态兼容性未经验证
深度依赖 Google 官方数据的功能（Core Web Vitals 精确值、Search Console 数据）在未配置对应 API Key 时会降级为提示性说明，而非报错静默跳过，使用前建议先了解哪些子技能需要额外凭据