Semrush MCP

Semrush MCP

MCP服务器和CLI，用于关键字研究、域分析、反向链接、流量分析和竞争情报。

一个社区维护的自托管工具，通过两个入口点提供Semrush API数据： MCP服务器 适用于Claude Desktop和Cursor等人工智能助手，以及 semrush 命令行界面 用于直接终端使用——非常适合开发人员和人工智能编码代理，如Claude Code，可以代表您运行shell命令。一次安装可以同时提供这两种功能。

快速开始

npm install -g github:mrkooblu/semrush-mcp
export SEMRUSH_API_KEY=your_api_key_here

安装后，您有两个命令：

• semrush --用于终端和代理的CLI
• semrush-mcp --用于AI客户端的stdio上的MCP服务器

CLI：

semrush domain semrush.com           # Domain overview
semrush kw "seo tools"               # Keyword overview
semrush backlinks semrush.com        # Backlink analysis

MCP服务器 （添加到您的AI客户端配置中）：

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "github:mrkooblu/semrush-mcp"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key"
      }
    }
  }
}

特性

• 域名分析 --概述、排名跟踪、排名历史、有机/付费关键字、竞争对手、广告历史、购物、独特页面
• URL分析 --有机/付费关键字、排名、每个URL的排名历史
• 子域分析 --排名、排名历史、每个子域的有机关键字
• 子文件夹分析 --有机/付费关键字、排名、排名历史、每个子文件夹的唯一页面
• 关键词研究 --概述、相关关键词、广泛匹配、问题、SERP有机/付费结果、广告历史、难度
• 反向链接分析 --反向链接、引用域名、概述、页面、锚点、TLD分布、类别
• 流量分析 --摘要、来源、目的地、地理位置、子域、子文件夹、首页、排名、社交媒体（需要。趋势）
• 受众智能 --受众洞察、人口统计、购买转化率、兴趣（需要。趋势）
• API项目 --列出、创建、更新、删除项目
• 现场审核 --审计信息、快照、问题、页面、历史记录、启动爬网
• 关键词差距分析 --并排比较两个域的关键字配置文件（仅限CLI）
• API单位余额 -检查剩余API信用

所有功能都可以通过MCP服务器（77个工具）和CLI获得。

安装

从GitHub全局安装

npm install -g github:mrkooblu/semrush-mcp

或者克隆并本地链接

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

在环境或 .env 文件：

export SEMRUSH_API_KEY=your_api_key_here

MCP设置

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "github:mrkooblu/semrush-mcp"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key"
      }
    }
  }
}

光标

1. 前往“设置”>“MCP服务器”>“添加服务器”
2. 配置：

- 名字: Semrush MCP - 类型: command - 命令: node - 参数: /path/to/semrush-mcp/dist/index.js - 环境变量: SEMRUSH_API_KEY=your_api_key

其他MCP客户端

任何兼容MCP的客户端都可以使用stdio传输进行连接。指向 semrush-mcp 或 node dist/index.js 随着 SEMRUSH_API_KEY 环境变量集。

CLI使用情况

这 semrush CLI是为人类使用和人工智能编码代理（如Claude Code）构建的，可以直接调用shell命令。所有命令支持 -d, --database （国家代码，默认值： us), -l, --limit ，以及 -f, --format .

快速概览

自动检测关键字与域：

semrush q "seo tools"              # Keyword overview
semrush q example.com              # Domain overview

域名分析

semrush domain semrush.com                    # Domain overview
semrush d example.com --organic -l 30         # Organic keywords
semrush d example.com --paid -l 20            # Paid keywords
semrush d example.com --competitors -l 10     # Competitors

关键词研究

semrush kw "content marketing"                # Basic overview
semrush kw "seo" --related -l 20              # Related keywords
semrush kw "marketing" --questions -l 10      # Question-based keywords
semrush kw "email marketing" --broad -l 15    # Broad match keywords
semrush kw "seo tools" --organic -l 10        # SERP organic results
semrush kw "ppc software" --paid -l 10        # SERP paid results

关键词难度

semrush kd "seo" "content marketing" "link building"

反向链接

semrush bl example.com                        # Backlink overview
semrush bl example.com --domains -l 20        # Referring domains

流量分析

要求。趋势API订阅。

semrush traffic example.com                   # Traffic summary
semrush traffic example.com --sources         # Traffic sources

关键词差距分析

semrush gaps mysite.com competitor.com -l 50

API单位余额

semrush units

可用的MCP工具

领域分析（13个工具）

URL分析（5个工具）

子域分析（4个工具）

子文件夹分析（7个工具）

反向链接（7工具）

关键词研究（10个工具）

流量和受众（17个工具，需要订阅.Trends）

项目和现场审计（13个工具）

实用工具（1个工具）

仅CLI命令

配置

需要 SEMRUSH_API_KEY 在环境或 .env 文件。

API单位消耗量

API请求使用您的Semrush帐户中的单位。不同的报告有不同的成本：

随时通过以下方式检查您的余额 semrush units 或 semrush_api_units_balance MCP工具。

发展

git clone https://github.com/mrkooblu/semrush-mcp.git
cd semrush-mcp
npm install
cp .env.example .env   # add your SEMRUSH_API_KEY

npm run dev              # MCP server in dev mode (tsx, hot reload)
npm run build            # Compile TypeScript to dist/
npm test                 # Run all tests
npm run test:unit        # Unit tests only (no API key needed)
npm run test:integration # Integration tests (requires SEMRUSH_API_KEY)
npm run lint             # ESLint
npm run format           # Prettier

Git挂钩

此项目使用 哈士奇 对于git钩子：

• 预承诺：lint stage、ESLint、TypeScript类型检查、单元测试、秘密检测
• 预推：未提交的更改检查、完整构建、集成测试（需要 SEMRUSH_API_KEY)

为什么选择自助主机？

此自托管工具适用于需要更多控制权的用户：

• 对API调用和缓存的完全控制 --配置TTL，检查原始响应
• 自定义费率限制 --设置自己的每秒请求数限制
• 自托管/气隙式 --完全在您的计算机上运行，没有外部MCP端点
• 代理的CLI --AI编码代理可以调用 semrush 直接无需MCP
• 开源 --麻省理工学院授权，根据您的需求进行分叉和定制

安全

• 永远不要公开共享您的Semrush API密钥
• API密钥提供对API单位余额的访问
• 暴露凭据可能会导致未经授权使用API并产生意外费用

托管替代方案

Semrush还提供 官方托管的MCP连接器 在 https://mcp.semrush.com/v1/mcp --无需设置，请使用您的Semrush帐户进行身份验证。看 MCP入门 了解详情。

这是一个个人项目，不是Semrush的官方产品。

许可证

麻省理工学院