Model Context Protocol (MCP) Servers Collection

Keywords Everywhere MCP Server

SEO 調査とキーワード分析のために、Keywords Everywhere API へのアクセスを提供する Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、Claude などの AI アシスタントがキーワード調査、検索ボリュームの分析、競合データの取得、さまざまな SEO 指標へのアクセスを行えます。

なお、これは Keywords Everywhere の公式 MCP サーバーではありません。

Features

• キーワードデータ分析：キーワードの検索ボリューム、CPC、競合データを取得します
• 関連キーワード：関連キーワードと「他のユーザーも検索したキーワード」の候補を見つけます
• ドメイン分析：ドメインまたは URL がランキングされているキーワードを分析します
• トラフィック指標：ドメインと URL のトラフィック推定値とコストを取得します
• バックリンク分析：ドメインとページのバックリンクデータを取得します
• アカウント管理：Keywords Everywhere のクレジット残高を確認します
• 複数国対応：さまざまな国と通貨でキーワードを分析します

Quick Start (Hosted Server)

この MCP サーバーを最も簡単に利用するには、ホストされたエンドポイントを使用してください。インストールは不要です。

Server URL

https://mcp.techmavie.digital/keywords-everywhere/mcp

Analytics Dashboard

https://mcp.techmavie.digital/keywords-everywhere/analytics/dashboard

Using Your Own Credentials

ホスト型クライアントでは、管理対象のユーザーキーを使用してください。

https://mcp.techmavie.digital/keywords-everywhere/mcp/usr_YOUR_USER_KEY

互換性のあるクエリ形式：

https://mcp.techmavie.digital/keywords-everywhere/mcp?api_key=usr_YOUR_USER_KEY

セルフホスト／直接モードでは、Keywords Everywhere の API キーをヘッダー X-API-Key: YOUR_API_KEY で送信します。

Compatible Clients

このサーバーは、Streamable HTTP トランスポートに対応した任意のクライアントで動作します。

• Claude Desktop/Mobile App
• Claude Code
• Cursor
• VS Code
• Windsurf
• その他多数

Installation (Self-Hosted)

独自のインスタンスを実行する場合：

Prerequisites

• Node.js 18.0.0 以降
• Keywords Everywhere API キー（Keywords Everywhere から取得できます）

NPX (Quick Start)

KEYWORDS_EVERYWHERE_API_KEY=your_api_key npx mcp-keywords-everywhere

Global Installation

npm install -g mcp-keywords-everywhere

Configuration

For Claude Desktop (Hosted Server - Recommended)

Claude Desktop の MCP 設定にサーバー URL を追加するだけです。

https://mcp.techmavie.digital/keywords-everywhere/mcp

ホストされたユーザーキーを使用するには：

https://mcp.techmavie.digital/keywords-everywhere/mcp/usr_YOUR_USER_KEY

For Claude Desktop (Self-Hosted)

以下を Claude Desktop の設定ファイルに追加します。

場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

設定：

