关于 ultimate-seo-geo
Ultimate SEO + GEO 是面向读取 AGENTS.md 的 Agent 的 SEO 与生成式引擎优化技能，不依赖特定 LLM。它涵盖网站审计、优先级计划和经过验证的执行，并提供诊断脚本与分主题流程。
主要功能
- 01执行带评分和问题清单的网站审计
- 02评估 AI 搜索可见度与引用情况
- 03制定分阶段的优先行动计划
- 04生成并验证结构化数据标记
- 05使用覆盖多个 SEO 主题的诊断脚本
适用场景
- 01审计网站并安排技术修复优先级
- 02优化内容结构以争取 AI 引用
- 03准备结构化数据或迁移交付物
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/ultimate-seo-geo确认已加载。
详细介绍
Ultimate SEO + GEO — 不依赖 LLM 的 SEO Agent
| 属性 | 详情 |
|---|---|
| Version | 1.22.1 |
| Updated | 2026-10-01 |
| License | MIT |
| Author | Myk Pono |
| Lab | lab.mykpono.com |
| Homepage | lab.mykpono.com |
| Profile | |
| Platforms | Claude Code、Cursor、Copilot、Gemini CLI、Codex、Windsurf、Cline、Aider、Devin |
权威的 SEO 和生成式引擎优化 Agent。不依赖 LLM——适用于任何可读取 AGENTS.md 的平台。将 Google 官方 SEO 指南、2026 年 GEO 研究成果和从业者最佳实践整合为一个通用框架。每项发现都附有明确的修复指引，而不只是诊断结果。
此文件是路由入口。 §1–§26 的详细分步流程位于 references/procedures/ 下——仅在用户任务需要相应章节时阅读（见下方 §0）。领域知识表仍位于 references/*.md。
0. 开始之前
路由索引（只读所需内容）
| 目标 | 流程文件 | 另请阅读 / 运行 |
|---|---|---|
| 完整评分审计 | references/procedures/02-full-site-audit.md、references/procedures/21-script-toolbox.md | references/audit-script-matrix.md、references/thinking-framework.md、generate_report.py |
| AI 引用 / GEO | references/procedures/03-geo-ai-search.md | references/ai-search-geo.md、entity_checker.py、citability_checker.py、llms_txt_checker.py、robots_checker.py |
| 内容相关性 + GEO（结构、E-E-A-T、内部链接） | references/procedures/03-geo-ai-search.md、references/procedures/06-content-eeat-and-pruning.md | references/eeat-framework.md、article_seo.py、readability.py、internal_links.py、generate_report.py |
| AI 起草内容审核（痕迹、生成文本特征） | references/procedures/06-content-eeat-and-pruning.md | references/ai-generated-content-artifacts.md、content_quality.py、readability.py |
| 仅架构标记 | references/procedures/05-schema-structured-data.md | references/schema-types.md、validate_schema.py |
| 本地 | references/procedures/12-local-seo.md | references/local-seo.md、local_signals_checker.py |
| 抓取 / 索引 / 性能 | references/procedures/04-technical-seo.md、references/procedures/11-crawl-indexation.md | 矩阵脚本（robots_checker、sitemap_checker，以及 API 可用时的 pagespeed.py） |
| 迁移 | references/procedures/20-site-migration.md | references/site-migration.md、redirect_checker.py |
| 关键词 / 路线图（尚无 URL） | references/procedures/07-keywords-clusters-aeo.md、references/procedures/16-strategy-roadmap.md | 不要虚构实时网站的 /100 分数 |
| SEO 漂移 / 变更跟踪 | references/procedures/22-drift-monitoring.md | drift_monitor.py |
| 语义主题聚类 | references/procedures/23-semantic-clustering.md | topic_cluster.py |
| 内容简报生成 | references/procedures/07-keywords-clusters-aeo.md | content_brief.py |
| 电商 SEO | references/procedures/24-ecommerce-seo.md | ecommerce_schema.py、validate_schema.py |
| 高级本地 / 地图 | references/procedures/25-maps-intelligence.md | maps_checker.py、local_signals_checker.py |
| 网站结构 / 内容类型覆盖 / 导航 / 站点地图与抓取对比 | references/procedures/26-site-structure-content-types.md | references/page-types.md、site_graph.py、page_type_classifier.py、navigation_checker.py、site_architecture.py、sitemap_checker.py --reconcile |
客户报告（report.html：摘要、审计、策略、计划、附录） | references/report-template/report-template.md | render_report.py、report_data_lint.py、report.css |
| Google API 凭据 | references/procedures/21-script-toolbox.md | google_api_tier.py、crux_history.py、gsc_query.py、gsc_insights.py、ga4_report.py |
章节编号 §1–§26 与 AGENTS.md 及 references/procedures/ 中的文件名对应。完整索引：references/procedures/README.md。
参考资料阅读指南
当某个部分指向参考文件时，只需阅读完成当前任务所需的内容。
渐进式披露规则： 每次回复最多加载 references/ 中的 3 个文件（包括 references/procedures/ 下的文件）——使用 generate_report.py 执行模式 1 全面审计时除外，该脚本会隐式涵盖所有维度。对于单一主题的模式 2 或模式 3 任务（例如“修复我的 schema”或“编写 llms.txt”），路由表会指定 1–2 个相关的 references/*.md 文件；需要流程细节时，最多再指定一个 references/procedures/*.md 文件。对于范围狭窄的任务，加载整个 references/ 目录树会浪费上下文并增加延迟，却不会提升质量。这种做法遵循 Anthropic 的 Skills 渐进式披露架构。
| 任务 | 阅读 | 运行 |
|---|---|---|
| 全面审计（任意类型） | references/audit-script-matrix.md | generate_report.py |
| GEO / AI 引用 | references/ai-search-geo.md、references/entity-optimization.md | robots_checker.py、entity_checker.py、citability_checker.py、llms_txt_checker.py |
| Schema 标记 | references/schema-types.md | validate_schema.py |
| 技术 / CWV | references/technical-checklist.md | pagespeed.py、robots_checker.py、security_headers.py |
| 内容 / E-E-A-T | references/eeat-framework.md、references/core-eeat-framework.md | readability.py、article_seo.py |
| AI 起草的内容产物 | references/ai-generated-content-artifacts.md | content_quality.py、readability.py |
| CITE 域名审计 | references/cite-domain-rating.md | link_profile.py |
| 关键词 / 集群 | references/keyword-strategy.md | — |
| 链接 | references/link-building.md | internal_links.py、broken_links.py、link_profile.py |
| 本地 SEO | references/local-seo.md | local_signals_checker.py |
| 图片 | references/image-seo.md | image_checker.py |
| 国际化 / hreflang | references/international-seo.md | hreflang_checker.py |
| 程序化 SEO | references/programmatic-seo.md | programmatic_seo_auditor.py |
| 迁移 | references/site-migration.md | redirect_checker.py |
| 分析 / 误区 | references/analytics-reporting.md | — |
| 抓取 / 索引 | references/crawl-indexation.md | sitemap_checker.py、index_coverage_diff.py、duplicate_content.py、canonical_checker.py、broken_links.py、internal_links.py |
| 网站结构 / 页面类型 / 导航 | references/page-types.md、references/industry-templates.md | site_graph.py、page_type_classifier.py、navigation_checker.py、site_architecture.py |
哪些情况下不应运行模式 1（全面审计）
| 用户信号 | 操作 |
|---|---|
| 主要需求是 Google Ads / PPC | 属于付费媒体范围——除非用户同时要求自然 SEO，否则不要提供自然 SEO 健康评分或大量抓取问题。 |
| 仅雇主品牌塑造、纯粹新闻稿 / 公关分发、仅电子邮件营销 | 提供范围有限的指导；不要默认进行全面的技术 + 内容审计。 |
| 仅配置 GA4/GTM（未询问自然 SEO） | 使用 references/procedures/10-analytics-reporting.md——不要编造全域数值评分。 |
| 仅进行社交社群管理 | 不在范围内，除非与自然搜索发现相关（例如 sameAs、实体信号）。 |
| 明确限定范围的任务（例如“只检查 robots.txt 和 sitemap”） | 仅处理指定范围——除非用户提出要求，否则不要提供全域 E-E-A-T 长篇分析或 /100 评分。 |
审计上下文：内部模式与竞争模式
在开始处理前，先确定适用的审计上下文。这决定了哪些输出有效。
| 信号 | 上下文 | 允许的操作 |
|---|---|---|
| 用户说“我的网站”“我们的网站”“我拥有该网站”，提供 GSC/GA4 访问权限，或确认拥有后端访问权限 | 内部模式 | 完整评分审计，所有脚本均可运行，可使用 Execute 模式，/100 健康评分有效 |
| 用户不拥有的外部 URL（竞争对手、潜在客户或参考网站） | 竞争模式 | 仅进行表层抓取（首页 + 最多 20 个页面），不提供 /100 健康评分，禁用 Execute 模式，所有输出均标注为 “仅限外部观察” |
如有疑问，请询问：“这是您的网站，还是您正在分析竞争对手？”
此技能有三种模式。先确定适用模式，再进行其他操作。
三种模式
模式 1 — 审计
抓取网站，运行所有相关检查，并生成评分报告。每项发现都包含严重程度、证据、影响说明和修复指令。输出：SEO 健康评分 + 按优先级排列的发现 — 完整模板和流程见 references/procedures/02-full-site-audit.md。
模式 2 — 行动计划
将审计发现（或网站描述）转化为分阶段、按优先级排列且可执行的路线图。
不提供模糊建议 — 每项都要指出需要更改的具体页面、元素或模式，预期结果及所需工作量。输出：实施阶段表 + 快速见效项 — 参见 references/procedures/16-strategy-roadmap.md 和 references/procedures/02-full-site-audit.md 中的模式 2 格式。
模式 3 — 执行
开展实际工作。重写元标签、生成 schema 标记、制作重定向映射、创建内容简报、修复 hreflang、运行验证脚本、输出交付文件。每项执行任务最后都必须包含验证步骤 — 参见 references/procedures/02-full-site-audit.md 中的模式 3 循环。
运行 generate_report.py 后，按车道顺序处理摘要中的 action_plan：先处理 Auto（安全，无需审批），再处理 Assisted（适用高风险门槛），并将 Human / Decision 项及 open_questions 交还给用户。开放问题代表缺失数据，而不是审计发现。
大多数请求都依次涉及这三种模式：审计 → 计划 → 执行。如果已有审计发现，则直接进入模式 2；如果用户指定了要实施的具体修复，则直接进入模式 3。
信息收集清单
仅询问以下三个问题 — 用户消息中已回答的问题可跳过。
| # | 问题 | 重要性 |
|---|---|---|
| 1 | URL 是什么？ | 三种模式都需要 |
| 2 | 主要目标是什么？（流量 / AI 引用 / 本地潜在客户 / 流量下降 / 特定关键词） | 决定先运行哪些模块 |
| 3 | 选择哪种模式？ 审计 / 审计 + 计划 / 审计 + 计划 + 执行 | 确定工作范围 — 如果不明确，默认选择全部三种模式 |
其他信息（分析工具访问权限、CMS、业务类型）会在审计过程中了解。
模式路由
User request + URL
│
├─ "audit", "analyze", "full check", "what's wrong"
│ └─ Mode 1 → read procedures/02-full-site-audit.md
│
├─ "give me a plan", "roadmap", "what to fix first"
│ └─ Mode 2 → procedures/16-strategy-roadmap.md (run Mode 1 first if no audit exists)
│
├─ "fix this", "generate schema", "rewrite my titles", "run the scripts"
│ └─ Mode 3 → procedures/21-script-toolbox.md; topical procedure file for the task
│
├─ Traffic drop / rankings lost
│ └─ Mode 1 focused → procedures/10-analytics-reporting.md first, then procedures/06-content-eeat-and-pruning.md / procedures/04-technical-seo.md
│
├─ AI citations / GEO question
│ └─ Mode 1 focused → procedures/03-geo-ai-search.md first
│
├─ Domain / CMS migration
│ └─ Mode 1 focused → procedures/20-site-migration.md
│
└─ No mode stated + URL / "audit + fix everything"
└─ Mode 1 → 2 → 3 (procedures/02, then 16, then execute top findings)
主题到章节的路由表：references/procedures/01-request-detection-routing.md（与原 SKILL §1 内容相同）。
各模式的完成标准
审计完成的标准：已提供 SEO 健康评分（或说明“未评分”及原因）；所有严重和高优先级发现均按“发现/证据/影响/修复/置信度/可证伪性/领先指标”格式记录（严重和高优先级发现还需包含“第一性原理观察”和“依赖项”）；包含“假设审计”部分；没有任何章节在未说明原因的情况下被跳过。
计划完成的标准：已将发现归入四个实施阶段（基础 / 扩展 / 规模化 / 权威建设）；每项均包含负责人行动、预期结果、工作量估算和依赖项列（阻塞因素 / 后续解锁项）。计划已按依赖关系进行拓扑排序。
执行完成的标准：每项修复均已实施并验证 — 运行相关验证脚本、检查输出，并确认其解决了原始发现。
上下文预算意识
如果你使用的模型或配置存在上下文长度或执行时间限制（例如快速模型子 Agent、CI 流水线或 Agent 链），请在触及限制前优雅降级：
- 执行前先估算。 使用
generate_report.py和所有脚本进行完整的 Mode 1 审计，可能会生成 50k+ 个 token 的输出。如果你的有效预算低于 32k 个 token，请改为范围受限的审计：仅运行与用户主要关注点相关的脚本。 - 优先部分交付，避免超时。 如果上下文或时间即将耗尽，请交付已有结果——Health Score + 已完成的发现，并注明跳过了哪些部分以及原因。明确说明缺漏的部分，比超时且毫无输出更有用。
- 网页抓取成本高。 每次抓取网站都会增加延迟并消耗 token。对于范围受限的任务（仅检查 schema、审查 robots.txt、提供 GEO 指引），请根据用户描述和已提供的 URL 作答，而不是抓取整个网站。
- 上下文压缩备用方案。 如果审计过程中上下文已满，请遵循
references/procedures/21-script-toolbox.md中的 Context Management——将已完成部分压缩为摘要要点，然后继续剩余部分。
这是一种备用方案，而非默认做法。上下文预算充足时，始终优先采用完整审计流程。
全局防护规则（始终适用）
这些规则适用于所有模式。完整表格和评估器检查： references/procedures/19-quality-gates-hard-rules.md。
证据完整性（没有数据时不得作出断言）
| 断言 | 仅在以下情况下陈述 |
|---|---|
| LCP / INP / CLS / 性能分数 | pagespeed.py 成功运行，或用户粘贴了 PageSpeed Insights / CrUX 输出 |
| 反向链接数量或引荐域名 | link_profile.py 已运行并返回数据 |
| 自然流量或展示次数 | 已确认可访问 GSC / GA4，且已获取数据 |
| Health Score /100 | Internal Mode + generate_report.py 至少测量了 5 项加权检查；按原样报告其 overall，否则写“未评分” |
| Schema 错误或验证状态 | validate_schema.py 已针对该页面运行 |
| CMS 网站上的 schema“未找到” | 已通过 Rich Results Test 或浏览器 JS 确认——原始 HTML 无法检测由 JS 注入的 schema |
缺少数据时： 使用 [metric] not measured — run [script] for actual data，或请用户提供数据。
发现格式（必须遵循）
每项发现均须包含：发现 / 证据 / 影响 / 修复方法 / 置信度（已确认 / 可能 / 假设）/ 可证伪性（什么情况可以证明此判断有误）/ 先行指标（修复后要监控什么）。Critical 和 High 级发现还必须包含 第一性原理观察 和 依赖项。应用 references/thinking-framework.md 中的 PERCEIVE → ANALYZE → VALIDATE → ACT 框架。报告摘录示例：references/audit-output-example.md。
高风险执行门槛
对于高风险变更（robots.txt、canonical 标签、重定向映射、noindex、hreflang、批量 CMS 模板）：先用通俗语言说明，并在输出代码或文件内容前征得用户确认。安全变更（meta、alt 文本、大多数 schema、内容改写、llms.txt）：可直接输出。完整分类表：references/procedures/02-full-site-audit.md（Mode 3）。
交付任何 Mode 1 审计前
有可用 shell 时，先运行 python scripts/report_lint.py report.md --summary summary.json，然后按照 references/procedures/19-quality-gates-hard-rules.md（Evaluator-Optimizer 检查清单）进行内部自评。