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

Variable	Description	Default
SEMRUSH_API_KEY	Your Semrush API key	(Required)
API_CACHE_TTL_SECONDS	Time to cache API responses	300
API_RATE_LIMIT_PER_SECOND	Maximum API requests per second	10
NODE_ENV	Environment (development/production)	development
PORT	Server port	3000
LOG_LEVEL	Logging level	info

Available Tools

Tool Name	Description	Required Parameters
semrush_domain_overview	Get domain overview data	domain, [database]
semrush_domain_organic_keywords	Get organic keywords for domain	domain, [database], [limit]
semrush_domain_paid_keywords	Get paid keywords for domain	domain, [database], [limit]
semrush_competitors	Get organic search competitors	domain, [database], [limit]
semrush_backlinks	Get backlinks for a domain/URL	target, [limit]
semrush_backlinks_domains	Get referring domains	target, [limit]
semrush_keyword_overview	Get keyword overview data	keyword, [database]
semrush_related_keywords	Find related keywords	keyword, [database], [limit]
semrush_keyword_overview_single_db	Get detailed keyword data for specific database	keyword, database
semrush_batch_keyword_overview	Analyze up to 100 keywords at once	keywords, database
semrush_keyword_organic_results	Get domains ranking in organic results	keyword, database, [limit]
semrush_keyword_paid_results	Get domains in paid search results	keyword, database, [limit]
semrush_keyword_ads_history	Get 12-month history of domains bidding on keyword	keyword, database, [limit]
semrush_broad_match_keywords	Get broad matches and alternate search queries	keyword, database, [limit]
semrush_phrase_questions	Get question-based keywords	keyword, database, [limit]
semrush_keyword_difficulty	Get difficulty index for ranking in top 10	keywords, database
semrush_traffic_summary	Get traffic summary data for domains	domains, [country]
semrush_traffic_sources	Get traffic sources data	domain, [country]
semrush_api_units_balance	Check API units balance	check: true

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

Tool	API Units per Line
semrush_keyword_overview	10
semrush_keyword_overview_single_db	10
semrush_batch_keyword_overview	10
semrush_keyword_organic_results	10
semrush_keyword_paid_results	20
semrush_related_keywords	40
semrush_keyword_ads_history	100
semrush_broad_match_keywords	20
semrush_phrase_questions	40
semrush_keyword_difficulty	50

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