Semrush MCP Server

Semrush MCP

キーワード調査、ドメイン分析、バックリンク、トラフィック分析、競合インテリジェンスに対応する MCP サーバーと CLI です。

コミュニティによって保守されているセルフホスト可能なツールです。Semrush API のデータを、Claude Desktop や Cursor などの AI アシスタント向けの MCP サーバーと、ターミナルから直接使用する semrush CLI の 2 つの方法で提供します。シェルコマンドを代わりに実行できる Claude Code のような開発者や AI コーディングエージェントに最適です。1 回のインストールで両方を利用できます。

クイックスタート

npm install -g github:mrkooblu/semrush-mcp
export SEMRUSH_API_KEY=your_api_key_here

インストール後は、次の 2 つのコマンドを利用できます。

• semrush — ターミナルとエージェント向けの CLI
• semrush-mcp — AI クライアント向けの stdio 上で動作する MCP サーバー

CLI：

semrush domain semrush.com           # Domain overview
semrush kw "seo tools"               # Keyword overview
semrush backlinks semrush.com        # Backlink analysis

MCP サーバー（AI クライアントの設定に追加します）：

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "github:mrkooblu/semrush-mcp"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key"
      }
    }
  }
}

機能

• ドメイン分析 — 概要、順位追跡、順位履歴、オーガニック／有料キーワード、競合他社、広告履歴、ショッピング、ユニークページ
• URL 分析 — URL ごとのオーガニック／有料キーワード、順位、順位履歴
• サブドメイン分析 — サブドメインごとの順位、順位履歴、オーガニックキーワード
• サブフォルダー分析 — サブフォルダーごとのオーガニック／有料キーワード、順位、順位履歴、ユニークページ
• キーワード調査 — 概要、関連キーワード、部分一致、質問、SERP のオーガニック／有料検索結果、広告履歴、難易度
• バックリンク分析 — バックリンク、参照ドメイン、概要、ページ、アンカー、TLD 分布、カテゴリー
• トラフィック分析 — 概要、流入元、遷移先、地域、サブドメイン、サブフォルダー、上位ページ、順位、ソーシャルメディア（.Trends が必要）
• オーディエンスインテリジェンス — オーディエンスのインサイト、人口統計、購入コンバージョン、興味・関心（.Trends が必要）
• Projects API — プロジェクトの一覧表示、作成、更新、削除
• サイト監査 — 監査情報、スナップショット、問題、ページ、履歴、クロールの開始
• キーワードギャップ分析 — 2 つのドメインのキーワードプロファイルを並べて比較（CLI のみ）
• API ユニット残高 — 残りの API クレジットを確認

すべての機能は MCP サーバー（77 個のツール）と CLI の両方から利用できます。

インストール

GitHub からグローバルにインストール

npm install -g github:mrkooblu/semrush-mcp

または、クローンしてローカルにリンク

git clone https://github.com/mrkooblu/semrush-mcp.git
cd semrush-mcp
npm install && npm run build && npm link

環境変数または .env ファイルに API キーを設定します。

export SEMRUSH_API_KEY=your_api_key_here

MCP のセットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "github:mrkooblu/semrush-mcp"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

1. Settings > MCP Servers > Add Server に移動します
2. 次のように設定します。
   • 名前：Semrush MCP
   • タイプ：command
   • コマンド：node
   • 引数：/path/to/semrush-mcp/dist/index.js
   • 環境変数：SEMRUSH_API_KEY=your_api_key

その他の MCP クライアント

MCP に対応するクライアントであれば、stdio トランスポートを使って接続できます。SEMRUSH_API_KEY 環境変数を設定し、接続先として semrush-mcp または node dist/index.js を指定します。

CLI の使い方

semrush CLI は、シェルコマンドを直接実行できる Claude Code のような AI コーディングエージェントだけでなく、人が使用する場合にも対応しています。すべてのコマンドで -d, --database <db>（国コード。デフォルト：us）、-l, --limit <n>、-f, --format <text|json> を指定できます。

クイック概要

キーワードかドメインかを自動判別します。

semrush q "seo tools"              # Keyword overview
semrush q example.com              # Domain overview

ドメイン分析

semrush domain semrush.com                    # Domain overview
semrush d example.com --organic -l 30         # Organic keywords
semrush d example.com --paid -l 20            # Paid keywords
semrush d example.com --competitors -l 10     # Competitors

キーワード調査

semrush kw "content marketing"                # Basic overview
semrush kw "seo" --related -l 20              # Related keywords
semrush kw "marketing" --questions -l 10      # Question-based keywords
semrush kw "email marketing" --broad -l 15    # Broad match keywords
semrush kw "seo tools" --organic -l 10        # SERP organic results
semrush kw "ppc software" --paid -l 10        # SERP paid results

