SEO Tools: XMLRiver SERP (Google + Yandex)

seo-tools-mcp

Русский | English

Восемь универсальных stdio MCP-серверов для SEO: доступ к SERP, Wordstat, Google Search Console, Google Analytics 4, Яндекс.Вебмастеру, Яндекс.Метрике и self-hosted A-Parser прямо из Claude Code (и любого MCP-клиента). Все инструменты read-only — ничего не публикуют и не меняют в твоих аккаунтах, вывод — строгий JSON. Машиночитаемо это заявлено аннотацией readOnlyHint; её намеренно нет у двадцати инструментов, каждый вызов которых тратит платный ресурс (запрос к XMLStock/XMLRiver, прокси-трафик A-Parser) — иначе клиент счёл бы их безобидными и перестал спрашивать подтверждение перед прогоном по большому пулу. К конкретному сайту не привязаны: дефолты (свойство GSC, свойство GA4, хост Вебмастера, счётчик Метрики) настраиваются на лету.

🛰 Эти серверы мы используем в продакшене в [PBN Workers](https://pbn-workers.com/ru/tools/seo-tools-mcp/) — инфраструктура поискового топа: семантика, PBN и сателлиты, автоматизация SEO. Нужен стабильный органический трафик — приходите.

Где опубликовано: npm (восемь пакетов), официальный MCP Registry, [GitHub MCP Registry](https://github.com/mcp/antohins/seo-tools-mcp-gsc) (все восемь серверов), маркетплейс плагинов Claude Code (см. ниже) и .mcpb-бандлы в релизах.

У каждого сервера дополнительно есть auth-инструменты _auth_status и _set_credentials (см. Интерактивная авторизация).

Инструменты по сервисам

xmlstock — SERP Google/Яндекс

• xmlstock_serp — веб-выдача Google/Яндекса (органика + подсветки + SERP-фичи): регион, устройство, safe search, сортировка (Яндекс), период, рекламные блоки; третий движок yandex_xml — официальный Яндекс XML (groupby до 100 за 1 запрос, hlword на любых устройствах, статистика found/found-docs; тариф от 24 ₽/1000)
• xmlstock_images — поиск картинок Google (url страницы + url изображения + заголовок)
• xmlstock_news — новости Google (заголовок, источник, дата, сниппет)
• xmlstock_video — видео Google (url, заголовок, превью, хост, канал, длительность)
• xmlstock_wordstat — Яндекс Wordstat: топ + похожие запросы с частотностью (можно по региону), операторы Wordstat
• xmlstock_wordstat_dynamics — динамика частотности по времени (день/неделя/месяц)
• xmlstock_wordstat_regions — спрос по регионам (count, share, affinity index + имена регионов)
• xmlstock_wordstat_regions_tree — дерево регионов Wordstat (id + имя + путь)
• xmlstock_balance — баланс аккаунта / проверка ключа (бесплатно)

Wordstat через XMLStock — тем же ключом XMLSTOCK_*, что и SERP; не нужен Yandex Cloud (в отличие от отдельного сервера wordstat).

xmlriver — SERP Google/Яндекс + проверка индексации

• xmlriver_serp — органика Google/Яндекса (глубина добирается пагинацией: каждые 10 позиций = 1 платный запрос), флаг наличия AI Overview; опция includeAIOverview — полный текст Обзора от ИИ + цитируемые ссылки (платный ai=1, только Google); includeAdditional — доп. SERP-блоки Google из (knowledge_graph, localresultsplace, rs и др.; наполнение зависит от платных опций кабинета XMLRiver, непришедшие блоки — в additional.unavailable); гео-таргетинг Google — location (город → loc, «Moscow»/«1011969») и country (ISO/числовой id, автовыводится из города); device — desktop/mobile/tablet, os (ios/android) отправляется только при device=mobile
• xmlriver_images — картинки Google (страница + url картинки + заголовок + источник + размеры); гео — location/country
• xmlriver_news — новости Google (заголовок, источник, дата, сниппет), фильтр по времени; гео — location/country
• xmlriver_maps — поиск заведений по Google Maps (setab=maps, обязательные zoom 1–15 и coords «широта,долгота», count 5–50): название, рейтинг, адрес, телефон, сервисы, координаты, place_id, число отзывов. ВАЖНО: формат по доке, лайвом не подтверждён (на тестовом аккаунте эндпоинт устойчиво отвечает кодом 500 — вероятно, нужна платная опция кабинета)
• xmlriver_check_index — проверка индексации URL в Google/Яндексе (inindex)
• xmlriver_suggest — поисковые подсказки Google (до 50 фраз за вызов, платно за каждую фразу); гео подсказок — location/country
• xmlriver_related_questions — блок «Вопросы по теме» / People Also Ask Google (вопросы всегда; ответы — только при включённой платной опции «Related Questions с ответами» в кабинете)
• xmlriver_balance — баланс аккаунта / проверка ключа (бесплатно)

wordstat — частотности Яндекса

• wordstat_frequency — широкая и точная частотность, уточняющие запросы (related) и ассоциации
• wordstat_dynamics — частотность по времени (день/неделя/месяц)
• wordstat_regions — распределение по регионам с индексом аффинити и именами регионов
• wordstat_regions_tree — полное дерево регионов Вордстата (id + имя)

gsc — Google Search Console

• gsc_query — Search Analytics (клики/показы/CTR/позиция), авто-пагинация, dataState final/all, произвольные фильтры измерений (filters, AND-семантика) и aggregationType (auto/byProperty/byPage)
• gsc_inspect_url — URL Inspection: статус индексации, покрытие, canonical, последний обход, mobile usability, rich results
• gsc_list_sites — свойства, доступные авторизации
• gsc_get_site — уровень доступа к свойству
• gsc_list_sitemaps — отправленные sitemap со статусом
• gsc_get_sitemap — детали одного sitemap

Даты Search Analytics — по Pacific Time (не МСК); история ~16 месяцев; финальные данные отстают на ~2-3 дня (свежие — dataState=all); ctr в ответе — доля 0..1.

ga4 — Google Analytics 4

• ga4_list_properties — свойства GA4, доступные авторизации (отсюда берётся propertyId — это не Measurement ID G-XXXXXXX)
• ga4_metadata — какие измерения и метрики доступны в ЭТОМ свойстве, включая кастомные (customEvent:…); поиск подстрокой, blockedReasons (по такой метрике отчёт вернёт нули) и type (целое/дробное для metricFilters)
• ga4_check_compatibility — совместима ли связка измерений/метрик в этом свойстве, без тяжёлого отчёта; при несовместимости — какие поля убрать
• ga4_report — произвольный отчёт: любые измерения × метрики, фильтры по измерениям, сортировка (полный Data API runReport)
• ga4_bytime — динамика метрик по времени (день/час/неделя/месяц)
• ga4_traffic_sources — источники трафика: группа каналов, source/medium, кампания; organicOnly — только органика
• ga4_geo — страна/регион/город
• ga4_devices — тип устройства/ОС/браузер
• ga4_top_pages — топ страниц по pagePath, странице входа или заголовку; фильтры organicOnly и pathContains
• ga4_events — события по eventName; keyEventsOnly — только ключевые события (бывшие конверсии)
• ga4_realtime — отчёт в реальном времени (последние 30 минут)
• ga4_funnel — воронка (runFunnelReport): сколько дошло до каждого шага и где отвалились; шаг = событие и/или условия по измерениям, разбивка по измерению. Внутри шагов действует схема Exploration API (pagePath там недоступен), корзина квоты отдельная и запрос дороже обычного отчёта
• ga4_annotations — аннотации свойства: пометки на датах, включая созданные самой GA4 (systemGenerated) — частое объяснение необъяснимого скачка в динамике
• ga4_property_details — карточка свойства: таймзона отчётов, валюта, уровень сервиса (STANDARD/360) и потоки данных с их Measurement ID G-XXXXXXX

Во всех отчётных инструментах есть includeQuota — сколько «токенов» Data API съел запрос и сколько осталось на час/сутки.

Единицы и даты: bounceRate/engagementRate GA4 отдаёт долей 0..1 (не процентами); даты считаются в таймзоне свойства — принимаются YYYY-MM-DD и ключевые слова GA4 (today, yesterday, 28daysAgo), фактическая таймзона возвращается в ответе. В ответах есть totalRows/truncated, а thresholded: true означает, что часть данных скрыта порогом конфиденциальности GA4.

ywm — Яндекс.Вебмастер

• ywm_hosts — id пользователя + подтверждённые сайты
• ywm_summary — ИКС, страниц в поиске, исключено, проблемы сайта по важности
• ywm_search_queries — аналитика запросов по URL (~2 недели по умолчанию; переопределяется dateFrom/dateTo)
• ywm_queries_history — суммарные показы/клики/позиции по времени
• ywm_recommended_queries — приближённые рекомендованные запросы (спрос + недобор кликов)
• ywm_popular — популярные запросы хоста
• ywm_indexing_history — страниц в поиске по времени
• ywm_sqi_history — ИКС по времени
• ywm_external_links — выборка внешних ссылок + общее число
• ywm_broken_links — битые внутренние/внешние ссылки
• ywm_diagnostics — проблемы сайта
• ywm_important_urls — отслеживаемые URL со статусом индексации/поиска
• ywm_sitemaps — sitemap со статусом

metrika — Яндекс.Метрика

• metrika_report — произвольный отчёт: любые dimensions × metrics, фильтры, сортировка (полный Stat API)
• metrika_bytime — метрики по времени (день/неделя/месяц/час)
• metrika_traffic_sources — визиты/пользователи/отказы по источникам трафика
• metrika_geo — визиты по стране/региону/городу
• metrika_devices — визиты по устройству/ОС/браузеру
• metrika_goals — список целей (конверсий)
• metrika_counters — доступные счётчики
• metrika_landing_behavior — поведение на посадочных + достижения целей
• metrika_search_phrases — поисковые фразы (органика)
• metrika_top_landings — т