keyword-research

name	Keyword Research
slug	keyword-research
description	Full-site keyword research with three-phase funnel. Use when you need to find SEO keyword opportunities for a website. Analyzes site topics, expands 30+ candidate keywords, runs SERP competition analysis on top 10, and recommends top 3 keywords with actionable landing page suggestions.
category	SEO & Content
tags	["seo","keyword-research","serp-analysis","competition-analysis","content-strategy"]
price_per_call	0.015
input_schema	{"type":"object","properties":{"domain":{"type":"string","description":"Website domain or URL to analyze"},"max_candidates":{"type":"number","description":"Max keywords in Phase 1 (default: 30, max: 50)"},"max_analyze":{"type":"number","description":"Max keywords for SERP analysis in Phase 2 (default: 10, max: 20)"}},"required":["domain"]}
output_schema	{"type":"object","properties":{"site_analysis":{"type":"object","description":"Site type, core topics, target audience"},"phase1_candidates":{"type":"array","description":"30+ candidate keywords with source and layer"},"phase2_serp_analysis":{"type":"array","description":"SERP competition analysis for top 10 keywords"},"phase3_top_keywords":{"type":"array","description":"Top 3 recommended keywords with action plans"},"summary":{"type":"object","description":"Competition distribution summary"}}}
metadata	{"requires":{"env":["CLAW0X_API_KEY"]}}

Keyword Research

Three-phase keyword research funnel: 30+ candidates → 10 SERP analyses → 3 actionable keywords.

$0.015 per successful call. Failed calls are free.

Quick Reference

When This Happens	Do This	What You Get
Starting SEO for a new site	Send domain	Full keyword research report
Need content ideas	Send domain + max_candidates: 50	50 keyword opportunities
Quick competition check	Send domain + max_analyze: 5	Fast competition overview

5-Minute Quickstart

Step 1: Get API Key

Sign up at claw0x.com → Dashboard → Create API Key

Step 2: Analyze a Website

curl -X POST https://api.claw0x.com/v1/call \
  -H "Authorization: Bearer YOUR_CLAW0X_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skill": "keyword-research",
    "input": { "domain": "example.com" }
  }'

Step 3: Get Your Report

The response includes three phases:

• Phase 1: 30+ candidate keywords with source labels
• Phase 2: SERP competition analysis (score 5-25, low/medium/high)
• Phase 3: Top 3 keywords with landing page recommendations

Three-Phase Funnel

Phase 1: Expand (30+ keywords)
  ├── Site topic analysis
  ├── Search result mining
  ├── AI-powered expansion (product, question, comparison, long-tail)
  └── Deduplication + relevance scoring

Phase 2: Analyze (10 keywords)
  ├── SERP competition scoring (5 dimensions)
  ├── High-authority site detection
  ├── Content depth assessment
  └── Competition level: 🟢 low / 🟡 medium / 🔴 high

Phase 3: Recommend (3 keywords)
  ├── Lowest competition first
  ├── Opportunity description
  ├── Recommended action plan
  └── Landing page blueprint (title, core points, CTA)

Competition Scoring Model

Dimension	1 (Easy)	3 (Medium)	5 (Hard)
Ads	0	3-5	8+
Authority sites	0	2-3	5+
Content depth	All thin	Mixed	All deep
Result count	Few	Moderate	Many
Domain diversity	Low	Medium	High

• Total 5-10 → 🟢 Low competition (act now)
• Total 11-17 → 🟡 Medium competition (differentiate)
• Total 18-25 → 🔴 High competition (observe)

Real-World Use Cases

Scenario 1: New SaaS Launch

Problem: Just launched a SaaS product, need to find SEO opportunities. Solution: Send your domain → get 30+ keyword ideas categorized by layer (core/mid-tail/long-tail/question). Result: Actionable keyword strategy with competition data in seconds.

Scenario 2: Content Calendar Planning

Problem: Need to plan next month's blog content. Solution: Run keyword research → use Phase 3 recommendations as content topics. Result: 3 data-backed content ideas with landing page blueprints.

Scenario 3: Competitor Analysis

Problem: Want to know what keywords competitors are targeting. Solution: Send competitor's domain → analyze their keyword landscape. Result: Keyword gaps and opportunities to outrank them.

Integration Recipes

OpenClaw Agent

const result = await claw0x.call('keyword-research', {
  domain: 'competitor.com',
  max_candidates: 40,
  max_analyze: 15,
});

const lowComp = result.data.phase3_top_keywords;
console.log(`Top opportunity: ${lowComp[0]?.keyword}`);

LangChain Agent

response = requests.post(
    "https://api.claw0x.com/v1/call",
    headers={"Authorization": f"Bearer {CLAW0X_API_KEY}"},
    json={"skill": "keyword-research", "input": {"domain": "example.com"}}
)
report = response.json()["data"]
for kw in report["phase3_top_keywords"]:
    print(f"{kw['keyword']} — {kw['competition_level']} — {kw['opportunity']}")

Error Handling

Error	Cause	Solution
400	Missing or invalid domain	Provide a valid domain (e.g. "example.com")
401	Missing or invalid API key	Check your CLAW0X_API_KEY
500	Internal error (not billed)	Retry or contact support

Pricing

$0.015 per successful call. Failed calls are free.

• Includes site analysis + keyword expansion + SERP analysis
• Pay only for successful responses (2xx status)
• No monthly fees, no subscriptions

Why Use Via Claw0x?

• Unified billing: One API key for all skills
• Atomic pricing: Pay per call, not per month
• Zero cost on failure: Failed calls don't charge
• Production-ready: 99.9% uptime, low latency
• Security scanned: OSV.dev integration

About Claw0x

Claw0x is the native skills layer for AI agents — providing unified API access, atomic billing, and quality control.

Explore more skills: claw0x.com/skills GitHub: github.com/kennyzir/keyword-research