keyword-clusterer

name	keyword-clusterer
description	Cluster keywords by semantic similarity and intent. Use when: organizing keyword research; creating content pillars; mapping keywords to pages; identifying content gaps; grouping search intent
license	MIT
metadata	{"author":"ClawFu","version":"1.0.0","mcp-server":"@clawfu/mcp-skills"}

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