/seo-page-builder

name: seo-page-builder
description: 用于创建、审计或优化 SEO 工具页、AI generator/remover/enhancer/converter/editor 功能页、feature page JSON、工具页 on-page SEO brief，以及 App Router/i18n 功能页路由。
user-invocable: true
allowed-tools: Read, Write, Edit, Glob, Grep, Bash, WebFetch
argument-hint: "[目标关键词 或 页面路径]"

SEO 工具页构建器

> **来源说明**：本技能改编自 yuzeiki 的 `seo-page-builder`，在其基础上大幅重写 —— > 收窄边界为「只处理工具型 SEO 页面」、新增 `scripts/onpage-audit.py` 可执行量具、 > 用实测竞品数据替换了拍脑袋的密度指标。原作若有明确许可要求请提 issue，我们会立即遵从。 > 其余部分随 CCG 以 MIT 分发。

核心原则

本技能只处理工具型 SEO 页面。它不处理普通 campaign 落地页、博客、新闻页、资讯页或 programmatic 批量页。

用 Firecrawl 把搜索意图转成可索引、可使用、可信的工具页。执行路径保持最短：

1. 确认工具页关键词和现有模板。 2. 研究 SERP 意图。 3. 提取信息缺口和能力边界。 4. 判断工具页类型，决定模块轻重。 5. 产出页面文案、英文 source JSON 或实现说明。 6. 按模块执行信息价值与 SEO QA。

适用场景

用户提到以下任一场景时使用本技能：

• `add feature page`
• `new generator page`
• `new tool page`
• `feature page JSON`
• `AI generator page SEO`
• 工具页 route 接线
• i18n JSON 工具页文案
• generator / remover / enhancer / converter / editor / maker 页面

非工具页需求不由本技能处理；博客交给 `blog-writing`，普通营销页面先确认是否已有更合适的专门技能。

Firecrawl

优先使用 Firecrawl MCP。只有 MCP 不可用或用户要求本地调试时才使用 CLI。细节见 `references/firecrawl-workflow.md`。

• 搜索：`firecrawl_search`
• 抓取：`firecrawl_scrape`
• 站内发现：`firecrawl_map`
• 动态交互：`firecrawl_interact`

必要输入

只询问会改变结果的缺失信息：

• `CORE_KEYWORD`：一个英文主关键词
• 品牌名或产品名
• 目标市场
• 现有 route、模板、JSON 或参考 URL
• 交付物：直接编辑、只写 JSON、只写 brief、只做审计
• 产品能力边界：格式、尺寸、时长、价格、登录、安全、隐私、法务限制
• 可证明素材：截图、示例、before/after、真实功能说明

默认只写英文 source JSON。多语言扩展交给后续 i18n 流程。

执行顺序

1. 读取 `references/feature-page-seo.md`。 2. 扫描仓库中最接近的工具页模板。 3. 按 `references/serp-research.md` 做 SERP 研究。Firecrawl 不可用时改用 `scripts/onpage-audit.py --suggest` 取 Google autocomplete 真实词，**禁止让模型编 PAA**。 4. 建立关键词地图、FAQ、相关工具和 cannibalization 判断。FAQ 问题用用户原话，不要改写。 5. 判断工具页类型：删除、批量、生成编辑、增强修复、转换或模型页。 6. `scripts/onpage-audit.py --benchmark` 实测 3-5 个排名竞品，**先拿到密度区间再动笔**。 7. 严格镜像模板 route shape 与 JSON shape。 8. 只改必要接线：slug、namespace、import、metadata、page identifier、related links、页面文案。 9. 按模块跑信息价值与 SEO QA。 10. `scripts/onpage-audit.py --targets` 实测交付页，把关键词命中、密度、meta 长度、FAQ 深度写进 QA。

输出

1. **模板匹配**：选择的 route/JSON 与原因。 2. **工具页类型**：关键词对应的页面类型、首屏重点、必备模块和可省模块。 3. **SEO Brief**：搜索意图、长尾词、FAQ、信息缺口、独特角度、相关内链。 4. **实现说明**：需要改的文件、route、JSON key 与接线。 5. **优化后的 JSON**：英文，结构必须与模板一致。 6. **模块 QA**：逐模块确认信息价值、Google 政策门槛、可抓取性、schema、链接与薄页风险。

质量栏

• 工具必须真实可用，或诚实说明当前能力和限制。
• 页面先帮助用户完成任务，再追关键词。
• 每个主要模块都必须提供信息价值：独特说明、真实限制、可验证示例、具体场景、操作步骤或可信来源。
• 页面模块由关键词意图和工具类型决定，不把所有工具页写成同一个长模板。
• 关键词自然出现在 title、meta、H1、URL、首段、alt 和相关小节。
• 不套用固定密度数字，但必须**实测**：主关键词在正文的命中次数（**0 次是常见静默失败**），

靶子由实测竞品区间给出，不用记忆或口头传闻的百分比。客户说「密度 2%」时先判定口径 —— 按 `hits%` 对多词短语追 2% 就是堆词。详见 `references/feature-page-seo.md`。

• 提密度优先换指代词为实名、H2 写工具全名（零新增字数），不靠加句子；短于目标就如实报告。
• 不做薄页 clone、doorway page、假工具、无证据承诺、抓取改写或隐藏关键信息。
• 链接少而相关，锚文本描述具体目标；付费或赞助链接使用正确 `rel`。
• 结构化数据必须匹配页面可见内容。

参考资料

• `references/firecrawl-workflow.md`：Firecrawl MCP/CLI 映射。
• `references/serp-research.md`：SERP 深度、抓取、意图与失败处理。
• `references/feature-page-seo.md`：工具页流程、模块信息价值与 SEO QA。
• `references/seo-source-library.md`：Google、Moz、Backlinko 与算法解读资料引用库。
• `scripts/onpage-audit.py`：三个模式的量具，stdlib only，无需 key ——

`--suggest` 取 Google autocomplete、`--benchmark` 量竞品密度并提取其 FAQ、`--targets` 打分交付页。 配置模板见 `scripts/targets.example.json`。

[PROTOCOL]: 变更时更新此头部，然后检查 AGENTS.md