Semrush MCP 服务器

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

功能

Semrush MCP 服务器提供以下工具：

• 域名分析

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

• 关键词分析

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

• 反向链接分析

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

• 流量分析

  • 域名流量汇总
  • 流量来源分析
  • (注意：需要 .Trends API 订阅)

设置

1. 克隆仓库
2. 安装依赖:

   npm install
   

3. 创建一个 .env 文件，并填入你的 Semrush API 密钥:

   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 请求数	10
NODE_ENV	环境 (development/production)	development
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 中，转到 Settings > MCP Servers

2. 点击 "Add Server"

3. 使用以下设置配置服务器：

   • Name: Semrush MCP (或您喜欢的任何名称)
   • Type: command
   • Command: node
   • Arguments: /path/to/semrush-mcp/dist/index.js (替换为您的实际路径)
   • Environment Variables:
     • SEMRUSH_API_KEY: 您的 Semrush API 密钥
     • 其他可选变量，根据需要

4. 点击 "Save"

Claude Desktop

按照文档在 Claude Desktop 设置中配置 MCP 服务器。

开发

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

npm run dev

安全注意事项

• 永远不要公开分享您的 Semrush API 密钥
• API 密钥提供对您的 API 单元余额的访问权限
• 暴露凭据可能导致未经授权的 API 使用和意外费用

许可证

MIT