SEO Keywords Analysis

Comprehensive keyword research and analysis using DataForSEO API via direct curl calls.

API Configuration

Credentials stored in ~/.config/dataforseo/auth (Base64 encoded).

# Read auth token
AUTH=$(cat ~/.config/dataforseo/auth)

Quick Reference

API Endpoints

Keyword Ideas

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_ideas/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["SEED_KEYWORD"], "location_name": "United States", "language_code": "en", "limit": 50}]'

Keyword Suggestions (Autocomplete)

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_suggestions/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "SEED_KEYWORD", "location_name": "United States", "language_code": "en", "limit": 50}]'

Related Keywords

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/related_keywords/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "SEED_KEYWORD", "location_name": "United States", "language_code": "en", "limit": 50}]'

Bulk Keyword Difficulty

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/bulk_keyword_difficulty/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["kw1", "kw2", "kw3"], "location_name": "United States", "language_code": "en"}]'

Search Volume (Google Ads Data)

curl -s -X POST "https://api.dataforseo.com/v3/keywords_data/google_ads/search_volume/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["kw1", "kw2"], "location_code": 2840, "language_code": "en"}]'

Ranked Keywords (Site Analysis)

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"target": "example.com", "location_name": "United States", "language_code": "en", "limit": 100}]'

Search Intent

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/search_intent/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["kw1", "kw2"], "language_code": "en"}]'

Historical Keyword Data

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/historical_search_volume/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["KEYWORD"], "location_name": "United States", "language_code": "en"}]'

Analysis Modes

1. Keyword Research (Ideas Generation)

Generate keyword ideas from a seed keyword:

Input: seed keyword (e.g., "coffee maker")
Output:
- Related keyword ideas
- Search volume per keyword
- CPC and competition data
- Keyword difficulty score
- Search intent classification

2. Search Volume Analysis

Get accurate search volume data:

Input: list of keywords
Output:
- Monthly search volume
- Search volume trend (12 months)
- CPC estimate
- Competition level (0-1)
- Seasonal patterns

3. Keyword Difficulty Assessment

Analyze ranking difficulty:

Input: list of keywords
Output:
- Difficulty score (0-100)
- SERP feature presence
- Top 10 competitor strength
- Estimated effort to rank

Difficulty Interpretation:

• 0-20: Easy (new sites can rank)
• 20-40: Moderate (some authority needed)
• 40-60: Hard (established sites only)
• 60-80: Very Hard (high authority required)
• 80-100: Extremely Hard (dominant players only)

4. Site Keyword Analysis

Find keywords a domain ranks for:

Input: domain (e.g., "example.com")
Output:
- All ranking keywords
- Position for each keyword
- Search volume
- Traffic estimate
- Featured snippet presence

5. Search Intent Analysis

Classify keyword intent:

Input: list of keywords
Output:
- Intent type per keyword:
  - Informational (how, what, why)
  - Navigational (brand searches)
  - Commercial (best, review, compare)
  - Transactional (buy, price, discount)
- Content format recommendations

Content Mapping:

Keyword Prioritization Framework

Priority Matrix

Score each keyword on these factors:

Quick Win Identification

Quick wins have:

• Search volume > 100/month
• Difficulty < 40
• Commercial or transactional intent
• Direct business relevance

Output Format

Keyword Research Report

# Keyword Research: [seed keyword]

## Overview
- Total keywords found: X
- Average monthly volume: X
- Average difficulty: X

## Top Opportunities (Priority Sorted)

| Keyword | Volume | Difficulty | Intent | Priority |
|---------|--------|------------|--------|----------|
| [kw1] | X | X | Info | High |
| [kw2] | X | X | Trans | High |

## Keyword Clusters

### Cluster 1: [Topic]
- keyword a (vol: X, diff: X)
- keyword b (vol: X, diff: X)

## Content Recommendations

### Immediate Actions (Quick Wins)
1. [Keyword] -> Create [content type]
2. [Keyword] -> Create [content type]

Integration with Other SEO Skills

• Use seo-content to create content for target keywords
• Use seo-backlinks to build authority for competitive keywords
• Use seo-serp to track ranking progress

[PROTOCOL]: Update this header on changes, then check CLAUDE.md