SEO Keyword Metrics

Credentials Check

DATAFORSEO_LOGIN

DATAFORSEO_PASSWORD

"DataForSEO credentials are not configured. Please run

seo-seed-discovery

first — it will guide you through the setup."

When to Use

seo-keyword-expansion

candidate-pool.json

Prerequisites

• Workspace with

  candidate-pool.json

  (merged from expansion results)

Procedure

Step 1: Bulk Search Volume

node {baseDir}/scripts/bulk-volume.ts --workspace <workspace_path>

volume.json

Step 2: Bulk Keyword Difficulty

node {baseDir}/scripts/bulk-kd.ts --workspace <workspace_path>

kd.json

Step 3: Search Intent Classification

node {baseDir}/scripts/search-intent.ts --workspace <workspace_path>

intent.json

metrics.json

Expert Analysis Framework

1. Volume Distribution: What's the volume range? Are there hidden gems in the 100-1000 range?
2. KD vs Volume Efficiency: Plot keywords on a KD/Volume matrix. Find the "sweet spot" — reasonable volume with manageable difficulty
3. Intent Distribution: What percentage is informational vs commercial? Does this match the user's content strategy?
4. CPC as Signal: High CPC keywords often indicate commercial value even if volume is low
5. Quick Win Candidates: Low KD + decent volume keywords the domain could rank for quickly

Output Format

• Metrics Summary (total keywords, average volume, average KD)
• Distribution Analysis (volume tiers, KD tiers, intent breakdown)
• Top 15 Sweet Spot Keywords (high value / achievable difficulty)
• Quick Win List (KD < 30, Volume > 100)