bukvarix-mcp

用于 Bukvarix API 的 MCP 服务器 — 针对俄语搜索市场（Yandex / Google）的关键词研究和域名分析。

公开了 5 个与 Bukvarix 的 HTTP 端点一一对应的工具，自动处理百分号编码、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 莫斯科）、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