xmlriver-mcp
MCP-сервер к платному сервису XMLRiver: разбор выдачи Google и Яндекса, частотность Вордстата и подсказки одним пакетом
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Все инструменты только читают публичную выдачу и статистику, ничего не меняют
- Каждый вызов списывает деньги с баланса XMLRiver, стоит проверять get_balance перед массовыми задачами
Установка
В терминале, через 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/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секрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
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секрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи сервер командой 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
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов