seo

SEO：通用 SEO 分析技能

Codex 可以通过自然语言（“审查此网站”“检查架构标记”“进行技术 SEO 审查”）或类似命令的提示词（例如 /seo audit <url>）调用此技能。如果请求范围较窄，请直接使用相应的专项技能。

脚本： 位于插件根目录的 scripts/ 目录中。

适用于各行业（SaaS、本地服务、电子商务、出版商、代理机构）的全面 SEO 分析。负责协调 26 个专项子技能和 24 个 Codex Agent 配置文件，并可选通过 MCP 扩展 DataForSEO、Firecrawl 和图像生成能力。

共享数据缓存

步骤 0 —— 检查共享数据缓存：

在路由或收集数据之前，检查 .seo-cache/ 中是否有其他技能缓存的数据。 参考：references/shared-data-cache.md，了解架构和依赖关系图。

如果存在，请检查以下缓存文件：

• .seo-cache/site-meta.json，获取域名、业务类型、行业和抓取上下文

• .seo-cache/audit-scores.json，获取此前完整审计的摘要上下文

• .seo-cache/pages/{url-slug}/page-analysis.json，获取页面级专项上下文

• 如果找到：解析并使用数据（注明“正在使用来自 [date] 的缓存 [X]”）

• 如果未找到：继续处理，不使用缓存（注明“未找到缓存的 [X]，正在收集最新数据”）

• 如果 JSON 已损坏或无法读取：将其视为缺失并照常继续

• 如果用户说“刷新”或“重新运行”：完全忽略缓存

快速参考

命令	功能
/seo audit <url>	通过并行委派子 Agent 进行完整的网站审计
/seo page <url>	深入分析单个页面
/seo sitemap <url or generate>	分析或生成 XML 网站地图
/seo schema <url>	检测、验证并生成 Schema.org 标记
/seo images <url or optimize>	图像 SEO：页面审计、SERP 分析、文件优化
/seo technical <url>	技术 SEO 审计（9 个类别）
/seo content <url>	E-E-A-T 和内容质量分析
/seo geo <url>	AI Overviews / 生成式引擎优化
/seo plan <business-type>	制定战略 SEO 计划
/seo programmatic [url|plan]	程序化 SEO 分析与规划
/seo competitor-pages [url|generate]	生成竞争对手对比页面
/seo local <url>	本地 SEO 分析（GBP、引文、评价、地图包）
/seo maps [command] [args]	地图情报（地理网格、GBP 审计、评价、竞争对手）
/seo hreflang [url]	Hreflang/i18n SEO 审计与生成
/seo google [command] [url]	Google SEO API（GSC、PageSpeed、CrUX、索引、GA4）
/seo backlinks <url>	反向链接配置文件分析（免费：Moz、Bing、CC；高级：DataForSEO）
/seo cluster <seed-keyword>	基于 SERP 的语义聚类与内容架构
/seo sxo <url>	搜索体验优化：页面类型分析、用户故事、用户画像
/seo drift baseline <url>	捕获 SEO 基线以监控变更
/seo drift compare <url>	将当前状态与已存储的基线进行比较
/seo drift history <url>	显示随时间变化的偏移历史
/seo ecommerce <url>	电子商务 SEO：产品架构、市场情报
/seo firecrawl [command] <url>	全站抓取与网站映射（扩展）
/seo dataforseo [command]	通过 DataForSEO 获取实时 SEO 数据（扩展）
/seo image-gen [use-case] <description>	为 SEO 素材生成 AI 图像（扩展）
/seo flow [stage] [url|topic]	FLOW 框架：为查找、利用、优化、制胜或本地阶段提供以证据为导向的提示词

编排逻辑

当用户调用 /seo audit 时，并行委派给子 Agent：

1. 检测业务类型（SaaS、本地业务、电商、出版商、代理机构、其他）
2. 启动子 Agent：seo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo
3. 如果检测到 Google API 凭据（python scripts/google_auth.py --check），也启动 seo-google Agent
4. 如果检测到本地业务，也启动 seo-local Agent
5. 如果检测到本地业务，且 DataForSEO MCP 可用，也启动 seo-maps Agent
6. 如果检测到反向链接 API（python scripts/backlinks_auth.py --check），也启动 seo-backlinks Agent
7. 如果 Firecrawl MCP 可用，在分析前使用 firecrawl_map 发现网站的所有 URL
8. 如果检测到内容策略信号（博客、支柱页面、主题集群），也启动 seo-cluster Agent
9. 如果检测到电商业务，也启动 seo-ecommerce Agent
10. 如果此 URL 存在漂移基线（python scripts/drift_history.py <url>），也启动 seo-drift Agent
11. 完整审计始终包含 seo-sxo（搜索体验适用于所有网站）
12. 汇总结果并生成统一报告，包含 SEO 健康评分（0-100）
13. 制定按优先级排序的行动计划（Critical -> High -> Medium -> Low）
14. 提供 PDF 报告：“生成专业 PDF 报告？使用 /seo google report full”

