Semrush MCP

🚀 Semrush MCP 服务器

Semrush MCP 服务器是一个基于 MCP（模型上下文协议）的服务器，它为 AI 助手提供了访问 Semrush API 功能的途径，助力 AI 助手获取全面的域名分析、关键词研究等数据。

🚀 快速开始

Semrush MCP 服务器能让 AI 助手方便地使用 Semrush API 的各项功能。在使用前，请确保满足以下前提条件，并完成安装和配置。

✨ 主要特性

• 域名概览：获取全面的域名分析数据，涵盖自然流量、关键词和权威评分等信息。
• 关键词研究：分析关键词指标，包括搜索量、竞争难度和每次点击费用（CPC）。
• 自然搜索分析：检索任何域名的自然搜索关键词和排名。
• 付费搜索分析：获取域名的谷歌广告关键词和 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

获取全面的域名分析数据。

2. keyword_overview

获取关键词指标和数据。

3. domain_organic_search

获取域名的自然搜索关键词。

4. backlinks_overview

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

5. competitor_research

查找域名的自然搜索竞争对手。

6. domain_adwords

获取域名的谷歌广告关键词。

7. related_keywords

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

数据库代码

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

开发

若要以开发模式运行服务器，请执行以下命令：

npm run dev

在 Claude 中的使用示例

配置完成后，你可以使用自然语言来访问 Semrush 数据，例如：

• "使用 Semrush 分析域名 example.com"
• "关键词 'digital marketing' 的搜索量是多少？"
• "展示 techcrunch.com 的前几个自然搜索关键词"
• "查找 shopify.com 的竞争对手"
• "获取 https://metehan.ai/blog/semrush-mcp/ 的反向链接数据"
• "能找到与 'content marketing' 相关的哪些关键词？"
• "展示 amazon.com 正在竞价的谷歌广告关键词"

故障排除

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

📄 许可证

本项目采用 MIT 许可证。