Semrush MCP Server

A Model Context Protocol (MCP) server implementation that provides tools for accessing Semrush API data.

Features

The Semrush MCP server provides tools for:

• Domain Analytics
• Domain overview information
• Organic and paid keywords analysis
• Competitor analysis

• Keyword Analytics
• Keyword overview data
• Related keyword discovery

• Backlink Analysis
• Backlink data
• Referring domains analysis

• Traffic Analytics
• Traffic summary for domains
• Traffic sources analysis
• (Note: Requires .Trends API subscription)

Setup

1. Clone the repository

2. Install dependencies:

npm install

3. Create a .env file with your Semrush API key:

SEMRUSH_API_KEY=your_api_key_here

4. Build the project:

npm run build

5. Start the server:

npm run start

Environment Variables

Available Tools

Parameters in [brackets] are optional.

API Units Consumption

API requests to Semrush consume API units from your account. Different types of requests have different costs. You can check your API units balance using the semrush_api_units_balance tool.

Keyword Reports API Units Consumption

Adding to Cursor or Claude

To add this MCP server to Cursor or Claude:

Cursor

1. In Cursor, go to Settings > MCP Servers

2. Click "Add Server"

3. Configure the server with the following settings:

• Name: Semrush MCP (or any name you prefer)
• Type: command
• Command: node
• Arguments: /path/to/semrush-mcp/dist/index.js (replace with your actual path)
• Environment Variables:
• SEMRUSH_API_KEY: Your Semrush API key
• Other optional variables as needed

4. Click "Save"

Usage Using NPX

Using Environment Variables in Cursor/Claude/Windsurf Configuration

Configure your MCP servers JSON file for your designated consuming environment by adding this MCP using the following format:

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:mrkooblu/semrush-mcp"
      ],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Running it from your terminal:

SEMRUSH_API_KEY=your-api-key npx -y github:mrkooblu/semrush-mcp

Development

To run the server in development mode:

npm run dev

Security Notes

• Never share your Semrush API key publicly
• API key provides access to your API units balance
• Exposing credentials can lead to unauthorized API usage and unexpected charges

License

MIT