---
name: seo-keyword-strategy
description: |
  Keyword strategy and research for SEO campaigns.
  Triggers: keyword research, keyword analysis, keyword gap, search volume,
  keyword clustering, intent classification, 키워드 전략, 키워드 분석,
  키워드 리서치, 검색량 분석, 키워드 클러스터링.
---

# SEO Keyword Strategy & Research

## Purpose

Expand seed keywords, classify search intent, cluster topics, and identify competitor keyword gaps for comprehensive keyword strategy development.

## Core Capabilities

1. **Keyword Expansion** - Matching terms, related terms, search suggestions
2. **Korean Market** - Suffix expansion, Naver autocomplete, Korean intent patterns
3. **Intent Classification** - Informational, navigational, commercial, transactional
4. **Topic Clustering** - Group keywords into semantic clusters
5. **Gap Analysis** - Find competitor keywords missing from target site

## MCP Tool Usage

### SEO Data (DataForSEO)

**Primary — our-seo-agent CLI:**
```bash
our keywords volume "<keyword>" --location 2410 --language ko
our keywords ideas "<keyword>" --location 2410 --limit 50
our keywords for-site <competitor.com> --location 2410 --limit 100
our keywords intent "<kw1>" "<kw2>" "<kw3>"
our keywords difficulty "<kw1>" "<kw2>"
```

**Interactive fallback — DataForSEO MCP:**
```
mcp__dfs-mcp__dataforseo_labs_google_keyword_overview
mcp__dfs-mcp__dataforseo_labs_google_keyword_ideas
mcp__dfs-mcp__dataforseo_labs_google_keyword_suggestions
mcp__dfs-mcp__dataforseo_labs_search_intent
mcp__dfs-mcp__dataforseo_labs_bulk_keyword_difficulty
mcp__dfs-mcp__kw_data_google_ads_search_volume
mcp__dfs-mcp__dataforseo_labs_google_keywords_for_site
```

### Common Parameters
- **location_code**: 2410 (Korea), 2840 (US), 2392 (Japan)
- **language_code**: ko, en, ja

### Web Search for Naver Discovery
```
WebSearch: Naver autocomplete and trend discovery
```

## Workflow

### 1. Seed Keyword Expansion
1. Input seed keyword (Korean or English)
2. Fetch search volume via `our keywords volume "<seed>" --location 2410 --language ko`
3. Expand with `our keywords ideas "<seed>" --location 2410 --limit 50`
4. Get autocomplete suggestions via MCP: `mcp__dfs-mcp__dataforseo_labs_google_keyword_suggestions`
5. Apply Korean suffix expansion if Korean market
6. Deduplicate and merge results

### 2. Intent Classification & Clustering
1. Classify each keyword by search intent
2. Group keywords into topic clusters
3. Identify pillar topics and supporting terms
4. Calculate cluster-level metrics (total volume, avg KD)

### 3. Gap Analysis
1. Pull organic keywords for target: `our keywords for-site <target.com> --location 2410 --limit 100`
2. Pull organic keywords for competitors: `our keywords for-site <competitor.com> --location 2410 --limit 100`
3. Identify keywords present in competitors but missing from target
4. Score opportunities by volume/difficulty ratio
5. Prioritize by intent alignment with business goals

## Output Format

```markdown
## Keyword Strategy Report: [seed keyword]

### Overview
- Total keywords discovered: [count]
- Topic clusters: [count]
- Total search volume: [sum]

### Top Clusters
| Cluster | Keywords | Total Volume | Avg KD |
|---------|----------|-------------|--------|
| ... | ... | ... | ... |

### Top Opportunities
| Keyword | Volume | KD | Intent | Cluster |
|---------|--------|-----|--------|---------|
| ... | ... | ... | ... | ... |

### Keyword Gaps (vs competitors)
| Keyword | Volume | Competitor Position | Opportunity Score |
|---------|--------|-------------------|-------------------|
| ... | ... | ... | ... |
```

## Notion Output (Required)

All audit reports MUST be saved to OurDigital SEO Audit Log:
- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
- **Properties**: Issue (title), Site (url), Category, Priority, Found Date, Audit ID
- **Language**: Korean with English technical terms
- **Audit ID Format**: KW-YYYYMMDD-NNN
