JinDaGe - semrush-mcp MCP Details

article

README

🚀 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 许可证。

semrush-mcp