キーワード難易度

semrush kd "seo" "content marketing" "link building"

バックリンク

semrush bl example.com                        # Backlink overview
semrush bl example.com --domains -l 20        # Referring domains

トラフィック分析

.Trends API のサブスクリプションが必要です。

semrush traffic example.com                   # Traffic summary
semrush traffic example.com --sources         # Traffic sources

キーワードギャップ分析

semrush gaps mysite.com competitor.com -l 50

API ユニット残高

semrush units

利用可能な MCP ツール

ドメイン分析（13 ツール）

ツール	説明
semrush_domain_overview	ドメインの概要 — すべてのデータベースにおけるトラフィック、キーワード、ランキング
semrush_domain_rank	特定のデータベースにおけるドメインのランク
semrush_domain_rank_history	ドメインの過去のランクデータ
semrush_rank_difference	ランクの変動が最も大きいドメイン
semrush_domain_organic_keywords	ドメインのオーガニックキーワード
semrush_domain_paid_keywords	ドメインの有料キーワード
semrush_competitors	オーガニック検索の競合ドメイン
semrush_paid_competitors	有料検索の競合ドメイン
semrush_domain_ads_history	ドメインの広告履歴
semrush_domain_organic_unique	ドメインの固有のオーガニックページ
semrush_domain_adwords_unique	ドメインの固有の有料広告ページ
semrush_domain_shopping	ドメインのショッピング／PLA キーワード
semrush_domain_shopping_unique	固有のショッピング広告ページ

URL 分析（5 ツール）

ツール	説明
semrush_url_organic	特定の URL のオーガニックキーワード
semrush_url_adwords	特定の URL の有料キーワード
semrush_url_rank	特定の URL のランクデータ
semrush_url_rank_history	URL の過去のランクデータ
semrush_url_ranks	URL のすべてのデータベースにおけるランク

サブドメイン分析（4 ツール）

ツール	説明
semrush_subdomain_rank	サブドメインのランクデータ
semrush_subdomain_ranks	サブドメインのすべてのデータベースにおけるランク
semrush_subdomain_rank_history	サブドメインの過去のランクデータ
semrush_subdomain_organic	サブドメインのオーガニックキーワード

サブフォルダー分析（7 ツール）

ツール	説明
semrush_subfolder_organic	サブフォルダーのオーガニックキーワード
semrush_subfolder_adwords	サブフォルダーの有料キーワード
semrush_subfolder_rank	サブフォルダーのランクデータ
semrush_subfolder_ranks	サブフォルダーのすべてのデータベースにおけるランク
semrush_subfolder_rank_history	サブフォルダーの過去のランクデータ
semrush_subfolder_organic_unique	サブフォルダー内の固有のオーガニックページ
semrush_subfolder_adwords_unique	サブフォルダー内の固有の有料広告ページ

被リンク（7 ツール）

ツール	説明
semrush_backlinks	ドメイン／URL の被リンク
semrush_backlinks_domains	参照元ドメイン
semrush_backlinks_overview	被リンクの概要統計
semrush_backlinks_pages	被リンクが最も多いページ
semrush_backlinks_anchors	アンカーテキストの分布
semrush_backlinks_tld	被リンクの TLD 分布
semrush_backlinks_categories	被リンクのカテゴリ別分布

キーワード調査（10 ツール）

ツール	説明
semrush_keyword_overview	すべてのデータベースにおけるキーワードの概要
semrush_keyword_overview_single_db	特定のデータベースにおける詳細なキーワードデータ
semrush_batch_keyword_overview	最大 100 個のキーワードを一度に分析
semrush_related_keywords	関連キーワードの検索
semrush_broad_match_keywords	部分一致キーワード／代替クエリ
semrush_phrase_questions	質問形式のキーワード
semrush_keyword_organic_results	オーガニック検索結果でランクインしているドメイン
semrush_keyword_paid_results	有料検索結果に表示されるドメイン
semrush_keyword_ads_history	キーワードに入札しているドメインの過去 12 か月の履歴
semrush_keyword_difficulty	上位 10 位以内にランクインする難易度指数

トラフィックとオーディエンス（17 個のツール、.Trends サブスクリプションが必要です）

ツール	説明
semrush_traffic_summary	ドメインのトラフィック概要
semrush_traffic_sources	トラフィックソースの内訳
semrush_traffic_destinations	訪問後のトラフィックの遷移先
semrush_traffic_geo	トラフィックの地域分布
semrush_traffic_subdomains	サブドメイン別のトラフィック
semrush_traffic_subfolders	サブフォルダー別のトラフィック
semrush_traffic_top_pages	トラフィックが最も多いページ
semrush_traffic_rank	時系列のトラフィックランキング
semrush_traffic_social_media	ソーシャルメディアトラフィックの内訳
semrush_audience_insights	ドメイン間のオーディエンスの重複
semrush_purchase_conversion	購入コンバージョン指標
semrush_household_distribution	世帯人数の人口統計データ
semrush_income_distribution	所得の人口統計データ
semrush_education_distribution	教育レベルの人口統計データ
semrush_occupation_distribution	職業の人口統計データ
semrush_audience_interests	オーディエンスの関心カテゴリ
semrush_traffic_accuracy	トラフィックデータの精度推定

