seo-keyword-niche

示例输出：examples/seo-keyword-niche-espresso-machine-reviews-20260514/KEYWORD-NICHE-PLAN.md

关键词细分领域

挖掘长尾词，寻找内容机会。提取长尾变体、疑问意图关键词、相关关键词和搜索结果页（SERP）样本，找出服务不足的细分领域关键词；按意图对其分组；提出内容层级方案（模板 + URL 模式 + 示例页面 + 薄内容质量门槛），以便通过程序发布或按稳定的编辑节奏发布。

前置条件

• 已连接 SE Ranking MCP 服务。
• 用户提供：一个种子主题（例如“跑鞋”“报税”）或 2–5 个种子关键词。目标国家（默认 us）。可选：最低搜索量阈值（默认：此细分领域技能为 50/月，低于 seo-keyword-cluster 的 100）、最高 KD（默认：40，以便更容易触达）。

流程

1. 验证与预检

   • 确认种子合理（不过于宽泛、非品牌词、非单字母词）。
   • DATA_getCreditBalance — 显示剩余点数。此技能比大多数技能更耗资源：深入提取长尾词的成本高于提取核心词。

2. 扩展长尾词 DATA_getLongTailKeywords

   • 对每个种子：提取长尾变体（通常为 3 个以上词，单词搜索量较低，KD 也较低）。
   • 目标：每个种子获得 200–500 个长尾候选词。

3. 扩展疑问词 DATA_getKeywordQuestions

   • 对每个种子：提取疑问形式的关键词。
   • 这些词是内容挖掘的宝藏——关键词中明确体现了用户意图。

4. 扩展相关词 DATA_getRelatedKeywords 和 DATA_getSimilarKeywords

   • 对每个种子：提取相关词和相似词。
   • 捕捉长尾词扩展遗漏的语义近邻词。

5. 筛选与清理

   • 移除低于 min_volume 和高于 max_kd 的关键词。
   • 去除种子域名不拥有的品牌关键词（除非用户提供了品牌种子）。
   • 为每个关键词标记检测到的意图：信息型、商业型、交易型、导航型。
   • 跨种子去重。

6. 为代表性关键词抽取 SERP 样本 DATA_getSerpResults

   • 针对 5–10 个代表性关键词（每个新兴分组各选一个），提取排名前 10 的结果。
   • 确定每个分组的主导页面类型（为第 8 步的模板方案提供依据）。

7. 按意图和主题分组

   • 按语义相似度和意图对关键词分组。
   • 每个分组包含：名称、主关键词、辅助关键词、总搜索量、加权 KD、主导页面类型。
   • 目标：8–20 个分组（比 seo-keyword-cluster 的 5–12 个更细，这项技能面向细分领域内容层级）。

8. 提出内容层级方案

   • 模板结构：明确哪些字段能让每个页面各不相同。对于 {city} apartment rentals，模板字段为 {city}、{neighborhood}、{price_range}、{property_count}。对于 {tool} alternatives，字段为 {tool}、{competitor_count}、{primary_use_case}。
   • URL 模式：/{category}/{slug}/ 或 /{topic}/{tool}-alternatives/ 等。
   • 示例页面：为有代表性的分组关键词提供 3 个完整规格的页面线框图。
   • 内部链接自动化：说明如何在该层级内链接页面（从分类页向下辐射的中心辐射式结构，或适用于真正扁平结构的页面间互链）。

9. 质量门槛（防止薄内容的保护措施）

   • **每页最低独特数据量：**模板字段必须生成 ≥ 5 个独特属性（数量、价格、名称、日期等）。不足 5 个独特属性的页面只是伪装成不同内容的重复页面——跳过这些关键词变体。
   • **最低字数：**600 字有效内容（不包括导航、页脚和样板内容）。
   • **结构化数据要求：**每个模板页面都必须添加 Article（或相关类型）+ BreadcrumbList。
   • **索引/不索引区分：**如果变体未达到独特数据阈值，则生成页面，但将其设为 noindex。

9a. 程序化发布 — 额外门槛

