Keyword Clusterer

Group keywords by semantic similarity using embeddings - turn a keyword list into an organized content strategy.

When to Use This Skill

• Content planning - Group keywords into topic clusters

• Site structure - Map keywords to pages

• Intent analysis - Categorize by search intent

• Gap analysis - Find missing keyword themes

• PPC organization - Group keywords for ad groups

What Claude Does vs What You Decide

Claude Does You Decide

Structures analysis frameworks Strategic priorities

Synthesizes market data Competitive positioning

Identifies opportunities Resource allocation

Creates strategic options Final strategy selection

Suggests implementation approaches Execution decisions

Dependencies

pip install scikit-learn sentence-transformers pandas click

For simpler usage without ML:

pip install click pandas

Commands

Cluster Keywords

python scripts/main.py cluster keywords.csv --n-clusters 10 python scripts/main.py cluster keywords.csv --column keyword --n-clusters 15

Find Similar

python scripts/main.py similar "content marketing" --count 20

Analyze Intent

python scripts/main.py intent keywords.csv --column keyword

Examples

Example 1: Cluster Keyword Research

Input: keywords.csv with 500 keywords

python scripts/main.py cluster keywords.csv --n-clusters 12 --output clustered.csv

Output:

Cluster 1 (45 keywords): "content marketing"

- content marketing strategy

- content marketing tips

- how to do content marketing

Cluster 2 (38 keywords): "email marketing"

- email marketing tools

- best email marketing software

- email campaign tips

...

Example 2: Categorize by Intent

python scripts/main.py intent keywords.csv --column keyword

Output:

Intent Analysis

──────────────────────

Informational: 234 (47%)

- how to, what is, guide, tips

Commercial: 156 (31%)

- best, top, review, compare

Transactional: 78 (16%)

- buy, price, discount, order

Navigational: 32 (6%)

- login, contact, brand names

Search Intent Categories

Intent Signals Content Type

Informational how, what, why, guide Blog posts, guides

Commercial best, top, review, vs Comparisons, reviews

Transactional buy, price, discount Product pages

Navigational [brand], login, contact Landing pages

Clustering Methods

Method Best For Speed

semantic Meaning-based grouping Slower

lexical Word overlap grouping Faster

intent Search intent categories Fast

Skill Boundaries

What This Skill Does Well

• Structuring strategic analysis

• Identifying market opportunities

• Creating strategic frameworks

• Synthesizing competitive data

What This Skill Cannot Do

• Replace market research

• Guarantee strategic success

• Know proprietary competitor info

• Make executive decisions

Related Skills

• content-repurposer - Create content for clusters

• lighthouse-audit - Optimize cluster pages

Skill Metadata

• Mode: centaur

category: seo-tools subcategory: keyword-research dependencies: [scikit-learn, sentence-transformers, pandas] difficulty: intermediate time_saved: 5+ hours/week