Happy slice of mcp pizzaMCP.pizza

semrush-mcp

MCP.Pizza Chef: mrkooblu

The Semrush MCP server is a Model Context Protocol server that exposes structured tools for accessing comprehensive Semrush API data. It enables real-time retrieval of domain analytics, keyword insights, backlink profiles, and traffic summaries, facilitating SEO and competitive analysis workflows. Designed for seamless integration, it supports organic and paid keyword data, competitor analysis, and traffic source breakdowns, requiring a Semrush API key and optional .Trends subscription for traffic analytics.

Use This MCP server To

Retrieve domain overview and SEO metrics for competitive analysis Analyze organic and paid keywords for targeted marketing Discover related keywords to optimize content strategy Access backlink profiles and referring domains for link building Get traffic summaries and source breakdowns for domains Integrate Semrush data into AI workflows for SEO automation

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

semrush-mcp FAQ

How do I authenticate the Semrush MCP server?
You authenticate by providing your Semrush API key in a .env file as SEMRUSH_API_KEY before starting the server.
What Semrush data categories does this MCP server support?
It supports domain analytics, keyword analytics, backlink analysis, and traffic analytics (with .Trends subscription).
Can I use this MCP server without a Semrush API key?
No, a valid Semrush API key is required to access the API data through this server.
How do I enable traffic analytics features?
Traffic analytics require an additional .Trends API subscription from Semrush to access traffic source data.
What setup steps are needed to run the Semrush MCP server?
Clone the repo, install dependencies, set SEMRUSH_API_KEY in .env, build, and start the server.
Is this MCP server compatible with multiple LLM providers?
Yes, it is provider-agnostic and can be used with OpenAI, Claude, Gemini, and others.
Can I extend the Semrush MCP server with additional Semrush API endpoints?
Yes, the server is open source and can be extended to include more API endpoints as needed.
What programming environment is required?
Node.js environment with npm is required to install dependencies and run the server.