EP01. "claude-seo 全站 SEO 审核插件导览"

首页 › AI 工具 › Claude · Skills · Claude SEO · EP01

约 17 分钟· #EP01#Claude#Claude SEO

🔒 登录后可标记已读

网站 SEO 健康度打几分？claude-seo 跑一次 /seo audit，15 个专家子代理并行分析，10~15 分钟出一份 0~100 分的健康分数报告，外加优先级排序好的行动清单
这是一个完整插件，不是像 wordpress-skills／elementor-skills 那种「一堆各自独立、随手挑一个用」的技能集合——它是一个 /seo 指令家族（32 个指令），内部由 25 个 sub-skill + 18 个专家 agent 协同跑，使用者只需要打指令，不用管内部怎么分工
覆盖技术 SEO、内容质量（E-E-A-T）、schema 结构化数据、AI 搜索优化（GEO，给 AI Overview 用）、本地 SEO、电商 SEO、国际化站点（hreflang）——横跨的领域比前两个 skill 包都广
另外还有 8 个官方维护的可选扩展（extensions），对接 Ahrefs、DataForSEO、Firecrawl 这类第三方 SEO 数据源
前置知识：先看过 Overview 系列，知道 Skill／Plugin 是什么

重点内容

这个插件是做什么的

claude-seo 是 MIT 授权的开源 Claude Code 插件，把「找 SEO 顾问做全站健检」这件事自动化。审核会检查：

当前的 Core Web Vitals（LCP、INP、CLS），同时用现场（field）和实验室（lab）两种数据
符合 2025 年 9 月版 Google 搜索质量评估指南的 E-E-E-T 因素（经验、专业、权威、可信）
Schema.org 结构化数据的侦测与验证
内容段落是否够「可被引用」（passage citability），决定能不能被 AI Overview 采用
本地 SEO 信号，包括 Google Business Profile 分析
国际化站点的 hreflang 标签审核

📌 这个插件强调「可证伪性」——每条建议都会附上「它依据的第一性观察」「跟其他建议的依赖关系」「怎么验证这条建议失败了」「一个领先指标」，不是丢一堆建议就算了事，这跟一般 SEO 报告只给结论、不给验证方法不一样。

核心指令速查

32 个指令按功能分组，这里只列常用的（完整清单见官方 docs/COMMANDS.md）：

核心审核与分析

指令	做什么
`/seo audit <url>`	全站审核：爬最多 500 页、判断业务类型、分派给 15 个并行专家子代理、算出 0~100 健康分数、产出带截图的完整报告
`/seo page <url>`	单页深度检查：on-page SEO、内容质量、技术项、schema、图片优化、Core Web Vitals 潜在问题
`/seo technical <url>`	技术 SEO 9 大类审核：爬取性、可索引性、安全性、URL 结构、移动端、Core Web Vitals、结构化数据、JS 渲染、IndexNow
`/seo content <url>`	E-E-A-T 信号评估，含 AI 引用就绪度、内容新鲜度

内容与关键词策略

指令	做什么
`/seo content-brief <主题或url>`	生成 SEO 内容简报：目标关键词、搜索意图、大纲、内链建议、跟竞品的差异化角度
`/seo cluster <种子关键词>`	基于 SERP 的语义主题聚类，抓关键词重叠、分类搜索意图、提出 hub-and-spoke 内容架构
`/seo sxo <url>`	Search Experience Optimization：SERP 逆向分析、页面类型错配侦测、多角色打分

技术与结构

指令	做什么
`/seo schema <url>`	侦测现有 schema、对照 Google 要求验证、找出缺漏、直接生成可用的 JSON-LD
`/seo sitemap <url>` / `/seo sitemap generate`	验证既有 sitemap 或从零生成一份新的
`/seo hreflang [url]`	国际化审核：自我引用标签、互相对应关系、x-default 有没有设
`/seo drift baseline\	compare\	history <url>`	用 17 条比对规则监控标题/描述/canonical/schema/CWV 有没有跟基准线偏移

图片、电商、本地、链接分析（各自还有更细的子指令，如 /seo backlinks gap、/seo ecommerce schema）

指令	做什么
`/seo images <url>`	alt 文字质量、文件大小、WebP/AVIF 建议、lazy loading、CLS 预防
`/seo geo <url>`	Generative Engine Optimization：内容能不能被 AI Overview 引用的各项信号
`/seo ecommerce <url>`	商品 schema、Google Shopping 能见度、缺货信号、分面导航爬虫陷阱
`/seo local <url>` / `/seo maps`	Google Business Profile、NAP 一致性、49 点地理网格排名追踪
`/seo backlinks <url>`	反链分析，三层数据来源（Common Crawl 免费 → Moz/Bing 注册免费 → DataForSEO 付费）依序 fallback
`/seo competitor-pages`	生成「X vs Y」比较页、「X 的替代方案」页面结构

战略规划

指令	做什么
`/seo plan <类型>`	按业务类型（saas/local/ecommerce/publisher/agency）生成 SEO 战略蓝图，含内容日历、四阶段路线图
`/seo programmatic`	评估规模化生成页面（programmatic SEO）的可行性，含薄内容防护机制
`/seo flow [阶段]`	FLOW 框架（Find/Leverage/Optimize/Win/Local）的证据导向提问，共 41 条提示词，CC BY 4.0 授权

