Semrush MCP

🚀 Semrush MCP Server

Semrush APIの機能をAIアシスタントに提供するMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• ドメイン概要：オーガニックトラフィック、キーワード、権威スコアなどの包括的なドメイン分析を取得します。
• キーワードリサーチ：検索量、難易度、CPCなどのキーワードメトリクスを分析します。
• オーガニック検索分析：任意のドメインのオーガニック検索キーワードとランキングを取得します。
• 有料検索分析：ドメインのGoogle Adsキーワードと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

ドメインの有料検索（Google Ads）キーワードを取得します。

• パラメーター：
  • domain（必須）：分析するドメイン
  • database（オプション）：データベースコード（デフォルト："us"）
  • limit（オプション）：結果の数（デフォルト：10）

7. related_keywords

シードキーワードの関連キーワードと提案を取得します。

• パラメーター：
  • phrase（必須）：シードキーワードフレーズ
  • database（オプション）：データベースコード（デフォルト："us"）
  • limit（オプション）：結果の数（デフォルト：10）

データベースコード

異なる地域の一般的なデータベースコード：

開発

開発モードでサーバーを実行するには、以下のコマンドを実行します。

npm run dev

Claudeでの使用例

設定が完了したら、自然言語を使用してSemrushデータにアクセスできます。

• "Analyze the domain example.com using Semrush"
• "What's the search volume for 'digital marketing' keyword?"
• "Show me the top organic keywords for techcrunch.com"
• "Find competitors for shopify.com"
• "Get backlink data for https://metehan.ai/blog/semrush-mcp/"
• "What related keywords can you find for 'content marketing'?"
• "Show me the Google Ads keywords that amazon.com is bidding on"

トラブルシューティング

1. APIキーの問題：SEMRUSH_API_KEY環境変数が正しく設定されていることを確認します。
2. レート制限：Semrush APIにはレート制限があります。あなたのプランの制限を確認してください。
3. データベースコード：ターゲット地域に有効なデータベースコードを使用していることを確認します。

📄 ライセンス

MIT