semrush-mcp

🚀 Semrush MCP 服务器

Semrush MCP 服务器是一个基于模型上下文协议（MCP）的服务器，它为 AI 助手提供了访问 Semrush API 功能的途径，可助力 AI 对网站进行多维度的数据分析。

✨ 主要特性

• 域名概览：获取全面的域名分析数据，涵盖自然流量、关键词和权威得分等。
• 关键词研究：分析关键词指标，如搜索量、竞争难度和每次点击费用（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

获取全面的域名分析数据。 | 参数 | 详情 | |------|------| | 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（可选） | 竞争对手数量（默认：10） |

6. domain_adwords

获取域名的谷歌广告关键词。 | 参数 | 详情 | |------|------| | 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 域名"
• "查询 '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 许可证。