---
name: content-gap-analysis
description: Find keyword opportunities by analyzing competitor content gaps
argument-hint: "[your-domain]"
---

# Content Gap Analysis

Analyze **$ARGUMENTS** (your domain) to identify content gaps—keyword opportunities where competitors rank but you don't.

**Output:** High-priority keywords saved to `keyword-ideas.csv` for the blog pipeline.

---

## Analysis Workflow

### 1. Identify Your Organic Competitors

Call `mcp__ahrefs__site-explorer-organic-competitors` with:
- `target`: $ARGUMENTS (e.g., "example.com/")
- `mode`: "subdomains"
- `country`: "us"
- `date`: Current date in YYYY-MM-DD format
- `select`: "domain,common_keywords,keywords_competitor,traffic,domain_rating"
- `order_by`: "common_keywords:desc"
- `limit`: 20

Present numbered list. Wait for user to select 3-5 competitors.

### 2. Pull Each Competitor's Top Pages

For each selected competitor, call `mcp__ahrefs__site-explorer-top-pages` with:
- `target`: Competitor domain
- `select`: "url,sum_traffic,keyword_top,keyword_top_volume,keyword_top_best_position,keywords"
- `order_by`: "sum_traffic:desc"
- `limit`: 50-100

Combine results and deduplicate by `keyword_top`.

### 3. Check Which Keywords You Already Rank For

Call `mcp__ahrefs__site-explorer-organic-keywords` for your domain, then cross-reference:
- Positions 1-10 → Already competing (exclude)
- Positions 11-50 → Optimization opportunity
- Not ranking → Candidate gap (validate in 3.5)

### 3.5 Validate Gap Keywords Against Existing Blog Content

For each candidate gap keyword, run:
```
WebSearch: site:[your-domain]/blog/ "[keyword]"
```

Reclassify:
- Article exists + ranks top 10 → Existing content (exclude)
- Article exists + ranks outside top 10 → Update opportunity
- No article + ranks 11-50 → Optimization opportunity
- No article + not ranking → True content gap

### 4. Enrich Gap Keywords with Traffic Potential

Batch gap keywords and call `mcp__ahrefs__keywords-explorer-overview` with:
- `select`: "keyword,volume,traffic_potential,keyword_difficulty,cpc,is_informational,is_commercial,is_transactional"

Sort by `traffic_potential` descending.

### 5. Generate Prioritized Content Gap Report

**Prioritization:**
- HIGH: Traffic potential 500+, KD <40, 2+ competitors ranking
- MEDIUM: Traffic potential 100-500, KD 40-60
- LOW: Traffic potential <100 or KD >60

---

## Saving Keywords to Pipeline

Append to `keyword-ideas.csv`:

```csv
keyword,volume,traffic_potential,difficulty,cpc,priority,source,business_potential,ahrefs_product,rank,selected
```

Leave business_potential, ahrefs_product, rank, and selected empty — populated by other skills.

## Example Usage

```
/content-gap-analysis ahrefs.com
```