🚀 Semrush MCP 服务器
Semrush MCP 服务器是一个模型上下文协议（MCP）服务器实现，它为用户提供了访问 Semrush API 数据的工具，可助力进行域名、关键词、反向链接和流量等多方面的分析。
🚀 快速开始
Semrush MCP 服务器为用户提供了便捷的 Semrush API 数据访问途径。按照以下步骤操作，即可快速启动服务器：
- 克隆仓库
- 安装依赖：
npm install - 创建
.env文件并添加您的 Semrush API 密钥：SEMRUSH_API_KEY=your_api_key_here - 构建项目：
npm run build - 启动服务器：
npm run start
✨ 主要特性
Semrush MCP 服务器提供了以下实用工具：
-
域名分析
- 提供域名概览信息
- 进行自然和付费关键词分析
- 开展竞争对手分析
-
关键词分析
- 获取关键词概述数据
- 发现相关关键词
-
反向链接分析
- 提供反向链接数据
- 进行引用域分析
-
流量分析
- 获取域名流量摘要
- 进行流量来源分析
- （注意：需要 .Trends API 订阅）
📦 安装指南
克隆与依赖安装
首先，克隆仓库并安装所需依赖：
git clone <仓库地址>
cd semrush-mcp
npm install
配置环境变量
创建 .env 文件并添加 Semrush API 密钥：
SEMRUSH_API_KEY=your_api_key_here
项目构建与启动
构建项目并启动服务器：
npm run build
npm run start
📚 详细文档
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
SEMRUSH_API_KEY |
您的 Semrush API 密钥 | (必填) |
API_CACHE_TTL_SECONDS |
API 响应缓存时间 | 300 |
API_RATE_LIMIT_PER_SECOND |
每秒最大 API 请求数 | 10 |
NODE_ENV |
环境（开发/生产） | development |
PORT |
服务器端口 | 3000 |
LOG_LEVEL |
日志级别 | info |
可用工具
| 工具名称 | 描述 | 必填参数 |
|---|---|---|
semrush_domain_overview |
获取域名概述数据 | 域名, [数据库] |
semrush_keyword_ranking |
检查关键词排名 | 关键词, 国家/地区, 数据库 |
semrush_backlink_audit |
审核反向链接 | 域名, 数据库 |
semrush_traffic_source |
获取流量来源 | 数据库 |
API 单位消耗
- 每个 API 请求会消耗一定数量的 API 单位。
- 不同类型的请求有不同的单位消耗。
添加到 Cursor 或 Claude Desktop
在 Cursor 中添加
- 打开 Cursor 设置。
- 进入 "MCP 服务器" 部分。
- 点击 "添加服务器"。
- 配置服务器如下：
- 名称:
Semrush MCP（或任何您喜欢的名称） - 类型:
命令 - 命令:
node - 参数:
/path/to/semrush-mcp/dist/index.js（根据实际路径替换） - 环境变量:
SEMRUSH_API_KEY: 您的 Semrush API 密钥
- 名称:
- 点击 "保存"
在 Claude Desktop 中添加
按照 Claude Desktop 的文档配置 MCP 服务器。
开发模式
在开发模式下运行服务器：
npm run dev
安全注意事项
⚠️ 重要提示
- 切勿公开分享您的 Semrush API 密钥。
- API 密钥提供对您的 API 单位余额的访问权限。
- 泄露凭证可能导致未经授权的 API 使用和意外费用。
📄 许可证
本项目采用 MIT 许可证。