Яндекс Вордстат: Распределение по регионам — MCP-инструмент (tool)

MCP-инструмент (tool) для Яндекс Вордстата: Возвращает, как спрос на фразу распределён по регионам за последние 30 дней.

Техническое имя: regions

Какую задачу решает

Я хочу узнать распределение поискового спроса по регионам.

Возвращает, как спрос на фразу распределён по регионам за последние 30 дней.

Когда использовать

Используйте эту возможность, когда нужен результат «Распределение по регионам» без ручной работы в интерфейсе Яндекс Вордстата. Операция выполняется только по вызову из AI-приложения.

Что нужно передать

• phrase — обязательно. Поисковая фраза для анализа.
• regionMode — необязательно. Группировка: all (по умолчанию), cities (только города) или regions (только субъекты и области).

Что вернёт

Возвращает, как спрос на фразу распределён по регионам за последние 30 дней.

Что изменится в Яндекс Вордстате

Инструмент только читает данные или состояние подключения и не изменяет их.

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

Узнать распределение поискового спроса по регионам в Яндекс Вордстате. Если не хватает обязательных идентификаторов, сначала уточни их.

Возможные ошибки и ограничения

В каждой строке — id региона, count, share и affinityIndex (>100% — интерес в регионе выше среднего, <100% — ниже). regionMode выбирает группировку: all, cities (только города) или regions (только области и субъекты). Сопоставить id регионов с названиями помогает list_regions.

Доступ также зависит от прав токена, квот и ограничений исходного API.

Связанные MCP-инструменты

• Динамика спроса во времени — dynamics
• Справочное дерево регионов — list_regions
• Топ и похожие запросы — top_requests

Технические сведения

• Воздействие: только чтение
• Группа: Поисковый спрос
• Источник описания: регистрация regions в src/tools/wordstat.ts
• Полный технический справочник
• Все MCP-возможности