Ubersuggest MCP Server

An MCP (Model Context Protocol) server that integrates Neil Patel's Ubersuggest SEO platform with Cursor IDE, enabling AI-assisted SEO analysis directly within your development environment.

Features

• Domain Overview: Comprehensive domain analysis including traffic and ranking data
• Keyword Research: Research keywords with volume, difficulty, and competition metrics
• Site Audit: Perform technical SEO audits to identify optimization opportunities
• Traffic Estimation: Estimate organic traffic potential for domains

Prerequisites

• Node.js v16 or higher
• Ubersuggest account credentials
• Cursor IDE with MCP support

Installation

1. Clone the repository:

git clone https://github.com/yourusername/mcp-ubersuggest.git
cd mcp-ubersuggest

2. Install dependencies:

npm install

3. Create a .env file based on .env.example:

cp .env.example .env

4. Add your Ubersuggest credentials to .env:

UBERSUGGEST_USERNAME=your-email@example.com
UBERSUGGEST_PASSWORD=your-password

Usage

Running the MCP Server

npm start

For development with auto-reload:

npm run dev

Configuring Cursor IDE

Add the following to your Cursor IDE's MCP configuration:

{
  "mcpServers": {
    "ubersuggest-seo": {
      "command": "node",
      "args": ["/path/to/mcp-ubersuggest/src/index.js"],
      "env": {
        "UBERSUGGEST_USERNAME": "your-email@example.com",
        "UBERSUGGEST_PASSWORD": "your-password"
      }
    }
  }
}

Available Tools

1. Domain Overview

ubersuggest_domain_overview
- Analyzes domain performance metrics
- Parameters: domain (required), country (optional)

2. Keyword Research

ubersuggest_keyword_research
- Researches keywords with detailed metrics
- Parameters: keyword (required), language (optional), location (optional)

3. Site Audit

ubersuggest_site_audit
- Performs technical SEO audit
- Parameters: url (required), pages_limit (optional)

4. Traffic Estimation

ubersuggest_traffic_estimation
- Estimates organic traffic potential
- Parameters: domain (required), period (optional)

Legal Notice

⚠️ IMPORTANT: This is an unofficial integration that uses reverse-engineered endpoints. Using this tool may violate Ubersuggest's Terms of Service. Users are responsible for:

• Reviewing and complying with Ubersuggest's Terms of Service
• Understanding the legal risks of web scraping
• Using conservative rate limits to minimize server impact
• Accepting all risks associated with using this unofficial integration

Security Considerations

• Credentials are stored in environment variables
• All API communications use HTTPS
• Rate limiting is implemented to prevent detection
• Session tokens are managed securely

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

License

MIT License - see LICENSE file for details

Support

For issues and questions, please use the GitHub issue tracker.

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Neil Patel or Ubersuggest. Use at your own risk.