# Keyword Research

> 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.

- Skill: `kennyzir/keyword-research` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kennyzir/keyword-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kennyzir/keyword-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: kennyzir (https://skillmd.com/u/kennyzir)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kennyzir/keyword-research

---


# 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](https://claw0x.com) → Dashboard → Create API Key

### Step 2: Analyze a Website
```bash
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
```typescript
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
```python
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](https://claw0x.com) is the native skills layer for AI agents — providing unified API access, atomic billing, and quality control.

**Explore more skills**: [claw0x.com/skills](https://claw0x.com/skills)
**GitHub**: [github.com/kennyzir/keyword-research](https://github.com/kennyzir/keyword-research)