bukvarix-mcp

Servidor MCP para la API de Bukvarix — investigación de palabras clave y análisis de dominios para el mercado de búsqueda en ruso (Yandex / Google).

Expone 5 herramientas que se corresponden 1:1 con los endpoints HTTP de Bukvarix, manejando la codificación por porcentaje, la eliminación de BOM y la presentación de errores por ti. Funciona de serie con la clave de API gratuita (api_key=free).

Herramientas

Related MCP server: Semrush MCP

Parámetros comunes

• q — frase, dominio o lista separada por saltos de línea

• q2 — segundo dominio o lista de exclusión (para mkeywords / site_cmp)

• num — número de filas (por defecto 250, máximo 1.000.000 en la versión gratuita)

• format — json (por defecto) / txt / csv / tsv

• region — solo dominios: msk (por defecto, Yandex Moscú), gmsk (Google Moscú), 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 — solo site_cmp: intersect (por defecto) / domain1_uniq / domain2_uniq

• result_count — devolver solo el recuento total

• api_key — anulación por llamada; de lo contrario, la variable de entorno BUKVARIX_API_KEY (por defecto free)

Sintaxis de consulta (palabras clave)

Bukvarix admite operadores (codificados automáticamente en porcentaje):

• строител* товары — comodín

• !пластиковые !окна — coincidencia exacta

Ver query_syntax.html#modifiers.

Límites de la versión gratuita

• num hasta 1.000.000; por defecto 250

• mkeywords: q ≤ 100 frases, q2 ≤ 250 (101+ ignorados)

• site_mcmp: ≤ 10 dominios

• Filtros broad_from/to, exact_from/to, length_from/to, words_from/to — solo de pago (402 en la versión gratuita)

• 429 = límite de velocidad, pausa y reintenta. Alternativamente, descarga las bases completas desde /about_bases.html.

Instalación

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

Uso con Hermes

Añade a ~/.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

Verifica:

hermes mcp test bukvarix

Configuración MCP genérica (por ejemplo, Claude Desktop):

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

Licencia

MIT