プロジェクトとサイト監査（13 個のツール）

ツール	説明
semrush_list_projects	すべてのプロジェクトを一覧表示
semrush_get_project	プロジェクトの詳細を取得
semrush_create_project	新しいプロジェクトを作成
semrush_update_project	プロジェクト設定を更新
semrush_delete_project	プロジェクトを削除
semrush_site_audit_info	サイト監査の設定とステータス
semrush_site_audit_snapshots	監査スナップショットを一覧表示
semrush_site_audit_snapshot_detail	スナップショットの詳細を取得
semrush_site_audit_issues	監査課題のメタデータ
semrush_site_audit_pages	監査済みページを一覧表示
semrush_site_audit_page_detail	ページ単位の監査詳細
semrush_site_audit_history	監査履歴
semrush_site_audit_launch	新しい監査クロールを開始

ユーティリティ（1 個のツール）

ツール	説明
semrush_api_units_balance	API ユニット残高を確認

CLI 専用コマンド

CLI コマンド	説明
semrush gaps <d1> <d2>	2 つのドメイン間のキーワードギャップ分析

設定

環境変数または .env ファイルに SEMRUSH_API_KEY が必要です。

変数	デフォルト値	説明
SEMRUSH_API_KEY	（必須）	Semrush API キー
API_CACHE_TTL_SECONDS	300	API レスポンスのキャッシュ TTL
API_RATE_LIMIT_PER_SECOND	10	1 秒あたりの最大 API リクエスト数
NODE_ENV	development	環境モード
LOG_LEVEL	info	ログレベル

API ユニットの消費量

API リクエストは Semrush アカウントのユニットを消費します。レポートによってコストは異なります。

ツール	1 行あたりの API ユニット数
semrush_keyword_overview	10
semrush_keyword_overview_single_db	10
semrush_batch_keyword_overview	10
semrush_keyword_organic_results	10
semrush_keyword_paid_results	20
semrush_broad_match_keywords	20
semrush_related_keywords	40
semrush_phrase_questions	40
semrush_keyword_difficulty	50
semrush_keyword_ads_history	100

semrush units または semrush_api_units_balance MCP ツールで、いつでも残高を確認できます。

開発

git clone https://github.com/mrkooblu/semrush-mcp.git
cd semrush-mcp
npm install
cp .env.example .env   # add your SEMRUSH_API_KEY

npm run dev              # MCP server in dev mode (tsx, hot reload)
npm run build            # Compile TypeScript to dist/
npm test                 # Run all tests
npm run test:unit        # Unit tests only (no API key needed)
npm run test:integration # Integration tests (requires SEMRUSH_API_KEY)
npm run lint             # ESLint
npm run format           # Prettier

Git フック

このプロジェクトでは、Git フックに Husky を使用しています。

• コミット前：lint-staged、ESLint、TypeScript の型チェック、ユニットテスト、シークレット検出
• プッシュ前：未コミットの変更の確認、完全なビルド、統合テスト（SEMRUSH_API_KEY が必要）

セルフホストする理由

このセルフホスト型ツールは、より細かく制御したいユーザー向けです。

• API 呼び出しとキャッシュを完全に制御 — TTL を設定し、生のレスポンスを確認できます
• カスタムのレート制限 — 1 秒あたりのリクエスト数の上限を独自に設定できます
• セルフホスト／エアギャップ環境 — マシン上で完全に動作し、外部の MCP エンドポイントは必要ありません
• エージェント向け CLI — AI コーディングエージェントは MCP を介さずに semrush を直接呼び出せます
• オープンソース — MIT ライセンスで提供されており、フォークしてニーズに合わせてカスタマイズできます

セキュリティ

• Semrush API キーを公開しないでください
• API キーを使用すると、API ユニットの残高にアクセスできます
• 認証情報を公開すると、不正な API 利用や予期しない料金が発生するおそれがあります

ホスト型の代替サービス

Semrush は、https://mcp.semrush.com/v1/mcp にある公式のホスト型 MCP コネクターも提供しています。セットアップは不要で、Semrush アカウントで認証できます。詳しくは「MCP 入門」をご覧ください。

これは個人プロジェクトであり、Semrush の公式製品ではありません。

ライセンス

MIT