SEO分析服务器

一个提供Semrush API功能的MCP服务器,用于AI助手的SEO数据分析,包括域名概览、关键词研究、有机搜索分析等功能。

  • by metehan777
  • TypeScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 metehan777/semrush-mcp

使用说明

Semrush MCP服务器

一种MCP(模型上下文协议)服务器,为人工智能助手提供对Semrush API功能的访问。

特性

  • 域名概述:获得全面的领域分析,包括自然流量、关键字和权威评分
  • 关键词研究:分析关键字指标,包括搜索量、难度和CPC
  • 有机搜索分析:检索任何域名的自然搜索关键字和排名
  • 付费搜索分析:获取域的Google Ads关键字和PPC数据
  • 反向链接概述:获取域或特定URL的反向链接指标和分析
  • 竞争对手研究:识别和分析有机竞争对手
  • 相关关键词:发现相关关键字和搜索建议

先决条件

  • Node.js 18+
  • Semrush API密钥(在https://www.semrush.com/api/)

安装

  1. 克隆此存储库或创建新目录:
mkdir semrush-mcp
cd semrush-mcp
  1. 创建以下目录结构:
semrush-mcp/
├── src/
│   └── index.ts
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
└── README.md
  1. 将提供的文件保存在各自的位置

然后手动:

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 (必填):要分析的域或URL
  • target_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关键字”

故障排除

  1. API关键问题:确保SEMRUSH_API_KEY环境变量设置正确
  2. 速率限制:Semrush API有费率限制。检查你的计划的限制
  3. 数据库代码:确保您在目标地区使用了有效的数据库代码

许可证

麻省理工学院