xmlriver-mcp

MCP-сервер к платному сервису XMLRiver: разбор выдачи Google и Яндекса, частотность Вордстата и подсказки одним пакетом

MCP-сервер

Низкий риск

Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.

Почему такой уровень

  • Все инструменты только читают публичную выдачу и статистику, ничего не меняют
  • Каждый вызов списывает деньги с баланса XMLRiver, стоит проверять get_balance перед массовыми задачами
Все причины и проверки
Российский стек

artgas1/xmlriver-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/xmlriver-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'XMLRIVER_USER=<ваш XMLRIVER_USER>' --env 'XMLRIVER_KEY=<ваш XMLRIVER_KEY>' xmlriver-mcp -- uvx xmlriver-mcp==0.1.8

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"xmlriver-mcp","type":"stdio","command":"uvx","args":["xmlriver-mcp==0.1.8"],"env":{"XMLRIVER_USER":"<ваш XMLRIVER_USER>","XMLRIVER_KEY":"<ваш XMLRIVER_KEY>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "xmlriver-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add xmlriver-mcp --env 'XMLRIVER_USER=<ваш XMLRIVER_USER>' --env 'XMLRIVER_KEY=<ваш XMLRIVER_KEY>' -- uvx xmlriver-mcp==0.1.8

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.xmlriver-mcp]
command = "uvx"
args = ["xmlriver-mcp==0.1.8"]
env = { XMLRIVER_USER = "<ваш XMLRIVER_USER>", XMLRIVER_KEY = "<ваш XMLRIVER_KEY>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'XMLRIVER_USER=<ваш XMLRIVER_USER>' -e 'XMLRIVER_KEY=<ваш XMLRIVER_KEY>' xmlriver-mcp uvx xmlriver-mcp==0.1.8

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "xmlriver-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "xmlriver-mcp==0.1.8"
      ],
      "environment": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "xmlriver-mcp": {
      "command": "uvx",
      "args": [
        "xmlriver-mcp==0.1.8"
      ],
      "env": {
        "XMLRIVER_USER": "<ваш XMLRIVER_USER>",
        "XMLRIVER_KEY": "<ваш XMLRIVER_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

XMLRIVER_USERсекрет, обязательная
XMLRIVER_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит cf86481.

Текст для агента

Установи сервер командой uvx xmlriver-mcp, добавь в MCP-клиента с переменными XMLRIVER_USER и XMLRIVER_KEY из личного кабинета xmlriver.com, затем проверь баланс инструментом get_balance.

Другие способы из описания автора
uvx xmlriver-mcp

Основной способ из README, пакет опубликован в PyPI.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер оборачивает XML API сервиса XMLRiver и дает одиннадцать инструментов: разбор выдачи Google и Яндекса с учетом страны, региона, устройства и доп. блоков вроде FAQ и AI Overview, официальный Yandex Search API v2 через XMLRiver, частотность и историю Вордстата, подсказки автодополнения, проверку индексации URL в Google и Яндексе и учетные инструменты, баланс, тариф, стоимость 1000 запросов по нужному движку. Все инструменты помечены только для чтения, `raw=page` и отложенный режим ответа намеренно не реализованы, чтобы не тянуть мегабайты HTML в контекст модели.

Для кого. Для SEO-специалистов и маркетологов, которым нужны и Google, и Яндекс в одном MCP-сервере без отдельной подписки на каждый источник.

Подходит, если

  • Нужно отследить позиции в Яндексе или Google по своим и чужим запросам
  • Нужна частотность и сезонность Вордстата вместе с выдачей по тому же запросу
  • Нужны длинные подсказки автодополнения, которых нет в Вордстате

Не подходит, если

  • Нет и не готовы завести оплаченный аккаунт XMLRiver
  • Нужен бесплатный источник: XMLRiver берет деньги за каждую тысячу запросов

Пример запроса к агенту

Проверь частотность фразы «купить айфон» в Вордстате и покажи топ-10 Яндекса по этому запросу

Ограничения

Нужен аккаунт XMLRiver с пополненным балансом (от 100 рублей), стоимость от 12 до 25 рублей за 1000 запросов в зависимости от тарифа. API XMLRiver работает по HTTP, а не HTTPS, ключ можно сменить в личном кабинете при утечке. Инструмент google_maps_search на момент написания README не проверен на живом ответе: сервис возвращал ошибку 500 на все запросы к этому режиму.

Как отключить. Удалите сервер из конфигурации клиента (claude mcp remove xmlriver) и при желании смените ключ XMLRIVER_KEY в личном кабинете сервиса.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
XMLRIVER_USER
обязательная, секрет
Числовой ID пользователя XMLRiver.
XMLRIVER_KEY
обязательная, секрет
40-символьный hex-ключ из личного кабинета XMLRiver.

Проверка безопасности

  • Все инструменты только читают публичную выдачу и статистику, ничего не меняют
  • Каждый вызов списывает деньги с баланса XMLRiver, стоит проверять get_balance перед массовыми задачами

Коротко о README

README описывает инструменты по категориям (поиск, индексация, аккаунт), дает готовые команды установки для Claude Desktop, Claude Code и Cursor, таблицу тарифов XMLRiver и примеры типичных задач: отслеживание позиций, подбор ключевых слов, охота за featured snippet и мониторинг индексации.

Частые вопросы

Это официальный сервер XMLRiver?

Нет, независимый проект стороннего разработчика поверх публичного XML API сервиса.

Сколько стоит один запрос?

От 12 до 25 рублей за 1000 запросов в зависимости от тарифа и типа запроса; перед массовыми операциями стоит вызвать get_cost.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12Звезды репозитория
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2Звезды репозитория
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.Звезды репозитория

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.Звезды репозитория
Foxx AIxmlriver-mcp

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.