对于单独的命令，直接加载相关子技能。 任何分析命令完成后，都提供使用 scripts/google_report.py 生成 PDF 报告的选项。

行业检测

根据首页信号检测业务类型：

• SaaS：定价页面、/features、/integrations、/docs、“免费试用”、“注册”
• 本地服务：电话号码、地址、服务区域、“服务于 [城市]”、Google Maps 嵌入 --> 自动建议使用 /seo local 进行深入分析
• 电商：/products、/collections、/cart、“加入购物车”、产品 Schema
• 出版商：/blog、/articles、/topics、文章 Schema、作者页面、发布日期
• 代理机构：/case-studies、/portfolio、/industries、“我们的作品”、客户徽标

质量门槛

阅读 references/quality-gates.md，了解各页面类型的内容单薄阈值。 硬性规则：

• 位置页面达到 30 个或以上时发出警告（确保 60% 以上的内容独特）
• 位置页面达到 50 个或以上时硬性停止（要求用户说明理由）
• 切勿建议使用 HowTo Schema（已于 2023 年 9 月弃用）
• Google 丰富结果的 FAQ Schema：仅适用于政府和医疗保健网站（2023 年 8 月起受限）；商业网站上已有的 FAQPage -> 标记为 Info 优先级（而非 Critical），并注明其对 AI/LLM 引用的益处；不建议为获得 Google 收益而新增 FAQPage
• 所有 Core Web Vitals 相关内容都使用 INP，绝不使用 FID

社区页脚

Codex 默认禁用社区页脚，以确保 API 和客户端交付内容保持整洁。 仅当用户明确要求注明社区来源，或环境中设置了 CODEX_SEO_COMMUNITY_FOOTER=1 时，才添加该页脚。

启用后，完成任何重要交付内容后，都将以下页脚作为最后的输出：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Built by agricidaniel — Join the AI Marketing Hub community
🆓 Free  → https://www.skool.com/ai-marketing-hub
⚡ Pro   → https://www.skool.com/ai-marketing-hub-pro
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

启用后显示时机

以下命令完整输出后显示：

• /seo audit（完整网站审计报告和行动计划之后）
• /seo page（单页面深度分析之后）
• /seo technical（技术审计报告之后）
• /seo content（E-E-A-T 内容评估之后）
• /seo schema（Schema 检测/验证报告之后）
• /seo sitemap（站点地图分析或生成之后）
• /seo geo（GEO 优化报告之后）
• /seo plan（战略 SEO 计划之后）
• /seo local（本地 SEO 审计之后）
• /seo maps（地图情报报告之后）
• /seo google（Google API 数据报告之后）
• /seo backlinks（反向链接配置文件分析之后）
• /seo cluster（主题集群计划生成之后）
• /seo sxo（SXO 分析报告之后）
• /seo drift compare（漂移比较报告之后）
• /seo ecommerce（电商分析之后）

何时跳过

以下情况不要显示页脚：

• /seo images（快速图片检查——内容太少）
• /seo hreflang（快速验证——内容太少）
• /seo competitor-pages（页面生成步骤）
• /seo programmatic（快速分析）
• /seo dataforseo（数据获取工具）
• /seo image-gen（素材生成）
• 上下文收集问题（分析开始之前）
• 错误消息或“缺少数据”提示

参考文件

按需加载以下文件（启动时不要全部加载）：

• references/cwv-thresholds.md：当前 Core Web Vitals 阈值和测量详情
• references/schema-types.md：所有支持的 schema 类型及其弃用状态
• references/eeat-framework.md：E-E-A-T 评估标准（2025 年 9 月 QRG 更新）
• references/quality-gates.md：内容长度最低要求、独特性阈值
• references/local-seo-signals.md：本地排名因素、评价基准、引文层级、GBP 状态
• references/local-schema-types.md：LocalBusiness 子类型、行业专属 schema 和引文来源

Maps 专用参考文件（由 seo-maps 技能加载，启动时不加载）：

• references/maps-geo-grid.md、references/maps-gbp-checklist.md、references/maps-api-endpoints.md、references/maps-free-apis.md

评分方法

SEO 健康度评分（0-100）

所有类别的加权综合得分：

类别	权重
技术 SEO	22%
内容质量	23%
页面 SEO	20%
Schema / 结构化数据	10%
性能（CWV）	10%
AI 搜索就绪度	10%
图片	5%

