keyword-research

When the user wants to research keywords, find target keywords, or analyze search intent. Also use when the user mentions "keyword research," "keyword tool," "target keywords," "search volume," "search intent," "keyword difficulty," "topical map," "keyword clustering," "People Also Ask," "Google autocomplete," "autocomplete keywords," or "alphabet method." For clusters, use content-strategy.

313 stars

Best use case

keyword-research is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

When the user wants to research keywords, find target keywords, or analyze search intent. Also use when the user mentions "keyword research," "keyword tool," "target keywords," "search volume," "search intent," "keyword difficulty," "topical map," "keyword clustering," "People Also Ask," "Google autocomplete," "autocomplete keywords," or "alphabet method." For clusters, use content-strategy.

Teams using keyword-research should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/keyword-research/SKILL.md --create-dirs "https://raw.githubusercontent.com/kostja94/marketing-skills/main/skills/seo/content/keyword-research/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/keyword-research/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How keyword-research Compares

Feature / Agentkeyword-researchStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

When the user wants to research keywords, find target keywords, or analyze search intent. Also use when the user mentions "keyword research," "keyword tool," "target keywords," "search volume," "search intent," "keyword difficulty," "topical map," "keyword clustering," "People Also Ask," "Google autocomplete," "autocomplete keywords," or "alphabet method." For clusters, use content-strategy.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# SEO Content: Keyword Research

Guides keyword research for SEO: finding target keywords, assessing difficulty, understanding search intent, and building topical maps. ~95% of keywords get fewer than 10 searches/month; low-volume, high-intent terms often yield faster rankings and conversion.

**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.

## Initial Assessment

**Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for product, audience, and positioning.

Identify:
1. **Product/service**: What you offer
2. **Audience**: Who searches for it
3. **Goals**: Traffic, conversions, brand
4. **Tool access**: Google Keyword Planner, Google Trends, or SEO tools

## Discovery Methods

### Base Discovery

