Yandex Tools MCP

yandex-tools-mcp

Yandex API 向け MCP サーバー — ロシア市場向けの検索、キーワード調査、ウェブマスターツール、ウェブ分析。

英語 | ロシア語

---

英語

パッケージ

パッケージ	説明	npm
yandex-wordstat-mcp	Yandex Wordstat v2 API（Yandex Cloud）を利用したキーワード調査と検索トレンド
yandex-search-mcp	Yandex Search API を利用したウェブ検索
yandex-webmaster-mcp	Yandex Webmaster API を利用したサイト分析、インデックス登録、SEO
yandex-metrika-mcp	Yandex Metrika API を利用したウェブ分析とトラフィックデータ
yandex-direct-mcp	Yandex Direct API を利用した PPC キャンペーン管理（キャンペーン、広告、キーワード、入札、統計）

クイックスタート

Yandex Wordstat v2（キーワード調査）— Yandex Cloud Search API。Search と同じキーを使用します。

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your_api_key",
        "YANDEX_FOLDER_ID": "your_folder_id"
      }
    }
  }
}

ホスト型ツールをお探しですか？ seyka.ru/developers/api/seo/wordstat のマネージドエンドポイントをご利用ください。Yandex Cloud の認証情報を管理する必要はありません。

Yandex Search（ウェブ検索）：

{
  "mcpServers": {
    "yandex-search": {
      "command": "npx",
      "args": ["-y", "yandex-search-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your_api_key",
        "YANDEX_FOLDER_ID": "your_folder_id"
      }
    }
  }
}

Yandex Webmaster（サイト分析と SEO）：

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "yandex-webmaster-mcp"],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "your_oauth_token"
      }
    }
  }
}

Yandex Metrika（ウェブ分析）：

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "your_oauth_token"
      }
    }
  }
}

Yandex Direct（PPC キャンペーン管理 — デフォルトではサンドボックスを使用します。実際のアカウントには YANDEX_DIRECT_LIVE=1 を設定してください）：

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "your_oauth_token"
      }
    }
  }
}

詳しいセットアップ手順については、各パッケージの README をご覧ください。

seyka.ru のホスト版：Yandex Search · Wordstat · Webmaster · Metrika

オンラインでの利用例：seyka.ru

Claude Code プラグイン

キーワード調査と競合分析のスキルが組み込まれたプラグインとして、5 つすべての MCP をまとめてインストールできます。

# Set your API keys
export YANDEX_SEARCH_API_KEY=your_api_key   # also used by Wordstat
export YANDEX_FOLDER_ID=your_folder_id      # also used by Wordstat
export YANDEX_WEBMASTER_TOKEN=your_oauth_token
export YANDEX_METRIKA_TOKEN=your_oauth_token
export YANDEX_DIRECT_TOKEN=your_oauth_token  # defaults to sandbox

# Run with plugin
claude --plugin-dir /path/to/yandex-tools-mcp

含まれるスキル：

• yandex-keyword-research — キーワード調査、検索ボリューム、トレンド分析で自動的に起動します
• yandex-competitive-analysis — 競合分析と SERP 調査で自動的に起動します

---

ロシア語

パッケージ

パッケージ	説明	npm
yandex-wordstat-mcp	Yandex Wordstat v2 API（Yandex Cloud）を使ったキーワード調査
yandex-search-mcp	Yandex Search API を使ったウェブ検索
yandex-webmaster-mcp	Yandex Webmaster API を使ったサイト分析、インデックス登録、SEO
yandex-metrika-mcp	Yandex Metrika API を使ったウェブ分析とトラフィックデータ
yandex-direct-mcp	Yandex Direct API を使った PPC キャンペーンの管理（キャンペーン、広告、キーワード、入札単価、統計）

クイックスタート

Yandex Wordstat v2（キーワード調査）— Yandex Cloud Search API を使用します。検索と同じキーを使用します。

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "ваш_api_ключ",
        "YANDEX_FOLDER_ID": "ваш_folder_id"
      }
    }
  }
}

すぐに使えるツールが必要ですか？ホスト型エンドポイント seyka.ru/developers/api/seo/wordstat をご利用ください。Yandex Cloud の認証情報を管理する必要はありません。

Yandex Search（ウェブ検索）：

{
  "mcpServers": {
    "yandex-search": {
      "command": "npx",
      "args": ["-y", "yandex-search-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "ваш_api_ключ",
        "YANDEX_FOLDER_ID": "ваш_folder_id"
      }
    }
  }
}

Yandex Webmaster（サイト分析と SEO）：

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "yandex-webmaster-mcp"],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "ваш_oauth_токен"
      }
    }
  }
}

Yandex Metrika（ウェブ分析）：

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "ваш_oauth_токен"
      }
    }
  }
}

Yandex Direct（PPC キャンペーンの管理 — デフォルトではサンドボックスです。本番アカウントでは YANDEX_DIRECT_LIVE=1 を設定してください）：

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "ваш_oauth_токен"
      }
    }
  }
}

詳細な設定手順については、各パッケージの README をご覧ください。

seyka.ru のホスト型バージョン：Yandex Search · Wordstat · Webmaster · Metrika

オンラインでの使用例：seyka.ru

Claude Code 用プラグイン

キーワード調査と競合分析のためのスキルが組み込まれた単一のプラグインとして、5 つすべての MCP をインストールできます。

# Установите API ключи
export YANDEX_SEARCH_API_KEY=ваш_api_ключ   # также используется Вордстатом
export YANDEX_FOLDER_ID=ваш_folder_id       # также используется Вордстатом
export YANDEX_WEBMASTER_TOKEN=ваш_oauth_токен
export YANDEX_METRIKA_TOKEN=ваш_oauth_токен
export YANDEX_DIRECT_TOKEN=ваш_oauth_токен  # по умолчанию песочница

# Запустите с плагином
claude --plugin-dir /path/to/yandex-tools-mcp

含まれるスキル：

• yandex-keyword-research — キーワード調査、検索ボリューム、トレンド分析で自動的に有効になります
• yandex-competitive-analysis — 競合分析と SERP 調査で自動的に有効になります

---

開発

git clone https://github.com/seyka-ai/yandex-tools-mcp.git
cd yandex-tools-mcp
bun install

このリポジトリで Claude Code を起動する前に、bun install を実行してください。 ローカルの .mcp.json は各サーバーを node でソースから実行するため、依存関係がインストールされていないと、すべてのサーバーが起動時にクラッシュし（Cannot find package '@modelcontextprotocol/sdk'）、Claude Code は CONNECTION_CLOSED と報告します。Bun は各パッケージの依存関係を、それぞれの packages/*/node_modules にインストールします。上記のプラグイン設定では npx を使うため、この手順は不要です。

すべてのテストを実行します（test スクリプトがある各パッケージが対象です）：

bun run test

Lint とフォーマット：

bun run lint
bun run format

パッケージを公開します：

cd packages/yandex-wordstat-mcp && npm publish
cd packages/yandex-search-mcp && npm publish
cd packages/yandex-webmaster-mcp && npm publish
cd packages/yandex-metrika-mcp && npm publish
cd packages/yandex-direct-mcp && npm publish

ライセンス

MIT © Seyka AI