xmlriver-mcp

xmlriver-mcp

artgas1MIT
xmlriver-mcp — это MCP-сервер для доступа к API XMLRiver. Он даёт AI-помощникам возможность парсить поисковые выдачи Google и Яндекс, а также получать данные о частотности ключевых слов из Яндекс Wordstat. Это инструмент для SEO-специалистов и разработчиков, которым нужен автоматический сбор данных с поисковых систем для анализа рынка, конкурентов или оптимизации сайта. Сервер использует API XMLRiver, работающий по модели pay-as-you-go: базовый тариф около 25 рублей за 1000 запросов. Wordstat — это инструмент Яндекса для оценки популярности поисковых запросов. xmlriver-mcp даёт доступ не только к текущей частотности, но и к истории её изменения по месяцам и похожим запросам, что помогает в составлении семантического ядра и анализе сезонности. Это первая MCP-интеграция для XMLRiver, которая закрывает потребность русскоязычных команд в анализе данных Яндекса и Google без написания собственных парсеров.
DevelopmentYandex
Открыть на GitHub

Установка

uvx xmlriver-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикartgas1
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Парсинг Google SERP: органические результаты, рекламные объявления, блоки FAQ, граф знаний и AI Overview. Поддерживается настройка страны, региона и типа устройства.
  • Парсинг Яндекс SERP для русскоязычного рынка — данные, которые Яндекс показывает пользователям в ответ на запрос.
  • Получение текущей частотности ключевых слов из Яндекс Wordstat.
  • Запрос истории частотности по месяцам для анализа сезонных изменений.
  • Поиск похожих запросов в Wordstat для расширения семантического ядра.
  • Проверка индексации URL в Google и Яндекс — статус нахождения страницы в индексе.
  • Операции с аккаунтом XMLRiver: баланс, текущий тариф, стоимость 1000 запросов.

Как подключить

Для работы требуется Python 3.10 или новее. Установите сервер с помощью uvx:

uvx xmlriver-mcp

Добавьте конфигурацию в Claude Desktop. Отредактируйте файл claude_desktop_config.json (путь зависит от ОС):

{ "mcpServers": { "xmlriver": { "command": "uvx", "args": ["xmlriver-mcp"], "env": { "XMLRIVER_USER": "<your_numeric_user_id>", "XMLRIVER_KEY": "<your_40_char_hex_key>" } } } }

Замените <your_numeric_user_id> и <your_40_char_hex_key> на свои данные из личного кабинета XMLRiver. После этого перезапустите клиент.

Сервер также можно подключить к Cursor и Windsurf через аналогичные конфигурационные файлы.

Примеры запросов

  • «Покажи топ-10 органических результатов в Google для запроса «купить ноутбук» с регионом Москва.»
  • «Получи частотность ключевого слова «ремонт квартир» в Яндекс Wordstat за последние 3 месяца.»
  • «Проверь индексацию страницы https://example.com в Google и Яндекс.»
  • «Выведи баланс моего аккаунта XMLRiver и стоимость 1000 запросов.»

Технические детали

Язык: Python. Транспорт: stdio. Лицензия: MIT. Совместимые клиенты: Claude Desktop, Claude Code, Cursor, Windsurf. Для работы требуется учётная запись XMLRiver с активным API-ключом.

Поделиться