bukvarix-mcp

MCP-Server für die Bukvarix API — Keyword-Recherche und Domain-Analyse für den russischsprachigen Suchmarkt (Yandex / Google).

Stellt 5 Tools bereit, die 1:1 auf die HTTP-Endpunkte von Bukvarix abbilden und dabei Prozentkodierung, BOM-Entfernung und Fehleranzeige für Sie übernehmen. Funktioniert sofort mit dem kostenlosen API-Schlüssel (api_key=free).

Tools

Related MCP server: Semrush MCP

Allgemeine Parameter

• q — Phrase, Domain oder durch Zeilenumbruch getrennte Liste

• q2 — zweite Domain oder Ausschlussliste (für mkeywords / site_cmp)

• num — Zeilenanzahl (Standard 250, max. 1.000.000 kostenlos)

• format — json (Standard) / txt / csv / tsv

• region — nur Domains: msk (Standard, Yandex Moskau), gmsk (Google Moskau), 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 — nur site_cmp: intersect (Standard) / domain1_uniq / domain2_uniq

• result_count — nur die Gesamtzahl zurückgeben

• api_key — Überschreibung pro Aufruf; andernfalls BUKVARIX_API_KEY-Umgebungsvariable (Standard: free)

Abfragesyntax (Keywords)

Bukvarix unterstützt Operatoren (werden automatisch prozentkodiert):

• строител* товары — Platzhalter

• !пластиковые !окна — exakte Übereinstimmung

Siehe query_syntax.html#modifiers.

Grenzen der kostenlosen Stufe

• num bis zu 1.000.000; Standard 250

• mkeywords: q ≤ 100 Phrasen, q2 ≤ 250 (101+ ignoriert)

• site_mcmp: ≤ 10 Domains

• Filter broad_from/to, exact_from/to, length_from/to, words_from/to — nur kostenpflichtig (402 kostenlos)

• 429 = Ratenlimit erreicht, pausieren und erneut versuchen. Alternativ können Sie die vollständigen Datenbanken von /about_bases.html herunterladen.

Installation

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

Verwendung mit Hermes

Fügen Sie zu ~/.hermes/config.yaml hinzu:

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

Überprüfen:

hermes mcp test bukvarix

Generische MCP-Konfiguration (z. B. Claude Desktop):

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

Lizenz

MIT