Our review
Conducts SEO keyword research using the DataForSEO API, returning search volume, CPC, and competition data.
Strengths
- Provides accurate search volume and CPC metrics.
- Supports both keyword suggestions and related keywords.
- Outputs in JSON for programmatic use or table for human review.
Limitations
- Requires valid DataForSEO API credentials configured as environment variables.
- Data is limited to Google US by default.
- Maximum number of results per seed is controlled by the -n option.
Use when planning SEO content, analyzing keyword opportunities, or preparing paid search campaigns.
Avoid if you lack DataForSEO API access or need multilingual/non-US keyword data.
Security analysis
CautionThe skill uses Bash and network to access an external API with stored credentials. While intended for legitimate keyword research, the credential handling introduces a minor risk.
- •The skill runs a Python script via Bash that uses environment variables for API credentials, which could be leaked if the script is malicious or logs sensitive data.
Examples
Get keyword suggestions for 'AI tools' with search volume and CPC data.Compare keyword suggestions for 'react hooks' and 'vue composition API' with up to 20 results each.Get related keywords for 'python tutorial' and show them in a table format.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 emailDATAFORSEO_PASSWORD- DataForSEO API password
Commands
Get Keyword Suggestions
Returns keywords containing the seed term with metrics:
./scripts/keyword_research.py suggestions "seed keyword" -n 20
Get Related Keywords
Returns semantically related keywords:
./scripts/keyword_research.py 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.py suggestions "python tutorial" -n 30
Compare multiple seed keywords:
./scripts/keyword_research.py suggestions "react hooks" "vue composition api" -n 20
Get table output for human review:
./scripts/keyword_research.py 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 |
Content Repurposer
Content
Transforms a single piece of content into platform-adapted publications.
SEO Blog Post Writer
Content
Writes SEO-optimized blog posts with proper structure and keywords.
YouTube Script Writer
Content
Writes engaging YouTube scripts with hooks, structure, and retention.