Semrush MCP

🚀 Semrush MCP Server

An MCP (Model Context Protocol) server that provides access to Semrush API functionality for AI assistants.

🚀 Quick Start

This Semrush MCP Server offers access to Semrush API functionality for AI assistants. You can use it to perform various SEO - related analyses.

✨ Features

• Domain Overview: Retrieve comprehensive domain analytics, including organic traffic, keywords, and authority score.
• Keyword Research: Analyze keyword metrics such as search volume, difficulty, and CPC.
• Organic Search Analysis: Fetch organic search keywords and rankings for any domain.
• Paid Search Analysis: Obtain Google Ads keywords and PPC data for domains.
• Backlinks Overview: Get backlink metrics and analysis for domains or specific URLs.
• Competitor Research: Identify and analyze organic competitors.
• Related Keywords: Discover related keywords and search suggestions.

📦 Installation

Prerequisites

• Node.js 18+
• A Semrush API key (get one at https://www.semrush.com/api/)

Steps

1. Clone this repository or create a new directory:

mkdir semrush-mcp
cd semrush-mcp

2. Create the following directory structure:

semrush-mcp/
├── src/
│   └── index.ts
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
└── README.md

3. Save the provided files in their respective locations

Then manually:

npm install
npm run build

💻 Usage Examples

Configuration

Set your Semrush API key as an environment variable:

export SEMRUSH_API_KEY="your-api-key-here"

Or create a .env file:

SEMRUSH_API_KEY=your-api-key-here

Usage with Claude Desktop

Add the server to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "semrush": {
      "command": "node",
      "args": ["/path/to/semrush-mcp-server/dist/index.js"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

Basic Usage

Here are some basic usage examples for different tools:

1. domain_overview

Get comprehensive domain analytics.

Parameters:

• domain (required): Domain to analyze (e.g., "example.com")
• database (optional): Database code (default: "us")

2. keyword_overview

Get keyword metrics and data.

Parameters:

• phrase (required): Keyword phrase to analyze
• database (optional): Database code (default: "us")

Advanced Usage

3. domain_organic_search

Get organic search keywords for a domain.

Parameters:

• domain (required): Domain to analyze
• database (optional): Database code (default: "us")
• limit (optional): Number of results (default: 10)
• offset (optional): Offset for pagination (default: 0)

4. backlinks_overview

Get backlinks overview for a domain or URL.

Parameters:

• target (required): Domain or URL to analyze
• target_type (optional): "domain" or "url" (default: "domain")

5. competitor_research

Find organic competitors for a domain.

Parameters:

• domain (required): Domain to analyze
• database (optional): Database code (default: "us")
• limit (optional): Number of competitors (default: 10)

6. domain_adwords

Get paid search (Google Ads) keywords for a domain.

Parameters:

• domain (required): Domain to analyze
• database (optional): Database code (default: "us")
• limit (optional): Number of results (default: 10)

7. related_keywords

Get related keywords and suggestions for a seed keyword.

Parameters:

• phrase (required): Seed keyword phrase
• database (optional): Database code (default: "us")
• limit (optional): Number of results (default: 10)

Database Codes

Common database codes for different regions:

Example Usage in Claude

Once configured, you can use natural language to access Semrush data:

• "Analyze the domain example.com using Semrush"
• "What's the search volume for 'digital marketing' keyword?"
• "Show me the top organic keywords for techcrunch.com"
• "Find competitors for shopify.com"
• "Get backlink data for https://metehan.ai/blog/semrush-mcp/"
• "What related keywords can you find for 'content marketing'?"
• "Show me the Google Ads keywords that amazon.com is bidding on"

📚 Documentation

Development

To run the server in development mode:

npm run dev

Troubleshooting

• API Key Issues: Ensure your SEMRUSH_API_KEY environment variable is set correctly.
• Rate Limits: Semrush API has rate limits. Check your plan's limits.
• Database Codes: Make sure you're using valid database codes for your target regions.

📄 License

MIT