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

``bash
npm install @appcellent/supaseo
`

Or clone and build:

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

Configuration

Create a .env file:

`env
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:

`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

`bash


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

$3

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

$3

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

$3

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)

$3

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