| name | Keyword Cluster Builder |
| description | Collapses a raw keyword list into topic clusters and a pillar/cluster page architecture with one primary keyword and a prioritized build order per cluster. Use when you have a keyword export (CSV/GSC/keyword-tool dump) and need a content plan that says which pages to build, not a flat list. Do NOT use when labeling individual queries by intent or recommending page types — use search-intent-classifier instead; do NOT use when choosing internal links or anchor text between pages — use internal-linking-mapper instead. |
Keyword Cluster Builder
Turn hundreds of queries into a small set of clusters, each earning ONE page, arranged so topical authority compounds. A keyword list is not a content plan: one thin page per keyword cannibalizes your own rankings and wastes crawl budget.
Workflow
- Dedupe and discard. Drop near-zero-volume singletons, branded/navigational queries you cannot rank for, and queries whose SERP is pure ads/maps/widgets with no organic slot. Normalize obvious variants (plurals, word order, stop words).
- Cluster by shared SERP, not string similarity. Group queries Google answers with the same page: if two queries return largely the same top-10 organic URLs, they belong in one cluster. Never split a cluster only because wording differs; never merge two queries that surface different result types just because they share words.
- Separate clusters that demand different page formats. When a cluster's SERP is dominated by a different result type (a guide vs. a comparison vs. a product page), split it — one page cannot satisfy two formats. Treat the coarse intent signal as a grouping input only; do not produce per-query intent labels or page-type recommendations here (that is search-intent-classifier).
- Build the pillar/cluster topology. For each topic, define one broad pillar targeting the head term and the cluster pages targeting long-tail subtopics that report to it. Record the parent→child structure (which clusters belong under which pillar). Define structure only — leave link selection and anchor text to internal-linking-mapper.
- Pick the primary keyword per cluster. Choose the one keyword the page can realistically win (highest relevant volume at achievable difficulty), then list the secondary keywords the same page should also satisfy. State difficulty honestly; on a low-authority domain, favor lower-difficulty long-tail clusters first.
- Output a prioritized build order. Score each cluster by opportunity = (revenue relevance × winnability) ÷ current coverage. Flag overlaps where two existing pages compete for one cluster (consolidate). Flag gaps where a cluster has demand but no page.
Quality bar
- Every retained query lands in exactly one cluster; no query appears twice.
- Each cluster maps to exactly one planned page and one primary keyword.
- Cluster membership is justified by SERP overlap, not lexical overlap.
- Every cluster carries a pillar/child role, an opportunity score, and an overlap/gap flag.
- The deliverable names the pages to build in priority order — not a re-sorted keyword list.
Do NOT
- Do not label clusters by the informational/commercial/transactional/navigational taxonomy or recommend page types — that is search-intent-classifier.
- Do not specify internal links or anchor text between pages — that is internal-linking-mapper.
- Do not create one page per keyword, or split a cluster because of synonym wording.
- Do not promise ranking timelines; organic gains take months.
- Do not recommend doorway pages, spun variants, or thin micro-keyword pages to chase coverage.
