42-keyword-discovery

name: 42-keyword-discovery description: > Keyword discovery en ideation vanuit seed keywords. Haalt suggestions, related keywords, zoekvolume en difficulty op via DataForSEO. Classificeert intent, berekent opportunity scores, en identificeert quick wins + GEO-kansen. Werkt ook zonder API in mock-modus voor LLM-gestuurde expansie. Use when user says "keyword discovery", "keyword ideeën", "zoekwoord suggesties", "keyword ideas", "find keywords", "welke zoekwoorden", "waar moet ik over schrijven", "keyword research", "seed keywords uitbreiden", "zoekwoord onderzoek". version: 1.0.0 tags: [seo, keywords, discovery, ideation, dataforseo, intent, opportunity, geo] allowed-tools:

• Bash
• Read
• Write
• Grep
• Glob
• WebFetch metadata: filePattern:
  • "**/keyword"
  • "**/discovery"
  • "**/seed" bashPattern:
  • "keyword.discover"
  • "discover.py"
  • "keyword.research"

Keyword Discovery — Seed to Strategy

Purpose

Transformeer een handvol seed keywords naar een complete, geprioriteerde keyword lijst met zoekvolume, difficulty scores, intent classificatie en opportunity ranking. Dit is de "ik heb nog niks, waar begin ik" skill die alle andere keyword-skills voedt.

Twee modi:

1. Live (default) -- DataForSEO API voor echte volume/difficulty data
2. Mock -- LLM-gestuurde keyword expansie zonder API calls

Commands

/42:keyword-discovery <seed>
/42:keyword-discovery <seed> --location nl --language nl
/42:keyword-discovery seeds.csv --limit 100
/42:keyword-discovery <seed> --mock

Parameters

API Configuratie

DataForSEO Credentials

Het script zoekt credentials in deze volgorde:

1. Environment variables: DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD
2. Bestaande seo-agi config: ~/.config/seo-agi/.env
3. Project config: 42-reports/<domain>/.env

Kosten: ~$0.002 per keyword suggestie API call. Twee calls per seed keyword (suggestions + related), dus ~$0.004 per seed.

Workflow

Step 1: Parse Seeds

• String input: Gebruik als enkel seed keyword
• CSV/TXT input: Lees alle keywords uit bestand
  • CSV: zoekt kolom keyword, query, of seed
  • TXT: een keyword per regel

Step 2: DataForSEO Calls (live modus)

Per seed keyword twee API calls:

1. Keyword Suggestions (/dataforseo_labs/google/keyword_suggestions/live) -- Brede ideation, ontdekt gerelateerde termen die je niet zou bedenken
2. Related Keywords (/dataforseo_labs/google/related_keywords/live) -- Nauwer gerelateerde varianten met overlap in SERP rankings

Elk resultaat bevat: keyword, zoekvolume, CPC, competition score, difficulty.

Step 3: Deduplicatie + Verrijking

• Dedupliceer op genormaliseerde keyword string
• Classificeer intent per keyword (transactional/commercial/informational/navigational)
• Bereken opportunity score: (Volume x Intent Value) / max(Difficulty, 1)
  • Intent values: transactional=3, commercial=2, informational=1

Step 4: Segmentatie

Het script produceert vier lijsten:

Step 5: Output

Drie bestanden:

1. keyword-discovery.md -- Volledig rapport met tabellen en actieplan
2. keyword-discovery.csv -- Machine-readable export voor andere skills
3. keyword-discovery.json (optioneel) -- Gestructureerde data

Mock Modus (zonder API)

Wanneer --mock is opgegeven of geen credentials beschikbaar zijn, genereer keyword variaties via patronen:

Expansion Patterns

Pas deze patronen toe op elk seed keyword:

Let op: Mock modus heeft geen volume/difficulty data. Gebruik het alleen als startpunt en verifieer met DataForSEO of GSC data.

Output Voorbeeld

# Keyword Discovery Report

**Seeds:** zonnepanelen
**Mode:** DataForSEO (live data)
**Total keywords found:** 127

## Quick Wins (high volume, low difficulty)

| Keyword | Volume | Difficulty | Intent | Opportunity |
|---------|--------|------------|--------|-------------|
| zonnepanelen subsidie 2026 | 2400 | 28 | informational | 85.7 |
| zonnepanelen plat dak | 1900 | 22 | informational | 86.4 |
| hoeveel zonnepanelen nodig | 1600 | 18 | informational | 88.9 |

## GEO Opportunities (question keywords for AI citations)

| Keyword | Volume | Difficulty | Opportunity |
|---------|--------|------------|-------------|
| hoeveel zonnepanelen heb ik nodig | 1600 | 18 | 88.9 |
| wat kosten zonnepanelen | 3200 | 35 | 91.4 |
| hoe werken zonnepanelen | 880 | 15 | 58.7 |

Concrete Actieplan na Discovery

Na het draaien van deze skill, gebruik de output als input voor andere skills:

Direct opvolging (data-driven)

Met bestaande site data (vereist SF + GSC)

Content creatie (op basis van resultaten)

Monitoring (na publicatie)

Integratie met seo-project Orchestrator

Deze skill wordt aanbevolen in Phase 3 (STRATEGIZE) van /seo-project:

• Na de baseline audit (Phase 1) en diagnose (Phase 2)
• Seeds komen uit de diagnose: underperforming categorieën, missed topics
• Output voedt de implementation waves in Phase 4

Kan ook standalone gebruikt worden zonder actief seo-project.

Skill Afhankelijkheden