{
  "mcpServers": {
    "keywords-everywhere": {
      "command": "npx",
      "args": ["-y", "mcp-keywords-everywhere"],
      "env": {
        "KEYWORDS_EVERYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Account Management

• get_credits - アカウントのクレジット残高を確認します
• get_countries - 対応している国の一覧を取得します
• get_currencies - 対応している通貨の一覧を取得します

Keyword Research

• get_keyword_data - キーワードの検索ボリューム、CPC、競合データを取得します
• get_related_keywords - シードキーワードに基づいて関連キーワードを見つけます
• get_pasf_keywords - 「他のユーザーも検索した」キーワードを取得します

Domain Analysis

• get_domain_keywords - ドメインがランキングされているキーワードを取得します
• get_url_keywords - 特定の URL がランキングされているキーワードを取得します
• get_domain_traffic - ドメインのトラフィック指標を取得します
• get_url_traffic - URL のトラフィック指標を取得します

Backlink Analysis

• get_domain_backlinks - ドメインのバックリンクを取得します
• get_unique_domain_backlinks - ドメインのユニークなバックリンクを取得します
• get_page_backlinks - 特定のページのバックリンクを取得します
• get_unique_page_backlinks - ページのユニークなバックリンクを取得します

Usage Examples

Basic Keyword Research

"Get keyword data for 'SEO tools' and 'keyword research' for Malaysia"

Domain Analysis

"What keywords does example.com rank for?"

Traffic Analysis

"Get traffic metrics for https://example.com"

Backlink Research

"Show me the top 20 backlinks for example.com"

API Key Setup

1. Keywords Everywhere にサインアップします
2. API アクセス用のクレジットを購入します
3. ダッシュボードから API キーを取得します
4. API キーを環境変数または MCP の設定に追加します

Error Handling

このサーバーには、包括的なエラー処理が含まれています。

• 認証エラー：無効な API キーについて明確なメッセージを表示します
• クレジット不足：クレジットがなくなった場合に役立つメッセージを表示します
• レート制限：指数バックオフを使用して自動的に再試行します
• 不正なリクエスト：提案を含む詳細なエラーメッセージを表示します

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストをお送りください。

ライセンス

MIT License — 詳細については、LICENSE ファイルをご覧ください。

サポート

• GitHub Issues：バグの報告や機能のリクエスト
• Keywords Everywhere API：公式ドキュメント

開発とデプロイ

前提条件

• Node.js 18+ がインストールされていること
• Keywords Everywhere API キー
• Docker（VPS へのデプロイ用）

プロジェクト構成

mcp-keywords-everywhere/
├── index.js              # Main server file
├── package.json          # Dependencies and scripts
├── Dockerfile            # Docker configuration
├── docker-compose.yml    # Docker Compose configuration
├── deploy/               # Deployment files
│   ├── nginx-mcp.conf    # Nginx configuration
│   └── DEPLOYMENT.md     # Deployment guide
└── README.md             # Documentation

ローカル開発

# Install dependencies
npm install

# Start development server
npm run dev

VPS へのデプロイ

このサーバーは、Docker と Nginx リバースプロキシを使用して VPS にデプロイされています。詳しいデプロイ手順については、deploy/DEPLOYMENT.md をご覧ください。

# Build and run with Docker
docker compose up -d --build

# Check logs
docker logs mcp-keywords-everywhere -f

GitHub Actions による自動デプロイ

main ブランチにプッシュすると、GitHub Actions 経由で VPS へのデプロイが自動的に開始されます。

トランスポートのサポート

この MCP サーバーは Streamable HTTP トランスポートを使用しています。これは本番環境で推奨されるトランスポートであり、STDIO トランスポートと比べて、スケーラビリティ、並行処理、レイテンシが改善されています。

主なメリット

• インストール不要：ホストされたサーバーの URL をそのまま使用できます
• 独自の API キーを使用：ユーザーは各自の Keywords Everywhere API キーを指定できます
• パフォーマンスの向上：HTTP トランスポートにより、スケーラビリティとレイテンシが改善されます
• 自動デプロイ：GitHub にプッシュすると、変更が自動的にデプロイされます

変更履歴

1.2.0

• mcp.techmavie.digital にホスト型サーバーを追加
• URL クエリパラメーターを使った、ユーザー指定の API キーへの対応を追加
• Claude Desktop における MCP プロトコル準拠の問題を修正
• Docker と VPS へのデプロイのサポートを追加
• GitHub Actions による自動デプロイを追加
• リアルタイムの使用統計を表示する分析ダッシュボードを追加

1.1.0

• STDIO から Streamable HTTP トランスポートに移行
• どちらのトランスポート形式にも対応
• セッション管理を改善
• エラー処理を強化

1.0.0

• 初回リリース
• Keywords Everywhere API の主要なエンドポイントすべてに対応
• 包括的なエラー処理と再試行ロジック
• MCP プロトコルに準拠
• クロスプラットフォーム互換性

関連リンク

• Model Context Protocol
• Keywords Everywhere
• Claude Desktop