bukvarix-mcp

MCP-сервер для Bukvarix API — исследование ключевых слов и анализ доменов для русскоязычного рынка поиска (Яндекс / Google).

Предоставляет 5 инструментов, которые соотносятся 1:1 с HTTP-эндпоинтами Bukvarix, беря на себя процентное кодирование, удаление BOM и вывод ошибок. Работает из коробки с бесплатным API-ключом (api_key=free).

Инструменты

Related MCP server: Semrush MCP

Общие параметры

• q — фраза, домен или список, разделённый переводами строк

• q2 — второй домен или список исключений (для mkeywords / site_cmp)

• num — количество строк (по умолчанию 250, максимум 1 000 000 на бесплатном тарифе)

• format — json (по умолчанию) / txt / csv / tsv

• region — только для доменов: msk (по умолчанию, Яндекс Москва), 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