| Method | Purpose |
|--------|---------|
| **User perspective** | What pain points? What would they search? Customer language from product context |
| **Tool expansion** | Related keywords, questions, suggestions; Google autocomplete, PAA, Related Searches |
| **Competitor reverse** | Analyze competitor titles, H1, URL; identify topics they rank for; find gaps (#4–10 = opportunity) — see **competitor-research** |
| **Google PAA** | People Also Ask and Related Searches; high-value signals from real user behavior |
| **Extract from article** | When auditing existing content: extract seed keywords from title, H1, H2s, meta keywords, first 100 words; then search `"[primary keyword]"` or `"[primary keyword] related keywords"` for opportunities; use `"[primary keyword]" site:competitor.com` if competitors known |

### Google Autocomplete (Long-Tail Discovery)

Google autocomplete reflects real user searches; suggestions only appear if queries have actual traffic. Free; often uncovers low-volume long-tail that keyword tools miss. ~70% of search traffic is long-tail; lower competition, higher conversion.

**Alphabet method** (seed + space + letter):
- Type seed keyword + space + each letter: `keyword a`, `keyword b`, ... `keyword z`
- Record relevant suggestions; repeat with numbers 0-9
- Example: `SEO a` -> "SEO audit," "SEO agency"; `SEO b` -> "SEO basics," "SEO best practices"

**Position variants** (seed in different positions):
- **Prefix**: `a keyword`, `b keyword` (discover what users add before)
- **Suffix**: `keyword a`, `keyword b` (most common; alphabet method)
- **Middle**: `how to keyword a`, `best keyword for` (question + modifier combos)

**Question modifiers**:
- `how to keyword`, `what is keyword`, `why keyword`, `when to keyword`, `keyword vs`
- `keyword for beginners`, `keyword for small business`, `keyword without`

**Why it works**: Keyword tools filter low-volume terms; autocomplete only shows queries with real traffic. Use with PAA and Related Searches for full coverage. Categorize results by intent (informational, commercial, transactional).

### Incremental Discovery

- **User feedback**: Support, community, reviews, NPS—high-frequency questions = unmet search demand
- **Multi-platform search**: Reddit, Quora, X (Twitter), Hacker News—real questions and discussions

## Search Intent

| Intent | Content type | Example |
|--------|--------------|---------|
| **Informational** | Blog, guide, FAQ | "how to optimize sitemap" |
| **Navigational** | Brand page | "alignify login" |
| **Commercial** | Comparison, review | "SEO tools comparison" |
| **Transactional** | Product, pricing | "best SEO tool pricing" |

### Intent Identification

**Modifier words** (often signal intent):

| Intent | Modifiers |
|--------|-----------|
| Informational | "how," "what," "why," "guide," "tutorial" |
| Commercial | "best," "compare," "vs," "review," "top" |
| Transactional | "buy," "price," "cheap," "coupon," "free shipping" |
| Local | Location names |

**SERP check**: Search the term—knowledge cards/Wiki → informational; product lists/reviews → commercial; brand sites → navigational. Broader terms often show mixed SERP. See **serp-features** for feature types.

## Long-Tail Expansion

- **Google Autocomplete**: Alphabet method, position variants, question modifiers; see above. Primary source for long-tail.
- **Intent modifiers**: Core + "how," "best," "vs," "compare," "price"
- **Question words**: "how to," "what is," "why," "when"
- **Functional modifiers**: Core + "-er/-or" (e.g., "image optimizer" for tool-type queries); often higher conversion
- **Clustering**: Group by SERP overlap (same top pages), semantic similarity, or intent.

## Keyword Clustering & Topical Map

| Method | Use |
|--------|-----|
| **SERP overlap** | Keywords with overlapping top-ranking pages → same cluster |
| **Semantic** | Group by meaning, LSI, related concepts |
| **Intent-based** | Group by intent; separate pages if intent differs within cluster |

**Pillar–cluster** (map keywords to structure):
- **Pillar** (Hub): Broad topic page; links to clusters
- **Cluster** (Spoke): Focused subtopic; links back to pillar
- Target long-tail first; then pillar. Interlink clusters within topic.
- See **content-strategy** for full pillar-cluster planning and implementation.

## Evaluate & Screen

| Factor | Consider |
|--------|----------|
| **Search volume** | Monthly searches; ~100+/month typical floor; niche can relax |
| **Keyword difficulty (KD)** | New sites target lower KD |
| **CPC** | Higher CPC often = stronger commercial intent |
| **SERP features** | Featured Snippet, PAA, zero-click; SERP features can satisfy intent without click—affects real traffic; see **serp-features** (Zero-Click section), **featured-snippet** |
| **Screening order** | 1) Remove irrelevant 2) Filter very low volume 3) Assess achievability 4) Prioritize commercial/transactional |

## Product Positioning Test (SEO Fit)

Test if positioning is clear enough for search:

- **XXX + Function words**: Generator, Creator, Maker, Builder, Changer, Shortener, Scraper, Converter, Downloader, Translator, Extender, Summarizer, Resizer, Remover, Extractor, Recorder, Rewriter, Solver, Calculator; or Platform, Tool, Software, App, Provider, Assistant, Copilot
- **Input + to + Output**: e.g., "image to video," "text to speech"—clear input/output signals intent

**Agent/Copilot products**: Pure native Agent hard to grow via SEO; users rarely search "agent." Release related features first (e.g., CRM, sales bot for sales agent) to build traffic, then funnel to Agent product.

## Principles

- **Core rule**: Someone must search it—validate with tools; avoid inventing terms
- **Functional keywords**: Tool-type (-er/-or) often convert better; users are closer to action
- **Multi-language**: Re-research in target language; don't translate existing lists. See **translation** for translation workflow.

## SEO–PPC Keyword Synergy

