# Competitor keyword analysis Human Guide

## What This Is For
Use for a quick SEO snapshot of a competitor's organic presence, or as input to competitor-content-analysis for deeper content strategy mapping. It gives the agent a clearer input/output frame for competitive research: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the Competitor keyword analysis agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for competitor keyword analysis.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the Competitor keyword analysis guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- **Competitor name** — the company to analyze
- **Competitor domain** — e.g., `example.com` (no protocol)
- **Country code** (optional) — defaults to "us"
- **domain:** competitor domain
- **country:** from input or "us"
- **domains:** [competitor domain]
- **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
- 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.

## Decision Points And Nuance
The original skill emphasizes: Usage, Process, Step 1: Gather Inputs, Step 2: Validate MCP, Step 3: Domain Keywords, Step 4: Traffic Metrics, Step 5: Cluster into Content Themes, Output Format, Top Keywords, Content Themes.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- **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.
- 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.

## Copy-And-Paste Prompt
```text
Use the Competitor keyword analysis human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the superamped/ai-marketing-skills skill entry for `competitor-keyword-analysis`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# Competitor Keyword Analysis

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