bukvarix-mcp

Bukvarix API 用のMCPサーバー — ロシア語検索市場（Yandex / Google）向けのキーワード調査とドメイン分析。

BukvarixのHTTPエンドポイントに1:1で対応する5つのツールを公開し、パーセントエンコーディング、BOM除去、エラー表示を自動処理します。無料APIキー（api_key=free）でそのまま動作します。

ツール

Related MCP server: Semrush MCP

共通パラメータ

• q — フレーズ、ドメイン、または改行区切りのリスト

• q2 — 2番目のドメイン、または除外リスト（mkeywords / site_cmp 用）

• num — 行数（デフォルト250、無料では最大1,000,000）

• format — json（デフォルト）/ txt / csv / tsv

• region — ドメインのみ: msk（デフォルト、Yandexモスクワ）、gmsk（Googleモスクワ）、spb、rus、nsk、ekb、kzn、nnv、kry、che、sam、ufa、rnd、krr、oms、vrn、prm、vlg、sar、tmn、tom、gkiev、minsk、gminsk、nursul

• comparison_type — site_cmp のみ: intersect（デフォルト）/ domain1_uniq / domain2_uniq

• result_count — 合計数のみを返す

• api_key — 呼び出しごとの上書き。それ以外は BUKVARIX_API_KEY 環境変数（デフォルトは free）

クエリ構文（キーワード）

Bukvarixは演算子をサポート（パーセントエンコーディングは自動処理）:

• строител* товары — ワイルドカード

• !пластиковые !окна — 完全一致

query_syntax.html#modifiers を参照。

無料枠の制限

• num は最大1,000,000、デフォルト250

• mkeywords: q は100フレーズ以下、q2 は250以下（101以上は無視）

• site_mcmp: 10ドメイン以下

• フィルター broad_from/to、exact_from/to、length_from/to、words_from/to — 有料のみ（無料では402）

• 429 = レート制限。一時停止して再試行してください。または、/about_bases.html から完全なベースをダウンロードしてください。

インストール

git clone https://github.com/frankydzoro/bukvarix-mcp.git
cd bukvarix-mcp
npm install

Hermesでの使用

~/.hermes/config.yaml に追加:

mcp_servers:
  bukvarix:
    command: node
    args: [/absolute/path/to/bukvarix-mcp/src/index.js]
    enabled: true
    env:
      BUKVARIX_API_KEY: free   # or your paid key

確認:

hermes mcp test bukvarix

汎用MCP設定（例: Claude Desktop）:

{
  "mcpServers": {
    "bukvarix": {
      "command": "node",
      "args": ["/absolute/path/to/bukvarix-mcp/src/index.js"],
      "env": { "BUKVARIX_API_KEY": "free" }
    }
  }
}

ライセンス

MIT