SupaSEO - MCP Server for SEO Content Creation

AI-powered SEO content creation tools via Model Context Protocol (MCP).

Features

• keyword_research - Keyword data via DataForSEO (volume, CPC, difficulty, related keywords)
• content_write - SEO-optimized content generation via Claude AI
• image_prompt - AI image prompts for Midjourney/DALL-E
• quality_check - SEO analysis (readability, keyword density, structure)

Installation

npm install @appcellent/supaseo

Or clone and build:

git clone https://github.com/appcellent/supaseo.git
cd supaseo
npm install
npm run build

Configuration

Create a .env file:

DATAFORSEO_LOGIN=your_login
DATAFORSEO_PASSWORD=your_password
ANTHROPIC_API_KEY=your_api_key

Usage with Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "supaseo": {
      "command": "npx",
      "args": ["@appcellent/supaseo"],
      "env": {
        "DATAFORSEO_LOGIN": "your_login",
        "DATAFORSEO_PASSWORD": "your_password",
        "ANTHROPIC_API_KEY": "your_api_key"
      }
    }
  }
}

CLI Testing

# Keyword research
npm run test:keyword "your keyword"

# Content generation
npm run test:content "your keyword"

# Image prompts
npm run test:image "your keyword"

# Quality check
npm run test:quality "your keyword"

Output files are saved to ./output/ folder.

Tools

keyword_research

Research keywords with search volume, CPC, difficulty, and related keywords.

Input:

• keyword (string) - Seed keyword
• country (US, UK, TR, etc.) - Target country
• language (en, tr, etc.) - Language code
• limit (number) - Max related keywords

content_write

Generate SEO-optimized content with Claude AI.

Input:

• keyword (string) - Target keyword
• title (string) - Article title
• type (guide, listicle, review, comparison, tutorial, news)
• wordCount (number) - Target word count
• tone (professional, casual, friendly, authoritative)
• includeSchema (boolean) - Include Schema.org JSON-LD
• includeFAQ (boolean) - Include FAQ section

image_prompt

Generate AI image prompts for Midjourney and DALL-E.

Input:

• keyword (string) - Main topic
• title (string) - Context title
• style (modern, vintage, illustration, photorealistic, etc.)
• count (number) - Number of prompts
• aspectRatio (16:9, 4:3, 1:1, etc.)
• purpose (featured, hero, thumbnail, social)

quality_check

Analyze content for SEO quality.

Input:

• content (string) - Markdown content
• targetKeyword (string) - Primary keyword
• secondaryKeywords (string[]) - Optional secondary keywords

Output:

• Overall SEO score (0-100)
• Readability (Flesch-Kincaid)
• Keyword density
• Content structure analysis
• Issues and suggestions

License

MIT