Semrush MCP 服务器

这是一个提供对 Semrush API 功能访问的 MCP（模型上下文协议）服务器，适用于AI助手。

特性

• 域名概览：获取全面的域名分析，包括有机流量、关键词和权威评分。
• 关键词研究：分析关键词指标，包括搜索量、难度和CPC。
• 有机搜索分析：检索任何域名的有机搜索关键词和排名。
• 付费搜索分析：获取Google广告关键词和PPC数据。
• 反向链接概览：获取域名或特定URL的反向链接指标和分析。
• 竞争对手研究：识别并分析有机竞争对手。
• 相关关键词：发现相关关键词和搜索建议。

预备条件

• Node.js 18+
• Semrush API 密钥（在 https://www.semrush.com/api/ 获取）

安装

1. 克隆此仓库或创建一个新目录：

mkdir semrush-mcp
cd semrush-mcp

2. 创建以下目录结构：

semrush-mcp/
├── src/
│   └── index.ts
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
└── README.md

3. 将提供的文件保存到相应位置

然后手动执行：

npm install
npm run build

配置

设置您的Semrush API密钥作为环境变量：

export SEMRUSH_API_KEY="your-api-key-here"

或者创建一个.env文件：

SEMRUSH_API_KEY=your-api-key-here

使用与Claude Desktop

将服务器添加到您的Claude Desktop配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "semrush": {
      "command": "node",
      "args": ["/path/to/semrush-mcp-server/dist/index.js"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

1. domain_overview

获取全面的域名分析。

参数：

• domain（必需）：要分析的域名（例如："example.com"）
• database（可选）：数据库代码（默认："us"）

2. keyword_overview

获取关键词指标和数据。

参数：

• phrase（必需）：要分析的关键词短语
• database（可选）：数据库代码（默认："us"）

3. domain_organic_search

获取域名的有机搜索关键词。

参数：

• domain（必需）：要分析的域名
• database（可选）：数据库代码（默认："us"）
• limit（可选）：结果数量（默认：10）
• offset（可选）：分页偏移量（默认：0）

4. backlinks_overview

获取域名或URL的反向链接概览。

参数：

• target（必需）：要分析的域名或URL
• target_type（可选）："domain" 或 "url"（默认："domain"）

5. competitor_research

查找域名的有机竞争对手。

参数：

• domain（必需）：要分析的域名
• database（可选）：数据库代码（默认："us"）
• limit（可选）：竞争对手数量（默认：1 10）

6. domain_adwords

获取域名的付费搜索（Google广告）关键词。

参数：

• domain（必需）：要分析的域名
• database（可选）：数据库代码（默认："us"）
• limit（可选）：结果数量（默认：10）

7. related_keywords

获取种子关键词的相关关键词和建议。

参数：

• phrase（必需）：种子关键词短语
• database（可选）：数据库代码（默认："us"）
• limit（可选）：结果数量（默认：10）

数据库代码

不同地区的常见数据库代码：

• us - 美国
• uk - 英国
• ca - 加拿大
• au - 澳大利亚
• de - 德国
• fr - 法国
• es - 西班牙
• it - 意大利
• br - 巴西
• in - 印度

开发

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

npm run dev

在Claude中的示例用法

一旦配置完成，您可以使用自然语言来访问Semrush数据：

• "使用Semrush分析example.com域名"
• "'数字营销'关键词的搜索量是多少？"
• "显示techcrunch.com的顶级有机关键词"
• "找到shopify.com的竞争对手"
• "获取https://metehan.ai/blog/semrush-mcp/的反向链接数据"
• "你能找到与'内容营销'相关的关键词吗？"
• "显示amazon.com正在竞标的Google广告关键词"

故障排除

1. API密钥问题：确保您的SEMRUSH_API_KEY环境变量设置正确。
2. 速率限制：Semrush API有速率限制，请检查您计划的限制。
3. 数据库代码：确保您使用了目标区域的有效数据库代码。

许可证

MIT </中文翻译>