bukvarix-mcp

Bukvarix API용 MCP 서버 — 러시아어 검색 시장(Yandex / Google)을 위한 키워드 조사 및 도메인 분석.

Bukvarix의 HTTP 엔드포인트에 1:1로 매핑되는 5개의 도구를 제공하며, 퍼센트 인코딩, 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 (기본, Yandex Moscow), gmsk (Google Moscow), 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