seo-keyword-cluster

seo-keyword-cluster is a skill for Claude Code from amirjahfar1/automate-seo-with-claude. It costs 109 tokens per session (2,491 once invoked), scanned A, original, MIT.

A planning tool that groups search keywords into related topics and search purposes. It maps a main “pillar” page to supporting articles, with suggested headings and links between them.

In plain words
What is it for?
Use it to expand 3–20 starting keywords, find related and question-based searches, set volume and difficulty filters, plan pillar and supporting pages, and create an internal-linking map.
Why use it?
It turns a long list of keywords into an ordered content plan. This helps avoid publishing disconnected articles or deciding manually which topics should be covered first.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the seo-skills plugin — 26 skills shipped together

Good fit Use it to expand 3–20 starting keywords, find related and question-based searches, set volume and difficulty filters, plan pillar and supporting pages, and create an internal-linking map.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/amirjahfar1/automate-seo-with-claude/seo-keyword-cluster
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add amirjahfar1/automate-seo-with-claude --skill seo-keyword-cluster
Clone the repo
git clone --depth 1 https://github.com/amirjahfar1/automate-seo-with-claude

Made for: Claude Code.

Or install seo-skills, the plugin that ships this one along with the rest of its 26 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for seo-keyword-cluster

README.md
[![agentmods](https://agentmods.dev/badge/skills/amirjahfar1/automate-seo-with-claude/seo-keyword-cluster/github.svg)](https://agentmods.dev/skills/amirjahfar1/automate-seo-with-claude/seo-keyword-cluster)
Your own site
<a href="https://agentmods.dev/skills/amirjahfar1/automate-seo-with-claude/seo-keyword-cluster"><img src="https://agentmods.dev/badge/skills/amirjahfar1/automate-seo-with-claude/seo-keyword-cluster/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for seo-keyword-cluster

Your own site · 80×15
<a href="https://agentmods.dev/skills/amirjahfar1/automate-seo-with-claude/seo-keyword-cluster"><img src="https://agentmods.dev/badge/skills/amirjahfar1/automate-seo-with-claude/seo-keyword-cluster.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 109 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,491 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00109 $0.02491
Opus 5 $0.00055 $0.01246
Sonnet 5 $0.00022 $0.00498
Haiku 4.5 $0.00011 $0.00249

Measured 12d ago against content hash abce2047eab7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

seo-keyword-cluster scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/seo-keyword-cluster/SKILL.md · 142 lines

How it starts

The opening of the file, as written. The whole thing — 142 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Example output: examples/seo-keyword-cluster-headless-cms-20260514/PLAN.md

Keyword Cluster

Transform seed keywords into a prioritised cluster plan: each cluster grouped by search intent and theme, with volume totals, a pillar concept, spoke articles, and suggested H1/H2 for each spoke.

Prerequisites

  • DataForSEO MCP server connected.
  • User provides: (a) 3 to 20 seed keywords, (b) target market country (default: us), and optionally (c) minimum volume threshold (default: 100/mo), (d) maximum KD (default: 60).

Process

  1. Expand seeds mcp__dataforseo__dataforseo_labs_google_related_keywords, mcp__dataforseo__dataforseo_labs_google_keyword_suggestions, mcp__dataforseo__dataforseo_labs_google_keyword_ideas

    • For each seed, pull related + similar + long-tail variants in the target country.
    • Target at least 100 candidate keywords per seed; de-duplicate across seeds.
  2. Question-based expansion mcp__dataforseo__dataforseo_labs_google_keyword_ideas (filter to interrogatives: who/what/why/how/can/does/is/are…)

    • Pull question-intent keywords for the top 5 seeds.
    • These usually become spoke articles with PAA/featured-snippet potential.
  3. Clean and filter

    • Remove keywords below min volume and above max KD.
    • Strip branded terms the target does not own.
    • Tag each keyword with detected intent: informational, commercial, transactional, navigational.
  4. Cluster by SERP overlap mcp__dataforseo__serp_organic_live_advanced

    • Group keywords by how Google actually ranks them — shared top-10 organic URLs — not by text similarity. Token-overlap clustering manufactures cannibalisation; see references/serp-overlap-methodology.md for the full algorithm and anti-pattern callouts.
    • Cost note. DataForSEO bills per call; this pass issues one serp_organic_live_advanced call per unique candidate keyword. Use the documented depth/limit params to cap result size. For a large candidate set, trim it by raising the min-volume / lowering the max-KD thresholds in step 3 and re-running so fewer SERP calls are issued.
    • Fetch SERPs (one call per unique candidate keyword, cached for the session) — see references/serp-overlap-methodology.md § "Caching". Total SERP fetches = number of keywords, not number of pairs.
    • Pairwise overlap scoring. For each pair within an intent pre-group (see references/serp-overlap-methodology.md § "Pre-Grouping" for the optimisation that avoids full O(N²)), count shared URLs in the top 10 organic. Apply thresholds: 7-10 shared = same post (merge keywords), 4-6 = same cluster, 2-3 = interlink across clusters, 0-1 = separate clusters or exclude.
    • Form clusters from the connected components in the 4-6+ overlap graph. Target 5 to 12 clusters. Each cluster gets a name, primary keyword, secondary keywords, total volume, weighted KD.
    • Classify each cluster as pillar-worthy (broad, high volume, informational) or spoke-only (narrow, specific).

Read the full file on GitHub · 142 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 142 lines · 109 tokens per session scan A abce2047eab7

Subscribe to this mod's changes

seo-keyword-cluster is a skill published in the GitHub repository amirjahfar1/automate-seo-with-claude (2 stars, last pushed 3mo ago), licensed MIT. It adds 109 tokens to every session and 2,491 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

seo-site-audit-pro

Flagship comprehensive SEO audit combining Ahrefs and GSC data in sequential waves with checkpoint saves. Use when user says "site audit pro", "full audit", "comprehensive audit", "audit with live data", "deep audit", "pro audit", "complete SEO audit", "run a full site audit", or "audit everything for this domain".…

lionkiii/claude-seo-skills · 90 tokens

seo-content

Content quality and E-E-A-T analysis with AI citation readiness assessment. Enhanced with live Ahrefs (actual keyword rankings, positions) and GSC (search query performance) data to validate static E-E-A-T analysis with real user behavior. Use when user says "content quality", "E-E-A-T", "content analysis"…

lionkiii/claude-seo-skills · 83 tokens

seo-core-web-vitals

Dedicated Core Web Vitals deep-dive: pull field data (CrUX / PageSpeed Insights), fall back to Lighthouse lab data, score LCP, INP, and CLS against Google's thresholds at the 75th percentile, and run per-metric diagnosis playbooks with concrete fixes. Use when user says "core web vitals", "CWV", "LCP", "INP", "CLS"…

lionkiii/claude-seo-skills · 99 tokens

seo-geo

Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences. GEO analysis enriched with Ahrefs Brand Radar AI visibility data when available. Includes brand mention signals, AI crawler accessibility, llms.txt compliance, passage-level citability scoring…

lionkiii/claude-seo-skills · 119 tokens

seo-lighthouse-audit

Run a Lighthouse audit against any URL via the local Lighthouse CLI or the PageSpeed Insights API fallback, parse category scores and failed audits, and map every failed audit ID to its official Chrome docs page plus a one-line fix. Use when user says "lighthouse", "lighthouse audit", "run lighthouse", "lighthouse…

lionkiii/claude-seo-skills · 78 tokens

seo-llms-txt

Generate, validate, or audit llms.txt files for AI search visibility. Crawls site structure, generates spec-compliant Markdown index for LLMs. Use when user says "llms.txt", "llm txt", "AI crawlers", "generate llms", "LLM file", "AI readability file".

lionkiii/claude-seo-skills · 72 tokens