使用说明
Semrush MCP服务器
一种MCP(模型上下文协议)服务器,为人工智能助手提供对Semrush API功能的访问。
特性
- 域名概述:获得全面的领域分析,包括自然流量、关键字和权威评分
- 关键词研究:分析关键字指标,包括搜索量、难度和CPC
- 有机搜索分析:检索任何域名的自然搜索关键字和排名
- 付费搜索分析:获取域的Google Ads关键字和PPC数据
- 反向链接概述:获取域或特定URL的反向链接指标和分析
- 竞争对手研究:识别和分析有机竞争对手
- 相关关键词:发现相关关键字和搜索建议
先决条件
- Node.js 18+
- Semrush API密钥(在https://www.semrush.com/api/)
安装
- 克隆此存储库或创建新目录:
mkdir semrush-mcp
cd semrush-mcp
- 创建以下目录结构:
semrush-mcp/
├── src/
│ └── index.ts
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
└── README.md
- 将提供的文件保存在各自的位置
然后手动:
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(必填):要分析的域名(例如“example.com”)database(可选):数据库代码(默认:“us”)
2.关键词_概述
获取关键字指标和数据。
参数:
phrase(必填):要分析的关键字短语database(可选):数据库代码(默认:“us”)
3.域名_机构_搜索
获取域名的自然搜索关键字。
参数:
domain(必填):要分析的域database(可选):数据库代码(默认:“us”)limit(可选):结果数量(默认值:10)offset(可选):分页偏移量(默认值:0)
4.反向链接_概述
获取域或URL的反向链接概述。
参数:
target(必填):要分析的域或URLtarget_type(可选):“域”或“url”(默认为“域”)
5.竞争对手_搜索
为一个域名寻找有机竞争对手。
参数:
domain(必填):要分析的域database(可选):数据库代码(默认:“us”)limit(可选):参赛者数量(默认值:10)
6.域名
获取域名的付费搜索(Google Ads)关键字。
参数:
domain(必填):要分析的域database(可选):数据库代码(默认:“us”)limit(可选):结果数量(默认值:10)
7.相关关键词
获取种子关键字的相关关键字和建议。
参数:
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 Ads关键字”
故障排除
- API关键问题:确保SEMRUSH_API_KEY环境变量设置正确
- 速率限制:Semrush API有费率限制。检查你的计划的限制
- 数据库代码:确保您在目标地区使用了有效的数据库代码
许可证
麻省理工学院
