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 許可證。