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, Claude, or Cline

You can add this MCP server to various AI coding assistants:

Installation Options

Option 1: Install Globally (Recommended)

Install the package globally to use it with any AI assistant:

npm install -g semrush-mcp

Option 2: Install from Source

Clone and build the repository:

git clone https://github.com/thomaswawra/semrush-mcp.git
cd semrush-mcp
npm install
npm run build

Cursor Configuration

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: semrush-mcp (if installed globally) or node

   • Arguments: Leave empty if using global installation, or /path/to/semrush-mcp/dist/index.js if using local installation

   • Environment Variables:

     • SEMRUSH_API_KEY: Your Semrush API key

     • Other optional variables as needed

4. Click "Save"

Claude Desktop Configuration

1. Open Claude Desktop

2. Go to Settings > MCP Servers

3. Click "Add Server"

4. Configure with these settings:

   • Name: Semrush MCP (or any name you prefer)

   • Command: semrush-mcp (if installed globally) or node /path/to/semrush-mcp/dist/index.js (for local installation)

   • Environment Variables:

     • SEMRUSH_API_KEY=your_api_key_here

     • Add other optional variables as needed

5. Click "Save"

Cline Configuration

1. Create or edit your Cline configuration file (usually at ~/.config/cline/config.json)

2. Add the Semrush MCP server to the mcpServers section:

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "semrush-mcp"],
      "env": {
        "SEMRUSH_API_KEY": "your_api_key_here"
      },
      "transportType": "stdio"
    }
  }
}

For a specific version, use:

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "semrush-mcp@0.1.1"],
      "env": {
        "SEMRUSH_API_KEY": "your_api_key_here"
      },
      "transportType": "stdio"
    }
  }
}

For local installation, use:

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "node",
      "args": ["/path/to/semrush-mcp/dist/index.js"],
      "env": {
        "SEMRUSH_API_KEY": "your_api_key_here"
      },
      "transportType": "stdio"
    }
  }
}

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