gabrielmoreira SEO 工具页构建器
来源说明：本技能改编自 yuzeiki 的
seo-page-builder，在其基础上大幅重写 —— 收窄边界为「只处理工具型 SEO 页面」、新增scripts/onpage-audit.py可执行量具、 用实测竞品数据替换了拍脑袋的密度指标。原作若有明确许可要求请提 issue，我们会立即遵从。 其余部分随 CCG 以 MIT 分发。
核心原则
本技能只处理工具型 SEO 页面。它不处理普通 campaign 落地页、博客、新闻页、资讯页或 programmatic 批量页。
用 Firecrawl 把搜索意图转成可索引、可使用、可信的工具页。执行路径保持最短：
- 确认工具页关键词和现有模板。
- 研究 SERP 意图。
- 提取信息缺口和能力边界。
- 判断工具页类型，决定模块轻重。
- 产出页面文案、英文 source JSON 或实现说明。
- 按模块执行信息价值与 SEO QA。
适用场景
用户提到以下任一场景时使用本技能：
add feature pagenew generator pagenew tool pagefeature page JSONAI 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 流程。
执行顺序
- 读取
references/feature-page-seo.md。 - 扫描仓库中最接近的工具页模板。
- 按
references/serp-research.md做 SERP 研究。Firecrawl 不可用时改用scripts/onpage-audit.py --suggest取 Google autocomplete 真实词，禁止让模型编 PAA。 - 建立关键词地图、FAQ、相关工具和 cannibalization 判断。FAQ 问题用用户原话，不要改写。
- 判断工具页类型：删除、批量、生成编辑、增强修复、转换或模型页。
scripts/onpage-audit.py --benchmark实测 3-5 个排名竞品，先拿到密度区间再动笔。- 严格镜像模板 route shape 与 JSON shape。
- 只改必要接线：slug、namespace、import、metadata、page identifier、related links、页面文案。
- 按模块跑信息价值与 SEO QA。
scripts/onpage-audit.py --targets实测交付页，把关键词命中、密度、meta 长度、FAQ 深度写进 QA。
输出
- 模板匹配：选择的 route/JSON 与原因。
- 工具页类型：关键词对应的页面类型、首屏重点、必备模块和可省模块。
- SEO Brief：搜索意图、长尾词、FAQ、信息缺口、独特角度、相关内链。
- 实现说明：需要改的文件、route、JSON key 与接线。
- 优化后的 JSON：英文，结构必须与模板一致。
- 模块 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