@gdm-pixel/neuronwriter-mcp

🔐 Subscription-Based NeuronWriter MCP

SEO content optimization and analysis.

⚠️ Requires Nova-Mind Cloud subscription - Starting at €39/month

💎 Open Source Code + Cloud Services

✅ Code is open - Audit, learn, modify freely
🔐 Usage requires subscription - Backend authentication & infrastructure

👉 View pricing | Plans: €39 / €89 / €149 per month

✨ Features

• 🔍 Competitor Analysis - Analyze top-ranking competitors for any keyword
• 📊 Keyword Extraction - Extract valuable keywords with search volume data
• 🎯 SEO Optimization - Get actionable recommendations for content optimization
• 🌐 Multi-language - Support for multiple languages and search engines
• 📈 SERP Data - Real-time search engine results page analysis
• ⚡ Fast Integration - Quick setup with Claude Desktop

📦 Installation

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "neuronwriter-mcp": {
      "command": "npx",
      "args": ["-y", "@gdm-pixel/neuronwriter-mcp@latest"],
      "env": {
        "NEURONWRITER_API_KEY": "your-api-key-here",
        "DEFAULT_PROJECT_ID": "your-project-domain.com",
        "DEFAULT_ENGINE": "google.com",
        "DEFAULT_LANGUAGE": "English"
      }
    }
  }
}

Config location:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

⚙️ Configuration

Required Environment Variables

| Variable | Description | Example | |----------|-------------|---------| | NEURONWRITER_API_KEY | Your NeuronWriter API key | n-abc123... |

Optional Environment Variables

| Variable | Description | Default | Example | |----------|-------------|---------|---------| | DEFAULT_PROJECT_ID | Default project/domain | None | example.com | | DEFAULT_ENGINE | Default search engine | google.com | google.fr, google.de | | DEFAULT_LANGUAGE | Default content language | English | French, Spanish |

Getting Your API Key

1. Log in to NeuronWriter
2. Go to Settings → API
3. Generate your API key
4. Copy and paste into your config

🚀 Usage

Analyze Competitors for a Keyword

Analyze SEO competitors for "best coffee makers 2024"

Returns:

• Top 10-20 competitor URLs
• Title tags and meta descriptions
• Content length and structure
• Keyword usage patterns

Extract Keywords with Search Volume

Extract keywords from this competitor: https://example.com/article

Returns:

• Primary and secondary keywords
• Search volume data
• Keyword difficulty scores
• Related search terms

Get SEO Recommendations

What SEO improvements should I make for the keyword "digital marketing tips"?

Returns:

• Content gap analysis
• Recommended keywords to include
• Optimal content length
• Title and meta description suggestions

📋 Available Tools

Competitor Analysis

Analyze top-ranking content for target keywords.

Parameters:

• keyword (required) - Target keyword to analyze
• engine (optional) - Search engine (default: config)
• language (optional) - Content language (default: config)
• limit (optional) - Number of competitors (default: 10)

Keyword Extraction

Extract keywords from competitor URLs.

Parameters:

• url (required) - Competitor URL to analyze
• project_id (optional) - Project ID (default: config)

SEO Optimization

Get optimization recommendations for content.

Parameters:

• keyword (required) - Target keyword
• content (optional) - Your content to analyze
• language (optional) - Content language (default: config)

🔧 Troubleshooting

Authentication Issues

Problem: "Invalid API key" or authentication errors

Solutions:

• Verify your API key is correct (starts with n-)
• Check your NeuronWriter subscription is active
• Ensure no extra spaces in the API key
• Try regenerating the API key in NeuronWriter settings

Analysis Fails

Problem: Competitor analysis returns no results

Solutions:

• Verify the keyword has search volume
• Check the search engine setting matches your target market
• Try a more specific or popular keyword
• Ensure language setting matches content language

Rate Limiting

Problem: "Too many requests" errors

Solutions:

• Wait a few minutes between large batches
• Reduce the number of competitors analyzed
• Check your NeuronWriter plan limits
• Contact NeuronWriter support for API limits

🌐 Supported Search Engines

• Google: google.com, google.fr, google.de, google.es, google.it, google.co.uk, etc.
• Other engines: Check NeuronWriter documentation for full list

🗣️ Supported Languages

English, French, Spanish, German, Italian, Portuguese, Dutch, Polish, Russian, Japanese, Chinese, and more.

Check NeuronWriter documentation for complete language list.

📄 License

MIT © Charles Annoni

🔗 Links

• NPM Package
• NeuronWriter Official Site
• Report Issues
• MCP Documentation

🙏 Credits

Created by Charles Annoni (GDM-Pixel)

Part of the Nova-Mind ecosystem - AI-powered coaching platform.