Semrush MCP Server

Semrush MCP Server

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

mrkooblu

Research & Data
Visit Server

README

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 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"

Claude Desktop

Configure the MCP server in the Claude Desktop settings following the documentation.

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

Recommended Servers

Crypto Price & Market Analysis MCP Server

Crypto Price & Market Analysis MCP Server

A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.

Featured
TypeScript
MCP PubMed Search

MCP PubMed Search

Server to search PubMed (PubMed is a free, online database that allows users to search for biomedical and life sciences literature). I have created on a day MCP came out but was on vacation, I saw someone post similar server in your DB, but figured to post mine.

Featured
Python
dbt Semantic Layer MCP Server

dbt Semantic Layer MCP Server

A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.

Featured
TypeScript
mixpanel

mixpanel

Connect to your Mixpanel data. Query events, retention, and funnel data from Mixpanel analytics.

Featured
TypeScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.

Featured
Python
Nefino MCP Server

Nefino MCP Server

Provides large language models with access to news and information about renewable energy projects in Germany, allowing filtering by location, topic (solar, wind, hydrogen), and date range.

Official
Python
Vectorize

Vectorize

Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.

Official
JavaScript
Mathematica Documentation MCP server

Mathematica Documentation MCP server

A server that provides access to Mathematica documentation through FastMCP, enabling users to retrieve function documentation and list package symbols from Wolfram Mathematica.

Local
Python
kb-mcp-server

kb-mcp-server

An MCP server aimed to be portable, local, easy and convenient to support semantic/graph based retrieval of txtai "all in one" embeddings database. Any txtai embeddings db in tar.gz form can be loaded

Local
Python
Research MCP Server

Research MCP Server

The server functions as an MCP server to interact with Notion for retrieving and creating survey data, integrating with the Claude Desktop Client for conducting and reviewing surveys.

Local
Python