mcpField
C
competitor-keyword-analysis

competitor-keyword-analysis

github.com/superampedMarketing & growth7379 installsUpdated 10w ago
Repository

About competitor-keyword-analysis

competitor-keyword-analysis is an SEO marketing skill for building a quick view of a competitor’s organic search presence. It uses Keywords Everywhere data to summarize ranked keywords, traffic estimates, and content themes.

Key features

  1. 01Retrieves domain ranking keywords
  2. 02Gets organic traffic estimates
  3. 03Groups keywords into content themes
  4. 04Supports a country-specific analysis
  5. 05Handles an unconfigured MCP gracefully

Use cases

  1. 01Snapshot a competitor’s SEO presence
  2. 02Identify themes in competitor content
  3. 03Prepare input for deeper content analysis

MCP support

It requires the Keywords Everywhere MCP to retrieve domain keywords and traffic metrics. If it is not connected, the skill returns an empty report with a configuration note.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/superamped/ai-marketing-skills --skill competitor-keyword-analysis

After installing, type/competitor-keyword-analysisin Claude Code to confirm it loaded.

Details

From the project README

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

Comments

Markdown supported