SEO Machine 是一个端到端自然搜索流量引擎，用于为任意网站或应用批量生成程序化落地页，包括 alternatives（替代品）、comparisons（对比）、use-case（用例）和 playbooks（长文手册），并以真实关键词研究为支撑，维护一份可跨会话继续执行的持久化路线图。
用途与发布顺序：以转化为先，alternatives 和 comparisons 页面优先于博客；主张尽早发布，薄页面当天被索引优于完美页面三周后才被索引；与用户技术栈原生集成，可写入 Next.js、Astro、Rails+Inertia，或使用便携的 markdown 回退方案。路线图按转化意图优先排序：首先是 /alternatives/[competitor]（Pattern A），其次是 /compare/[a]-vs-[b]（Pattern D），然后是 /for/[use-case] 与 /for/[audience]（Pattern B/C），最后是 /playbooks/[topic]（Pattern E）；博客不在本技能范围内，除非用户明确要求。GSC 中排名 5–20 的“ striking-distance ”页面可插队优先处理。
两种模式自动检测：每次调用检查仓库根目录的 docs/seo-machine.md（或 .seo/config.json 中记录的路径）。文件不存在进入 Initialize 模式，执行技术栈检测、品牌上下文、关键词研究、技术审计并生成路线图与链接清单；文件存在则进入 Resume 模式，读取跟踪器，选择下一个待处理阶段（或用户指定的阶段）并端到端执行。
硬性前置条件：git rev-parse --is-inside-work-tree 必须成功，否则停止并提示用户初始化 git 或在仓库中运行；必须能检测到技术栈（package.json、Gemfile、composer.json、requirements.txt、astro.config.、next.config.、nuxt.config.、gatsby-config.、_config.yml、config.toml、pyproject.toml 之一），否则先询问用户；研究后端按顺序解析，优先 Exa-stack（Exa MCP + Firecrawl + gh + /last30days + mktg-x 等），不可用时回退到手动研究模式（免费 Google + Search Console + UI 粘贴）。Ahrefs 仅在用户需要精确 volume/KD/TP 数值时叠加使用，不是默认依赖。
Resume 模式执行页面生成阶段时，流程为：重新研究当前竞品定价与功能变化、按技术栈生成页面载荷、通过质量门槛验证（脚本 scripts/word_count.py 与 scripts/link_audit.py）、更新 .seo/link-inventory.md 与 docs/seo-machine.md 跟踪器。完成阶段后不自动提交，仅展示差异摘要供用户自行提交或开 PR。质量门槛包括字数、内部链接、FAQ JSON-LD 等 schema、alternatives 页面的诚实的竞品优势说明段。关键反模式：低 DR 时不要瞄准头部词、不要发布没有内链的孤岛页面、不要跳过 schema、不要自动提交、部分状态存在时重启 Initialize 前先提示。使用方式为在支持该技能的环境中调用，具体安装与调用命令资料中暂未提供。