MCP Ubersuggest

🚀 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.

🚀 Quick Start

The Ubersuggest MCP Server integrates the Ubersuggest SEO platform with Cursor IDE, allowing you to conduct SEO analysis right in your development environment. Follow the installation steps below to get started.

✨ Features

• Domain Overview: Conduct 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 the organic traffic potential of domains.

📦 Installation

Prerequisites

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

Steps

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 Examples

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

Domain Overview

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

Keyword Research

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

Site Audit

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

Traffic Estimation

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

📚 Documentation

Legal Notice

⚠️ Important Note

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.

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.

📄 License

This project is released under the MIT License. See the LICENSE file for details.