SEO Seed Discovery

First-Time Setup

DATAFORSEO_LOGIN

DATAFORSEO_PASSWORD

1. Ask: "Do you have a DataForSEO account? If not, it takes 2 minutes to register at https://dataforseo.com — they give ~$10 free trial credit, which is enough for dozens of analyses."
2. Ask the user to provide their login email and password.
3. Then guide them to configure credentials using one of these methods:
   Method A — OpenClaw UI (macOS):

   Skills → seo-seed-discovery → Configure → enter email + password

   Method B — openclaw.json:
   json

   // ~/.openclaw/openclaw.json
   {
     "skills": {
       "entries": {
         "seo-seed-discovery": {
           "env": {
             "DATAFORSEO_LOGIN": "your@email.com",
             "DATAFORSEO_PASSWORD": "yourpassword"
           }
         }
       }
     }
   }

   Method C — shell environment:
   bash

   export DATAFORSEO_LOGIN=your@email.com
   export DATAFORSEO_PASSWORD=yourpassword

4. Once configured, restart the session and proceed with the analysis.

Cost estimate: A full keyword analysis (seed → strategy) costs approximately $0.50–$1.00 in DataForSEO API credits. Repeated analyses on the same topic are free due to 1-hour caching.

When to Use

Prerequisites

• DATAFORSEO_LOGIN

  and

  DATAFORSEO_PASSWORD

  configured (see First-Time Setup above)
• User provides: product description, target URL, or industry keywords

Procedure

Step 1: Initialize Workspace

node {baseDir}/scripts/init-workspace.ts --workspace <workspace_path> --domain <user_domain> --keywords '["keyword1","keyword2","keyword3"]'

config.json

Step 2: Discover SEO Competitors from SERP

node {baseDir}/scripts/serp-competitors.ts --workspace <workspace_path>

competitors.json

Step 3: Extract Competitor Keywords

node {baseDir}/scripts/competitor-keywords.ts --workspace <workspace_path>

competitor-keywords.json

Step 4: Keyword Gap Analysis

node {baseDir}/scripts/keyword-gap.ts --workspace <workspace_path>

keyword-gap.json

Expert Analysis Framework

1. Competitor Landscape: Which competitors appear most frequently? What type of content dominates (blog, product page, landing page)?
2. Keyword Gap Opportunities: Which competitor keywords represent untapped potential for the user's domain?
3. Seed Quality Assessment: Are the initial seed keywords too broad or too narrow? Suggest refinements.
4. Content Gap Insights: What content types or topics are competitors covering that the user is missing?

Output Format

• Discovered Competitors (domain, frequency in SERPs, estimated authority)
• Top Keyword Gap Opportunities (keyword, competitor position, estimated volume)
• Recommended Seed Keywords for expansion in the next step
• Strategic Insights based on competitive landscape