openseo-keyword-clustering

Cluster keywords by search intent and map each cluster to target pages with cannibalization detection.

31|5|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill openseo-keyword-clustering-moizibnyousaf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openseo-keyword-clustering
Source: https://github.com/MoizIbnYousaf/marketing-cli/tree/main/skills/openseo-keyword-clustering
Command: npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill openseo-keyword-clustering-moizibnyousaf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? SEO teams often hold long keyword lists with no clear plan for which page should target which term, leading to cannibalized rankings and unfocused content. This Skill groups keywords by search intent, assigns each cluster to an existing URL, a new page proposal, or a do-not-target bucket, and detects real cannibalization using Google Search Console query-plus-page data. ## Core Features & Use Cases - Intent-Based Clustering: Groups keywords by SERP intent and page type rather than lexical similarity, with SERP-overlap validation for borderline terms. - Cannibalization Detection: Uses Search Console query and page dimensions to confirm when one query splits impressions across multiple URLs. - Page Assignment & Briefs: Writes per-cluster briefs to marketing/seo/clusters/ with page type, required sections, internal-link targets, and priority, then hands off to seo-content or seo-machine. - Use Case: You have 200 keywords exported from a saved set and need a site map for new SEO pages. Run this Skill to get clusters, page targets, and confirmed cannibalization issues before generating any content. ## Quick Start Cluster the keywords in brand/keyword-plan.md by search intent and map each cluster to an existing or proposed page with cannibalization checks.

Frequently Asked Questions about openseo-keyword-clustering

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cluster keywords by search intent for SEO?▼

Group keywords by shared SERP intent and page type rather than word similarity, since terms sharing words can have different intent. This Skill assembles keywords from saved sets, GSC data, or seed research, then validates borderline groupings with SERP overlap checks.

How to detect keyword cannibalization with Google Search Console?▼

Pull Search Console performance data with query and page dimensions; one query splitting impressions across multiple URLs confirms cannibalization. Without GSC data, overlapping intent between proposed pages is only labeled as potential, not confirmed.

What keyword sources does this clustering workflow support?▼

It accepts a populated brand/keyword-plan.md, saved keyword sets with tags, live Google Search Console data, or seed discovery via keyword research tools. Sets under 10 terms get a simple mapping instead of full clustering.

Does keyword clustering work without an OpenSEO API key?▼

Without configuration it falls back to lexical clustering with Exa context, but every cluster is labeled SERP-unvalidated. A ready state requires OPENSEO_API_KEY and a verified MCP connection before paid tool calls.

When should I not run a full keyword clustering process?▼

Skip clustering for very small sets; under 10 usable terms only need a simple keyword-to-page map. Also avoid clustering by word similarity alone, since lexical overlap does not prove two terms belong on the same page.