mcpField
K
keyword-clusterer

keyword-clusterer

github.com/guia-matthieuMarketing & growth150197 installsUpdated 4w ago
Repository

About keyword-clusterer

keyword-clusterer is a keyword research skill for SEO and content teams. It groups terms by semantic or lexical similarity, finds similar keywords, and categorizes search intent through command-line scripts.

Key features

  1. 01Semantic and lexical keyword clustering
  2. 02Similar keyword lookup
  3. 03Search intent categorization
  4. 04CSV input and report output

Use cases

  1. 01Group research terms into content topics
  2. 02Map keywords to site pages
  3. 03Organize keywords for PPC ad groups

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/guia-matthieu/clawfu-skills --skill keyword-clusterer

After installing, type/keyword-clustererin Claude Code to confirm it loaded.

Bundled filesscripts/main.pyscripts/requirements.txt

Details

From the project README

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 DoesYou Decide
Structures analysis frameworksStrategic priorities
Synthesizes market dataCompetitive positioning
Identifies opportunitiesResource allocation
Creates strategic optionsFinal strategy selection
Suggests implementation approachesExecution 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

IntentSignalsContent Type
Informationalhow, what, why, guideBlog posts, guides
Commercialbest, top, review, vsComparisons, reviews
Transactionalbuy, price, discountProduct pages
Navigational[brand], login, contactLanding pages

Clustering Methods

MethodBest ForSpeed
semanticMeaning-based groupingSlower
lexicalWord overlap groupingFaster
intentSearch intent categoriesFast

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

Skill Metadata

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

Comments

Markdown supported