工具指令：/seo setup（建立/刷新本地 Python 环境）、/seo doctor（诊断环境有没有装好，不会改动任何东西）。

8 个扩展（extensions）速查

装完主插件后可选加装，各自对接一个第三方 SEO 数据源／工具，需要各自的 MCP 集成才能用：

扩展	指令	做什么
DataForSEO	`/seo dataforseo`	23 条 SERP／关键词／竞品／反链／技术侦测／AI 能见度的即时数据指令
Ahrefs	`/seo ahrefs`	Domain Rating、反链域名数、自然关键词、流量估算
SE Ranking	`/seo seranking`	量测品牌在 ChatGPT / Gemini / Perplexity / AI Overview 里的「AI 声量占比」
Profound	`/seo profound`	追踪品牌被 LLM 引用的情况，30 天趋势、竞品共同引用、异常提醒
Bing Webmaster	`/seo bing`	Bing Webmaster Tools 反链数据、IndexNow URL 提交
Firecrawl	`/seo firecrawl`	整站爬取、URL 发现、单页抓取、站内搜索
Unlighthouse	`/seo unlighthouse`	本地跑多页 Lighthouse 审核，不吃官方 API 额度（需要 Node 18+）
Banana（image-gen）	`/seo image-gen`	用 Gemini 生成 OG 图／部落格头图／商品图等 SEO 用图，附创意总监流程 + SEO 检查清单

怎么安装

⚠️ 跟前面 wordpress-skills／elementor-skills 不同，这个插件需要本地跑 Python 环境（脚本、可选的 Playwright Chromium），装法更接近「装一个 CLI 工具」而不是「上传一个 SKILL.md 文件夹」：

Claude Code（推荐，Claude Code 1.0.33 以上，走插件市场）：

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

📌 装完插件本身不会自动跑套件管理器，/seo setup 这一步（建立 Python 虚拟环境 + 视需要装 Playwright Chromium）是必须手动补的，跳过这步指令会因为缺依赖跑不动。

手动安装（Unix/macOS/Linux）：

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

💡 Windows 特地用 git clone 而不是常见的一行 curl | bash，是因为 Claude Code 自己的安全防护会拦截「从网路直接抓远程脚本执行」这种写法。

环境需求：Python 3.10+、pip、Git、Claude Code CLI；Playwright Chromium 可选（装不成功不影响主要功能）。不需要任何 API key 才能跑基础审核——Google API 整合是可选加强功能，四级制从免费额度开始。

安装位置：

内容	路径
主 skill	`~/.claude/skills/seo/`
Python 虚拟环境	`~/.claude/skills/seo/.venv/`
运行入口	`~/.claude/skills/seo/bin/claude-seo`
各 sub-skill	`~/.claude/skills/seo-*/`
子代理定义	`~/.claude/agents/seo-*.md`

验证安装：claude 启动 → 打 /seo 看有没有出现 → 或直接跑 ~/.claude/skills/seo/bin/claude-seo doctor 做诊断（只检查不改动）。

📌 这个插件目前锁定 Claude Code，没看到官方提供 Claude Desktop / claude.ai 的安装方式——它要跑本地 Python 脚本、装虚拟环境，跟前面两个「打包一个 SKILL.md 文件夹上传」的轻量模式不是同一类，Desktop 端沙盒环境大概率跑不了。

输出格式

审核结果可以出：Markdown 报告（分区块、按优先级排列）、JSON（方便程式化串接）、PDF（完整审核约 32 页 A4，靠 WeasyPrint 排版）。所有资料存在本地，除了实际去抓目标网址的内容之外，不会把资料传到别的地方。

常见错误

❌ 用插件市场装完就以为能直接用——一定要补跑一次 /seo setup 建立 Python 环境，跳过这步会缺依赖，指令跑不动
❌ Windows 上照抄 Linux 那种一行 curl | bash 装法——Claude Code 的安全防护会拦截这种远程脚本直接执行，Windows 要先 git clone 再跑本地的 install.ps1
❌ 以为要先申请一堆 Google/Ahrefs/DataForSEO 的 API key 才能开始用——基础审核（/seo audit、/seo page、/seo technical 等）完全不需要任何 API key，Google API 和各扩展都是可选加强
❌ 装了某个扩展（比如 /seo ahrefs）但没另外配置对应的 MCP server——扩展指令依赖各自的第三方 MCP 集成，不是把 skill 文件夹放进去就自动生效
💡 只是想看一个页面有什么问题，不用整站跑 /seo audit（500 页、10~15 分钟）——/seo page <url> 单页检查快很多，先从这个开始
💡 环境出问题先跑 /seo doctor（或 ~/.claude/skills/seo/bin/claude-seo doctor）诊断，它只检查不会动你的系统，比直接重装更快定位问题

Sources

官方文档：

claude-seo（GitHub 仓库）— https://github.com/AgricIDaniel/claude-seo
Commands Reference — https://github.com/AgricIDaniel/claude-seo/blob/main/docs/COMMANDS.md
Installation Guide — https://github.com/AgricIDaniel/claude-seo/blob/main/docs/INSTALLATION.md