技能介绍
Claude SEO 是 AgriciDaniel 开发的开源 SEO 分析插件，用于 Claude Code。它并行运行 25 个子技能和 18 个专业代理，覆盖技术 SEO、内容质量（E-E-A-T）、Schema.org 标记、AI 搜索优化（GEO）、本地 SEO、电子商务和国际 SEO。每次审计都会生成一份带优先级的行动计划，其中的建议都基于 Google 的原始来源指南。
它不只是「跑一遍检查给你一堆问题」，而是要求每条建议都能被检验：建议都带首要原则观察、依赖关系、「我们如何知道这失败了？」检查以及要监控的领先指标。插件采用 MIT 许可，不包含任何专有跟踪，默认不上传数据到第三方。
适用场景
- 管理 5 个以上客户网站的 SEO 机构：把每季度的深度审计换成每周自动运行，覆盖面从季度变成每周而不增加计费工时；漂移基准会在两次审计之间捕获回归。
- SaaS / 出版 / 电商公司的内部 SEO 负责人：在管理层评审前做二次检查，发现 GSC 和 Lighthouse 藏起来的问题——Schema 废弃、AI 可引用性差距、过期域名继承风险、寄生 SEO 暴露、机器翻译漂移。
- 自由职业 SEO 顾问：在第一次通话里用 15 分钟审计和一个真实的 0-100 分锚定客户范围，在写提案之前就给出具体的价值证明。
- 需要在季度业务评审前 24 小时摸底自然流量风险（程序化页面上的损坏规范链、Schema 弃用、AI 概览截流）的团队。
核心能力
- 核心网页指标：测量当前三个核心指标 LCP（目标低于 2.5 秒）、INP（目标低于 200 毫秒）和 CLS（目标低于 0.1）。INP 于 2024 年 3 月 12 日取代 FID，FID 于 2024 年 9 月 9 日从 CrUX API、PageSpeed Insights 等现场数据工具中移除，Claude SEO 从不引用 FID。现场数据来自 Chrome 用户体验报告（CrUX），实验室数据回退到 PageSpeed Insights 的 Lighthouse，移动端与桌面端分别测量，LCP 可通过 CrUX 分解为 TTFB、加载延迟、加载持续时间、渲染延迟以定位瓶颈。
- E-E-A-T 评估：按 2025 年 9 月更新的搜索质量评估指南（QRG）评分，其中 YMYL 已扩展到政治和社会主题。评分前先套用 Google 的「谁/如何/为什么」启发式方法。信任度是四个维度中权重最高的，考察联系方式、HTTPS、透明的更正、日期戳。生成式 AI 内容若符合搜索基本要求并无问题，用于规模化低质量页面才算垃圾内容，
seo-content humanize与seo-content verify就是为此设计的检测工具。 - Schema.org 标记：JSON-LD 是首选格式。检测、验证并生成组织、文章、产品、本地、活动、工作、课程、软件/应用程序、服务、问答、视频等活跃类型。不推荐已弃用类型：HowTo（富媒体搜索结果于 2023 年 9 月移除）、SpecialAnnouncement（2025 年 7 月）、ClaimReview、VehicleListing、EstimatedSalary、LearningVideo、CourseInfo 轮播（均于 2025 年 6 月退役）。FAQPage 自 2026 年 5 月 7 日起 Google 不再为所有网站显示富媒体搜索结果，仅在需要非 Google 或内部语义时保留。
- AI 搜索优化：与 Google 的 AI 优化指南保持一致——该指南指出 AEO 和 GEO 是 SEO 的重新包装标签，AI 概览和 AI 模式基于与经典搜索相同的排名系统，页面必须被索引并有资格显示摘要才能出现在 AI 功能中。评分段落可引用性（最佳 134-167 字的自包含答案块）、基于问题的标题层级、归因密度、结构化数据覆盖率，以及维基百科、Reddit、YouTube、LinkedIn 上的实体存在。它还基于证据否定了三个流行迷思：llms.txt 目前不是引用杠杆、不需要内容分块、AI 特定关键词重写没有必要。
- Google API 四层凭证：Tier 0（仅 API 密钥）解锁 PageSpeed Insights、CrUX、CrUX 历史 25 周趋势；Tier 1（+ OAuth 或服务账号）增加 Search Console 与 Indexing API；Tier 2（+ GA4 媒体资源配置）增加自然流量、热门着陆页、设备/国家细分；Tier 3（+ Ads 开发者令牌）增加关键词规划师搜索量与竞争数据。凭证存于
~/.config/claude-seo/，权限0o600。 - 本地 SEO 三层：Google Business Profile 信号（类别、营业时间、照片、帖子、产品、属性）、NAP 一致性（名称/地址/电话与主要目录比对并标记偏差）、评论情报（评分趋势、情感、回复覆盖率）。多地点商家强制 30 页警告阈值与 50 页硬停止以防门户页面违规。
- 32 个 `/seo` 命令：覆盖编排器、子技能与 8 个 MCP 扩展，从
/seo audit、/seo page、/seo technical、/seo schema、/seo geo到/seo local、/seo ecommerce、/seo backlinks、/seo hreflang等。 - 两个坦诚的限制：其一是重度客户端 hydration 场景——hydration 与折叠下方滚动位置绑定、在用户交互后才获取关键内容、第三方小部件有竞态条件的页面仍会产生噪声结果，建议手动触发
seo-visual子代理并与原始 HTML 子代理的发现交叉比对；其二是免费层级默认不做第三方 API 调用，没有 Google API 凭证时核心网页指标只是实验室估计，索引状态从页面级信号推断。
效果预览
一个网站于 2026 年 3 月 23 日启动并使用此工作流运行，这是其前三个月（截至 2026 年 6 月 12 日）的 Google Search Console 总点击次数和展示次数：
运行完整审计时，可以看到并行代理在网站中展开：
与手动审计、机构服务、商业工具相比：
| 手动审计 | 机构服务 | 商业 SEO 审计工具 | Claude SEO | |
|---|---|---|---|---|
| 每次审计时间 | 高级 SEO 4-8 小时 | 1-3 周周转 | 10-45 分钟爬取 + 报告 | 10-15 分钟 |
| 成本 | 高（计费工时） | $2k-$15k+ 项目 | $99-$999/月 订阅 | 免费技能 + Claude Code 订阅 |
| 可重复性 | 分析师之间不一致 | 项目之间不一致 | 是 | 是，确定性 + 可脚本化 |
| 输出格式 | 发现墙 PDF | 品牌化幻灯片 | Web 仪表盘、CSV 导出 | Markdown + PDF + JSON，本地文件 |
| 数据离开机器？ | 否 | 是（发送给机构） | 是（上传到供应商） | 否，默认完全本地 |
| 锁定 | 无 | 高 | 高 | 无。MIT，你的文件。 |
| 每条发现的可证伪性 | 否 | 否 | 否 | 是，每条建议都附带失败检查 + 领先指标 |
工作方式
插件遵循 Agent Skills 标准，采用 3 层架构（指令、编排、执行）。技能和代理从 skills/seo-*/ 和 agents/seo-*.md 自动发现。编排器（skills/seo/SKILL.md）处理行业检测（SaaS、本地、电商、出版、代理），并行调度最多 15 个代理，再通过 10 原则框架综合，最后发出行动计划。
每次审计都遵循 10 个原则，分为四个阶段：
| 阶段 | 原则 | 作用 |
|---|---|---|
| PERCEIVE | OBSERVE（外部）· OBSERVE（内部）· LISTEN | 收集原始信号；审计自己的假设；阅读 SERP、品牌声音和社区实际所说的内容 |
| ANALYZE | THINK · CONNECT（横向）· CONNECT（系统） | 简化为首要原则；发现非显而易见的跨技能联系；排序为依赖关系图 |
| VALIDATE | FEEL · ACCEPT | 针对用户体验、品牌声音、操作者能力进行压力测试；揭示可证伪性 |
| ACT | CREATE · GROW | 交付成果；为下一次审计设置反馈循环 |
v2 版本分为六个构建阶段：Phase A 全面无头渲染（Playwright Chromium + trafilatura + htmldate，自动检测 Next.js、React、Vue、Nuxt、Astro islands）；Phase B 符合 QRG 的内容质量关卡；Phase C 技术深度与 CWV 深度；Phase D Schema 完整性；Phase E AI 搜索重新框架与 5 个新 MCP 扩展；Phase F 本地、国际与隐私优化。测试覆盖率从 v1.9.9 的 39 个增长到 v2 的 410 个，url_safety 套件单独运行 91 个 SSRF 和 DNS 重新绑定绕过案例。
你需要提供
- Python 3.10+
- Claude Code CLI
- 可选：Playwright Chromium，仅 SPA 渲染和截图需要，
install.sh会提供安装选项 - 可选：用于富化 CWV / GSC / GA4 数据的 Google API 凭证（参见
/seo google setup）
你会获得
FULL-AUDIT-REPORT.md：总审计报告，主要交付物SCHEMA-REPORT.md：Schema 标记审计（含逐属性的通过/警告/严重问题判定与总体评级）GEO-ANALYSIS.md：AI 搜索就绪性分析LOCAL-SEO-ANALYSIS.md：GBP 和引文分析- 通过 WeasyPrint + matplotlib 生成的生产级 PDF（封面、目录、执行摘要、数据部分、建议、方法论），完整网站审计约 32 页 A4
使用示例
# 启动 Claude Code
claude
# 全站审计：并行子代理生成优先级行动计划
/seo audit https://example.com
# 深度单页分析：页面元素、内容质量、Schema
/seo page https://example.com/about
# Schema 标记审计：检测、验证、生成
/seo schema https://example.com
# AI 搜索优化：段落可引用性 + 基于原始来源的建议
/seo geo https://example.com
# 生成包含行业模板的站点地图
/seo sitemap generate扩展需要自带账户：
./extensions/dataforseo/install.sh # 需要 DataForSEO 账户
/seo dataforseo serp best coffee shops
/seo dataforseo ai-mentions your brand典型组合工作流：
/seo audit https://example.com：识别内容差距和技术问题/seo backlinks https://example.com：分析链接概况和竞争对手差距/seo geo https://example.com/blog/post：评分 AI 引用就绪性/blog write "target keyword"：创建 SEO 优化的博客文章（Claude Blog）/seo image-gen hero "blog topic"：生成英雄图片（Banana 扩展）