大多数用户发现这项技能，是因为他们想大规模发布页面（程序化 SEO、数据驱动型目录、地点页面）。程序化发布是最容易引发垃圾内容分类器反噬的路径。每当拟议的层级预计要发布 50 个以上的模板化页面时，除上述门槛外，还要满足以下要求。

• 每行独特性阈值（≥ 30% 的字段有变化）。 在模板中生成内容的字段里（不包括导航栏／页脚样板内容），至少 30% 必须包含与同级页面中位数不同的值。一个包含 12 个字段的模板，如果其中 9 个字段在所有页面上都相同，那就是毫无实质内容的模板堆砌——自 2024 年核心更新以来，Google 的垃圾内容系统对此已非常敏感。计算方式：varying_fields / content_fields ≥ 0.30，按行与集群中位数进行比较。
• 与父页面及同级页面相比的最低独有事实数（≥ 5 条）。 每行至少包含 5 条父级中心页或同一集群中的任何同级页面都未出现过的事实。事实包括：数字、日期、命名实体、原创引语、照片。更换同义词不算。批准该层级前，先手动抽查 10 行。
• 数据来源独立性。 不要仅凭单一来源（一个 CSV、一个 API、一次抓取）自动发布。如果页面唯一的差异只是来自 cities.csv 的一行数据，那这个页面只是套上内容外衣的 CSV 行，很可能内容单薄。每个页面至少要结合 ≥ 2 个独立数据来源。
• 索引膨胀断路器。 首批 50 个页面发布后，监控 GSC。如果索引覆盖率降至 60% 以下（Google 收录的页面不足已提交页面的 60%），暂停该层级并重新审核。出现这一信号后仍继续发布，会让该层级其余页面的索引膨胀问题进一步加剧。
• 如实评估抓取预算。 页面少于 50k 的网站通常可以抓取你发布的所有页面。页面超过 50k 的网站必须考虑抓取预算成本：每个内容单薄的程序化页面都会分走基石内容的注意力。如果网站属于这一规模，且独有事实数处于临界水平，默认设置为 noindex。

程序化发布路径的这些门槛不容商量。拟议的层级若无法通过，正确做法是减少页面数量，而不是降低门槛。

10. 综合整理 KEYWORD-NICHE-PLAN.md

输出格式

创建文件夹 seo-keyword-niche-{target-slug}-{YYYYMMDD}/，其中包含：

seo-keyword-niche-{target-slug}-{YYYYMMDD}/
├── KEYWORD-NICHE-PLAN.md           (synthesised plan — primary deliverable)
├── keywords.csv                    (all enriched keywords with cluster + intent — load-bearing CSV the publishing team paste into CMS/sheets)
├── 06-template-spec.md             (fields, URL pattern, sample pages — load-bearing reference writers consult directly)
├── 07-quality-gates.md             (thin-content guardrails — load-bearing reference release-gate readers consult directly)
└── evidence/
    ├── 01-seed-expansion.md        (raw expansion per seed — raw step output)
    ├── 02-question-keywords.md     (DATA_getKeywordQuestions)
    ├── 03-filtered-keywords.md     (post min-vol / max-kd filter)
    ├── 04-cluster-assignment.md    (every keyword and its cluster)
    └── 05-serp-samples.md          (top 10 for representative cluster keywords)

顶层文件：KEYWORD-NICHE-PLAN.md + keywords.csv + 06-template-spec.md + 07-quality-gates.md。撰稿时直接参考模板规范；发布门槛检查时直接参考质量门槛。01–05 步骤文件在 evidence/ 中保留原始 API／聚类输出。

KEYWORD-NICHE-PLAN.md 结构：

# Keyword Niche Plan: {topic}

> Generated {YYYY-MM-DD} · Country: {country} · Seeds: {list}

## Inventory
- Longtail keywords mined: {n}
- Question keywords: {n}
- After filter (min-vol {n}, max-kd {n}): {n}
- Clusters formed: {n}
- Estimated combined monthly volume: {n}

## Recommended content tier

### Template
**URL pattern:** `/{category}/{slug}/`

