Semrush MCP Server

这是一个实现了模型上下文协议（MCP）服务器，提供了访问Semrush API数据的工具。

功能

Sermrush MCP服务器提供的工具包括：

• 域名分析

  • 域名概览信息
  • 自然搜索和付费关键词分析
  • 竞争对手分析

• 关键词分析

  • 关键词概览数据
  • 相关关键词发现

• 反向链接分析

  • 反向链接数据
  • 引用域名分析

• 流量分析

  • 域名流量总结
  • 流量来源分析
  • （注意：需要订阅.Trends API）

安装

1. 克隆仓库
2. 安装依赖项：

   npm install
   

3. 创建一个包含您的Semrush API密钥的.env文件：

   SEMRUSH_API_KEY=your_api_key_here
   

4. 构建项目：

   npm run build
   

5. 启动服务器：

   npm run start
   

环境变量

变量	描述	默认值
SEMRUSH_API_KEY	您的Semrush API密钥	必填
API_CACHE_TTL_SECONDS	API响应缓存时间	300
API_RATE_LIMIT_PER_SECOND	每秒最大API请求次数	1 0
NODE_ENV	环境（开发/生产）	开发
PORT	服务器端口	3000
LOG_LEVEL	日志级别	info

可用工具

工具名称	描述	需要的参数
semrush_domain_overview	获取域名概览数据	domain, [database]
semrush_domain_organic_keywords	获取域名的自然搜索关键词	domain, [database], [limit]
semrush_domain_paid_keywords	获取域名的付费关键词	domain, [database], [limit]
semrush_competitors	获取有机搜索竞争对手	domain, [database], [limit]
semrush_backlinks	获取域名或URL的反向链接	target, [limit]
semrush_backlinks_domains	获取引用域名	target, [limit]
semrush_keyword_overview	获取关键词概览数据	keyword, [database]
semrush_related_keywords	查找相关关键词	keyword, [database], [limit]
semrush_keyword_overview_single_db	获取特定数据库的详细关键词数据	keyword, database
semrush_batch_keyword_overview	分析最多100个关键词	keywords, database
semrush_keyword_organic_results	获取在自然搜索结果中排名的域名	keyword, database, [limit]
semrush_keyword_paid_results	获取在付费搜索结果中的域名	keyword, database, [limit]
semrush_keyword_ads_history	获取过去12个月竞标该关键词的域名历史	keyword, database, [limit]
semrush_broad_match_keywords	获取广泛匹配和替代搜索查询	keyword, database, [limit]
semrush_phrase_questions	获取基于问题的关键词	keyword, database, [limit]
semrush_keyword_difficulty	获取进入前10名的难度指数	keywords, database
semrush_traffic_summary	获取域名的流量总结数据	domains, [country]
semrush_traffic_sources	获取流量来源数据	domain, [country]
semrush_api_units_balance	检查API单位余额	check: true

方括号内的参数是可选的。

API单位消耗

对Semrush的API请求会从您的账户中消耗API单位。不同类型的请求有不同的成本。您可以使用semrush_api_units_balance工具检查您的API单位余额。

关键词报告API单位消耗

工具	每行API单位
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

添加到Cursor或Claude

要将此MCP服务器添加到Cursor或Claude：

Cursor

1. 在Cursor中，前往设置 > MCP服务器
2. 点击“添加服务器”
3. 使用以下设置配置服务器：
   • 名称：Semrush MCP（或您喜欢的任何名称）
   • 类型：命令
   • 命令：node
   • 参数：/path/to/semrush-mcp/dist/index.js（替换为您实际路径）
   • 环境变量：
     • SEMRUSH_API_KEY：您的Semrush API密钥
     • 根据需要添加其他可选变量
4. 点击“保存”

使用NPX运行

在Cursor/Claude/Windsurf配置中使用环境变量

通过以下格式添加此MCP到您的MCP服务器JSON文件中，以配置指定的消费环境：

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

从终端运行：

SEMRUSH_API_KEY=your-api-key npx -y github:mrkooblu/semrush-mcp

开发

要在开发模式下运行服务器：

npm run dev

安全注意事项

• 切勿公开分享您的Semrush API密钥
• API密钥提供访问您的API单位余额
• 泄露凭证可能导致未经授权的API使用和意外费用

许可证

MIT