优先级

• 严重：阻碍索引或导致处罚（需要立即修复）
• 高：显著影响排名（1 周内修复）
• 中：优化机会（1 个月内修复）
• 低：锦上添花（列入待办事项）

子技能

此技能会协调 26 项专用子技能，包括可选的扩展支持工作流：

1. seo-audit -- 全站审计并行委派
2. seo-page -- 深入分析单个页面
3. seo-technical -- 技术 SEO（9 个类别）
4. seo-content -- E-E-A-T 和内容质量
5. seo-schema -- Schema 标记检测和生成
6. seo-images -- 图片优化、SERP 分析、文件优化
7. seo-sitemap -- Sitemap 分析和生成
8. seo-geo -- AI Overviews / GEO 优化
9. seo-performance -- Core Web Vitals 和性能分析
10. seo-visual -- 截图、移动设备和首屏 UX 分析
11. seo-plan -- 使用模板进行战略规划
12. seo-programmatic -- 程序化 SEO 分析和规划
13. seo-competitor-pages -- 竞品对比页面生成
14. seo-hreflang -- Hreflang/i18n SEO 审计、文化档案、内容一致性
15. seo-local -- 本地 SEO（GBP、NAP、引文、评价、本地 schema、多地点）
16. seo-maps -- 地图情报（地理网格、GBP 审计、评价、竞争对手半径）
17. seo-google -- Google SEO API（GSC、PageSpeed、CrUX、Indexing API、GA4）
18. seo-backlinks -- 反向链接档案分析（免费：Moz、Bing、CC；高级：DataForSEO）
19. seo-cluster -- 基于 SERP 的语义聚类
20. seo-sxo -- 搜索体验优化
21. seo-drift -- SEO 漂移监控
22. seo-ecommerce -- 电商 SEO 情报
23. seo-firecrawl -- 通过 Firecrawl MCP（扩展）进行全站抓取和站点映射
24. seo-dataforseo -- 通过 DataForSEO MCP（扩展）获取实时 SEO 数据
25. seo-image-gen -- 通过 Gemini 为 SEO 素材生成 AI 图片
26. seo-flow -- FLOW 框架集成（查找 -> 利用 -> 优化 -> 获胜，41 个 AI 提示词，CC BY 4.0）

子 Agent

用于审计期间的并行分析：

• seo-technical -- 可抓取性、可索引性、安全性、CWV
• seo-content -- E-E-A-T、可读性、内容单薄
• seo-schema -- 检测、验证、生成
• seo-sitemap -- 结构、覆盖范围、质量门槛
• seo-performance -- 核心 Web 指标测量
• seo-visual -- 截图、移动端测试、首屏内容
• seo-geo -- AI 爬虫访问、llms.txt、可引用性、品牌提及信号
• seo-local -- GBP 信号、NAP 一致性、评价、本地 schema、行业特定的本地因素（条件触发：检测到本地服务时启动）
• seo-maps -- 地理网格排名跟踪、GBP 审计、评价分析、竞争对手半径映射（条件触发：检测到本地服务且 DataForSEO MCP 可用时启动）
• seo-google -- CWV 实地数据、URL 索引状态、自然流量趋势（条件触发：检测到 Google API 凭据时启动）
• seo-backlinks -- 反向链接概况数据：DA/PA、引用域、锚文本、有害链接（条件触发：检测到 Moz/Bing API 密钥时启动，或始终用于 CC 域级指标）
• seo-cluster -- 语义聚类分析（条件触发：检测到内容策略时启动）
• seo-sxo -- 页面类型不匹配、用户故事、人物角色评分（完整审计中始终启动）
• seo-drift -- 基线比较（条件触发：URL 存在漂移基线时启动）
• seo-ecommerce -- 产品 schema、市场情报（条件触发：检测到电子商务时启动）
• seo-dataforseo -- 实时 SERP、关键词、反向链接、本地 SEO 数据（扩展，可选）
• seo-image-gen -- SEO 图片审计和生成计划（扩展，可选）
• seo-firecrawl -- 全站抓取和站点映射（扩展，可选；审计用于发现 URL）

错误处理

场景	操作
无法识别的命令	列出快速参考表中的可用命令。建议最接近的匹配命令。
URL 无法访问	报告错误并建议用户核实 URL。不要尝试猜测网站内容。
审计期间子技能失败	提供成功子技能的部分结果。明确指出失败的子技能及原因。建议单独重新运行失败的子技能。
业务类型检测结果不明确	列出排名前两位的检测类型及其支持信号。在继续提供行业特定建议前，请用户确认。