Semrush

Semrush MCP Server

typescript

11

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Semrush MCP Server is an MCP (Model Context Protocol) service that exposes Semrush API functionality to AI assistants through a structured MCP interface. It enables you to retrieve domain analytics, keyword metrics, organic and paid search data, backlinks, and competitor insights in an automated, programmable way.

How to use

To use the Semrush MCP Server with an MCP client, configure the client to run the Semrush MCP server and point it at the local or remote process. The server expects a Semrush API key and provides a set of tools for domain, keyword, and competitive analytics that you can invoke via the MCP interface.

How to install

Prerequisites include Node.js 18 or newer and a Semrush API key.

mkdir semrush-mcp
cd semrush-mcp

Install dependencies and build the project as described in the repository setup.

npm install
npm run build

Configuration

Set your Semrush API key as an environment variable to authorize requests from the MCP server.

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

Or create a .env file in the project root with the following content.

SEMRUSH_API_KEY=your-api-key-here

## Usage with Claude Desktop

Add the Semrush MCP server to your Claude Desktop configuration so Claude can route queries to Semrush via MCP. The example configuration shows how to point to the local server binary and pass the API key.

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

## Development

For development, you can run the server in development mode to enable live changes and debugging.

npm run dev

## Troubleshooting

If you encounter API key issues, ensure the SEMRUSH\_API\_KEY environment variable is set correctly. Be mindful of rate limits in your Semrush plan and verify that you are using valid database codes for your target regions.