**Required fields per page:**
- `{slug}` — URL-friendly identifier
- `{H1}` — page primary heading
- `{TL;DR}` — first 200 words direct answer
- `{primary_keyword}` — target keyword
- `{related_keywords}` — secondary keywords from cluster
- `{unique_attributes}` — list of ≥ 5 differentiating attributes (numbers, names, dates)
- `{related_pages}` — internal-link list (3–5 sibling pages)
- `{schema_type}` — Article/Product/Other
- `{datestamp}` — last-updated date

**Sample pages:** see `06-template-spec.md` for 3 fully-spec'd wireframes.

## Cluster build order (top 10 by priority)

| Rank | Cluster | Volume (combined) | Weighted KD | Dominant page type | Pages to ship |
|---|---|---|---|---|---|
| 1 | {cluster name} | {n} | {kd} | {type} | {n} |
| ... |

## Quality gates (do not ship pages that fail)

1. **Unique-data threshold:** each page has ≥ 5 unique attributes vs sibling pages in the same cluster.
2. **Minimum word count:** 600 words effective content.
3. **Schema:** `Article` + `BreadcrumbList` (or relevant `@type` for the page).
4. **Internal links:** ≥ 3 outbound to siblings, ≥ 1 inbound from category hub.
5. **Index/noindex:** noindex pages that don't pass the unique-data threshold.

### Programmatic-only gates (apply when tier ships 50+ pages)

6. **Per-row uniqueness ≥ 30%:** at least 30% of content-producing fields hold values that differ from the cluster median.
7. **Min unique facts vs parent + sibling (≥ 5):** five facts per row that don't appear on the parent hub or any sibling.
8. **Data-source independence:** ≥ 2 independent data sources per page (no single-CSV pages).
9. **Index-bloat circuit-breaker:** pause tier if GSC index-coverage <60% after the first 50 pages.

## Scaling estimate
- Clusters: {n}
- Pages per cluster (median): {n}
- Total pages: {n}
- At {pages/week} cadence: {n weeks} to ship the tier.
- Crawl-budget impact (for sites > 10k pages): noindex strategy keeps thin variants out of the index.

## Risks / monitoring
- **Thin-content penalty:** the quality gates above are the guardrail. Audit at scale via `seo-technical-audit` after first 100 pages ship.
- **Index bloat:** monitor in GSC; if newly indexed pages don't accrue impressions in 60 days, candidate for noindex/consolidate.
- **Cannibalization:** monitor with `seo-subdomain` + `seo-page` after first 50 pages.

## Recommended next step
Build a small pilot — 10 pages from the top cluster — before committing to the full tier. Apply quality gates rigorously to the pilot. Re-audit after 60 days; iterate the template based on which pilot pages indexed and ranked.

keywords.csv 列：keyword,volume,kd,cpc,intent,cluster,role_in_cluster,dominant_page_type,unique_attributes_estimate

提示

• 遵守速率限制：10 req/sec。步骤 2–4 会针对所有种子词并行发起请求；请按顺序控制节奏。
• 成本：5 个种子词约需 30–80 个点数，10–20 个种子词约需 150 个以上点数。运行前调用 DATA_getCreditBalance 并说明预估费用。
• 程序化 SEO 风险较高。 未达到独有数据阈值的页面，充其量毫无价值，最坏则会招致惩罚。步骤 9 的质量门槛并非可选项。
• 试点建议至关重要。10 个精心设计模板的页面，胜过 1000 个模板化内容堆砌的页面。
• 对于电商／库存驱动型内容（城市页面、产品变体），独有数据阈值通常很容易达到。
• 对于“适合 Y 的最佳 X”内容（Y 有许多变体），应选择内容确实各不相同的变体，不要把近义词都套进同一模板。
• 配合 seo-keyword-cluster，构建更广泛的支柱页 + 集群页架构（这项技能是补充，而非替代）。
• 配合 seo-content-brief，将单个支柱主题扩展为完整的编辑简报。
• 首批 100 个页面发布后，配合 seo-technical-audit，检查内容单薄／规范化问题。
• 不要自动发布。这项技能负责生成模板、URL 模式和质量门槛；内容撰写与审核仍由人工负责。