Keyword research serves both SEO and Google Ads. Align both channels to avoid duplication, cannibalization, and wasted spend.

| Data flow | Use |
|-----------|-----|
| **keyword-research → google-ads** | Keyword list, clusters, intent; support terms (login, forum, pricing) → negative keywords for PPC |
| **google-ads → keyword-research** | PPC conversion rate, Search Terms report → SEO priority; high-converting PPC terms = worth ranking organically |
| **keyword-research → landing-page** | Clusters → dedicated LP per intent; PAA questions → FAQ sections |
| **GSC organic rank 4+** | If you rank well organically, consider reducing/pausing PPC on those terms to avoid cannibalization |

**PPC data for SEO priority**: `SEO ROI ≈ (Organic clicks × PPC conversion rate × Customer value) − SEO cost`. Use PPC conversion data to validate which keywords to pursue in organic.

**Reference**: [Backlinko – SEO and PPC: 8 Smart Ways to Align](https://backlinko.com/seo-and-ppc)

## Data Sources

| Source | Use |
|--------|-----|
| **Ahrefs** | Keywords Explorer, Site Explorer |
| **SEMrush** | Keyword Overview, Organic Research |
| **GSC** | Search queries, impressions, clicks |
| **GA** | Traffic by landing page |
| **PostHog** | Feature/search usage |

## Report Workflow

1. **Parse** — Read Excel/CSV, infer keyword, volume, KD, intent, etc. from headers
2. **Enrich** — Web search, visit competitor/product pages; read `project-context.md` if present
3. **Build** — Structure data for report
4. **Generate** — Output report in chosen format

## Output Format

- **Keyword list** with volume, KD, intent
- **Keyword mapping** to pages/content
- **Content gaps** (competitors rank, you don't)
- **Priority** ranking for implementation
- **Topical map** (cluster → pillar → page mapping)

### Report Structure Reference

| Section | Content |
|---------|---------|
| Executive Summary | Priorities (top 3) |
| Keyword Overview | Total keywords, primary intent, avg KD, content gaps count |
| Keyword List | Keyword, volume, KD, intent, priority, target page |
| Keyword Mapping | Page/URL, target keywords, status |
| Content Gaps | Keywords competitors rank for that you don't |
| Action Plan | Priority, action, impact, effort |
| Appendix | Search intent reference (Informational, Commercial, Transactional, Navigational) |

## Related Skills

- **seo-strategy**: SEO workflow, Product-Led SEO, audit approach; keyword research is Content phase
- **google-ads**: Keywords inform Search targeting; PPC data feeds back into SEO priority
- **paid-ads-strategy**: When to use paid vs organic; channel selection
- **content-strategy**: Keywords inform content plan; topic clusters
- **content-optimization**: Keyword placement, density vs stuffing, H2 keywords
- **title-tag, meta-description**: Keywords in title, description
- **heading-structure**: Keywords in H1, H2
- **link-building**: Keywords inform link targets
- **serp-features**: SERP features in keyword screening; PAA, Featured Snippet
- **featured-snippet**: Snippet-worthy query targeting
- **competitor-research**: Competitor keyword/topic analysis; reverse engineering
- **faq-page-generator**: PAA questions to FAQ sections; question-based keyword to FAQ content

Related Skills

research-sources

313
from kostja94/marketing-skills

When the user wants to find information sources for content ideation, competitor monitoring, or industry tracking. Also use when the user mentions "research sources," "information sources," "content ideation," "industry monitoring," "competitor monitoring," "market intelligence," "content research," or "topic research." For keywords, use keyword-research.

competitor-research

313
from kostja94/marketing-skills

When the user wants to analyze competitors for SEO, content, backlinks, or positioning. Also use when the user mentions "competitor analysis," "competitor research," "competitor keywords," "competitor backlinks," "link gap," "content gap," "competitor content," "competitive analysis," or "competitor comparison." For content roadmap, use content-strategy.

website-structure

313
from kostja94/marketing-skills

When the user wants to plan website structure, decide which pages to build, or prioritize pages for a new or existing site. Also use when the user mentions "website structure," "site structure," "which pages do I need," "page planning," "sitemap planning," "Must Have pages," "website architecture," or "site hierarchy." For a specific page template (e.g. homepage), use homepage-generator or landing-page-generator as appropriate. Not for organic SEO roadmap alone; use seo-strategy.

seo-strategy

313
from kostja94/marketing-skills

When the user wants to plan SEO strategy, prioritize SEO work, or understand the SEO workflow. Also use when the user mentions "SEO strategy," "SEO plan," "SEO roadmap," "SEO priority," "SEO audit," "SEO workflow," "where to start SEO," "SEO approach," "organic growth strategy," "why SEO," "SEO value," or "search strategy." For technical/crawl audit execution, use seo-audit. For keyword research, use keyword-research. For AI search visibility, use generative-engine-optimization.

seo-audit

313
from kostja94/marketing-skills

When the user wants to run an SEO audit, technical SEO audit, or site health check. Also use when the user mentions "SEO audit," "technical audit," "site audit," "crawl audit," "indexing audit," "SEO health," or "fix SEO issues." For prioritization and organic strategy, use seo-strategy. For GSC data analysis, use google-search-console.

retention-strategy

313
from kostja94/marketing-skills

When the user wants to reduce churn, improve customer retention, or plan lifecycle marketing. Also use when the user mentions "retention," "churn," "customer lifecycle," "churn prevention," "at-risk customers," or "loyalty program." For lifecycle, use growth-funnel.

product-launch

313
from kostja94/marketing-skills

When the user wants to plan a product launch, execute launch channels, or create a launch checklist. Also use when the user mentions "product launch," "launch strategy," "product announcement," "launch channels," or "market launch." For GTM motion and positioning, use gtm-strategy. For cold start and first users, use cold-start-strategy. For Product Hunt day-of, use product-hunt-launch.

pmf-strategy

313
from kostja94/marketing-skills

When the user wants to validate product-market fit, measure PMF, or plan before scaling. Also use when the user mentions "PMF," "product-market fit," "product market fit," "Sean Ellis test," "very disappointed," "vitamin vs painkiller," "PMF validation," "premature scaling," or "validate before scale." For GTM after validation, use gtm-strategy.

indie-hacker-strategy

313
from kostja94/marketing-skills

When the user wants indie hacker or bootstrapping founder strategy—growth, channels, Build in Public, or solo founder tactics. Also use when the user mentions "indie hacker," "indie developer," "bootstrapping," "bootstrapped founder," "solo founder," "Build in Public," "scratch your own itch," "Micro-SaaS," "first 100 users," or "solo company." For cold start, use cold-start-strategy.

gtm-strategy

313
from kostja94/marketing-skills

When the user wants to plan go-to-market strategy, GTM framework, or market entry. Also use when the user mentions "GTM," "go-to-market," "market entry," "new market," "repositioning," "PLG," "sales-led," "product-led," "marketing-led," "ICP," "buyer persona," "GTM motion," or "market expansion." For launch checklist, use product-launch.

growth-funnel

313
from kostja94/marketing-skills

When the user wants to plan growth using the AARRR framework, diagnose growth bottlenecks, or map actions across the customer lifecycle. Also use when the user mentions "growth funnel," "AARRR," "pirate metrics," "acquisition activation retention," "customer lifecycle metrics," or "growth framework." For retention tactics, use retention-strategy.

conversion-optimization

313
from kostja94/marketing-skills

When the user wants to improve conversion rates, run A/B tests, optimize funnels, or reduce friction. Also use when the user mentions "CRO," "conversion rate optimization," "A/B test," "split test," "funnel optimization," "checkout optimization," "form optimization," or "conversion funnel." For pricing psychology, use pricing-strategy.