keyword-research

name	keyword-research
description	Performs SEO keyword research using DataForSEO API. Use when user asks about keyword ideas, search volume, CPC, competition data, or needs keywords for blog posts, landing pages, or content strategy.
allowed-tools	Bash, Read

Keyword Research

Research keywords for SEO, content planning, and paid search using the DataForSEO API.

When to Use

• User asks for keyword ideas or suggestions
• User needs search volume, CPC, or competition data
• User is planning blog posts, articles, or landing pages
• User wants to analyze keyword opportunities
• User mentions SEO keyword research

Requirements

Environment variables must be set:

• DATAFORSEO_USERNAME - DataForSEO login email
• DATAFORSEO_PASSWORD - DataForSEO API password

Commands

Get Keyword Suggestions

Returns keywords containing the seed term with metrics:

./scripts/keyword_research suggestions "seed keyword" -n 20

Get Related Keywords

Returns semantically related keywords:

./scripts/keyword_research related "seed keyword" -n 20

Options

Option	Description
-n, --limit	Max results per seed (default: 50)
-f, --format	Output format: json (default) or table

Output Format

Default JSON output for easy parsing:

[
  {
    "seed": "ai seo",
    "keywords": [
      {
        "keyword": "ai seo tools",
        "search_volume": 2900,
        "cpc": 25.48,
        "competition": 0.09,
        "competition_level": "LOW"
      }
    ]
  }
]

Examples

Research keywords for a blog post:

./scripts/keyword_research suggestions "python tutorial" -n 30

Compare multiple seed keywords:

./scripts/keyword_research suggestions "react hooks" "vue composition api" -n 20

Get table output for human review:

./scripts/keyword_research suggestions "ai tools" -f table

Interpreting Results

Field	Meaning
search_volume	Monthly searches (Google US)
cpc	Cost per click in USD
competition	0-1 scale (higher = more competitive)
competition_level	LOW, MEDIUM, or HIGH