Keyword Research Tool MCP Server

Keyword Research Tool MCP Server

An MCP (Model Context Protocol) server that provides comprehensive SEO keyword research and analysis capabilities. This server adapts the functionality from the original boringmarketer/keyword-research-tool into a single, powerful MCP tool.

Features

🔍 Comprehensive Analysis

• Website content crawling and analysis using Firecrawl
• AI-powered seed keyword generation with Perplexity
• Search volume and competition data via DataForSEO
• Smart keyword clustering and competitor analysis
• Timestamped report generation

📊 Detailed Reports

• Keyword clusters with commercial intent scoring
• Quick wins (low competition opportunities)
• High-value targets (commercial keywords)
• Competitor domain analysis with AI research
• Actionable SEO strategy recommendations
• Dual format: JSON (technical) + Text (human-readable)
• Professional text reports matching original HTML tool format

🎯 Business-Focused

• Auto-detects and optimizes for business type
• Commercial intent scoring for ROI focus
• Industry-specific keyword suggestions
• Professional report format

Prerequisites

You'll need API keys from these services:

Required APIs

1. Firecrawl (Website Scraping)

   • Sign up at: https://firecrawl.dev/
   • Format: fc-xxxxxxxxxx
   • Cost: ~$0.01 per website scrape

2. Perplexity (AI Keyword Generation)

   • Sign up at: https://www.perplexity.ai/
   • Format: pplx-xxxxxxxxxx
   • Cost: ~$0.02 per keyword generation

3. DataForSEO (Keyword & SERP Data)

   • Sign up at: https://dataforseo.com/
   • Uses your login credentials (username/password)
   • Cost: ~$0.50-1.00 per analysis

Total estimated cost per analysis: ~$0.53-1.03

Installation

1. Clone and install dependencies:

git clone <this-repo>
cd keyword-research-tool-mcp
npm install
npm run build

2. Add to your MCP client configuration (e.g., in Claude Desktop's config):

{
  "mcpServers": {
    "seo-keyword-research": {
      "command": "node",
      "args": ["path/to/keyword-research-tool-mcp/dist/index.js"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-xxxxxxxxxxxxxxxxxxxxxxxxxx",
        "PERPLEXITY_API_KEY": "pplx-xxxxxxxxxxxxxxxxxxxxxxxxxx",
        "DATAFORSEO_USERNAME": "your-username",
        "DATAFORSEO_PASSWORD": "your-password"
      }
    }
  }
}

If you are running a tool like Cursor or Windsurf, you may need to remind it to search for API keys in the above JSON file.

3. Build the Server

npm run build

Usage

The server provides one comprehensive tool:

`analyze_website`

Performs complete SEO keyword research and analysis for any website.

Parameters:

• website_url (string): Website URL to analyze (e.g., "https://example.com")
• business_type (enum): Business type for targeted analysis
  • Options: "E-commerce", "SaaS", "Service Business", "Blog/Content", "Education", "Other"
• firecrawl_api_key (string): Firecrawl API key (format: fc-xxxxxxxxxx)
• perplexity_api_key (string): Perplexity API key (format: pplx-xxxxxxxxxx)
• dataforseo_username (string): DataForSEO username (your email)
• dataforseo_password (string): DataForSEO password

Example Usage:

analyze_website({
  "website_url": "https://example.com",
  "business_type": "SaaS", 
  "firecrawl_api_key": "fc-your-key-here",
  "perplexity_api_key": "pplx-your-key-here",
  "dataforseo_username": "your@email.com",
  "dataforseo_password": "your_password"
})

Output

The analysis generates:

Console Output

• Analysis Summary: Total keywords, search volume, traffic potential
• Quick Wins: Low competition opportunities for immediate targeting
• High-Value Targets: Keywords with highest commercial potential
• Top Keyword Clusters: Organized keyword groups with metrics
• Main Competitors: Competing domains identified
• Report Location: Path to detailed JSON report

Saved Reports

Timestamped reports are automatically saved to reports/ directory in two formats:

JSON Report (<company domain>_YYYY-MM-DD_HH-MM-SS.json):

• Complete analysis data for technical use
• All keyword metrics and search volumes
• Competitor domains and SERP analysis
• Commercial intent scores
• Clustering analysis
• Raw API response data

Text Report (<company domain>_YYYY-MM-DD_HH-MM-SS_formatted.txt):

• Comprehensive formatted report matching the original HTML tool
• Executive summary with key metrics
• Quick wins section (low competition opportunities)
• High-value targets (commercial keywords)
• Detailed keyword clusters with complete breakdowns
• Competitor analysis with AI and SERP sources
• Strategic action plan (immediate, medium-term, long-term)
• Raw analysis data section
• Professional formatting with ASCII art borders

Analysis Process

The tool follows the same comprehensive process as the original app.js:

1. Website Scraping: Ex