competitor-keyword-analysis v1.0A

Immutable. This exact content is served forever at /api/v1/blob/ba6ec49fd482e37a.

---
name: competitor-keyword-analysis
description: "Map a competitor's organic search presence using Keywords Everywhere MCP — top keywords, traffic metrics, and content theme clusters."
compatibility: "Requires Keywords Everywhere MCP. Returns empty data gracefully if not connected."
metadata:
  author: superamped
  version: "1.0"
  website: "https://superamped.com"
---

# Competitor Keyword Analysis

Map a competitor's organic search presence: what keywords they rank for, how much traffic they earn, and what content themes dominate their SEO footprint. Uses Keywords Everywhere MCP for all data.

This skill maps a COMPETITOR's existing rankings (`get_domain_keywords`, `get_domain_traffic_metrics`). It is distinct from keyword-research, which expands YOUR seed keywords.

## Usage

Use for a quick SEO snapshot of a competitor's organic presence, or as input to competitor-content-analysis for deeper content strategy mapping.

## Process

### Step 1: Gather Inputs

Ask the user for:
1. **Competitor name** — the company to analyze
2. **Competitor domain** — e.g., `example.com` (no protocol)
3. **Country code** (optional) — defaults to "us"

### Step 2: Validate MCP

Check that Keywords Everywhere MCP is connected.

**If not connected**, return empty data with the note: "Keywords Everywhere MCP not configured — SEO data not available." Don't block the user — return gracefully.

### Step 3: Domain Keywords

Pull `get_domain_keywords`:
- **domain:** competitor domain
- **country:** from input or "us"
- **num:** 100

This returns the top keywords the competitor ranks for, with estimated monthly traffic and SERP position per keyword.

### Step 4: Traffic Metrics

Pull `get_domain_traffic_metrics`:
- **domains:** [competitor domain]
- **country:** same as Step 3

This returns estimated monthly organic traffic and total ranking keywords for the domain.

### Step 5: Cluster into Content Themes

Group the top keywords into 3-5 content themes by topic similarity. For each theme:
- **Theme name** — descriptive label (e.g., "project management guides", "pricing comparisons")
- **Keywords in theme** — count
- **Combined estimated traffic** — sum of traffic for keywords in the theme
- **Top keyword** — highest-traffic keyword in the theme

These themes represent the competitor's content pillars from an SEO perspective.

## Output Format

```
# Keyword Analysis: [Competitor Name]

**Domain:** [domain]
**Date:** [current date]
**Estimated monthly organic traffic:** [X]
**Total ranking keywords:** [X]

## Top Keywords

| Keyword | Est. Monthly Traffic | SERP Position |
|---------|---------------------|---------------|
| | | |

## Content Themes

| Theme | Keywords | Combined Traffic | Top Keyword |
|-------|----------|-----------------|-------------|
| | | | |

## Data Sources
- Keywords Everywhere: connected / not connected
- Country: [code]
- Domain keywords pulled: [count]
```

## Rules

- Never invent traffic numbers — all data comes from Keywords Everywhere.
- Never call `get_related_keywords` or `get_pasf_keywords` — those are for keyword expansion, not competitor mapping.
- If the domain returns very few keywords (< 10), the competitor may have minimal organic presence or the domain may be wrong — flag it.
- If traffic metrics return zero, the domain may be too new or not indexed — flag it.
- If Keywords Everywhere MCP is not connected, clearly state that and return an empty report structure.