# Яндекс Вордстат: Распределение по регионам — 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.md) — `dynamics`
- [Справочное дерево регионов](./list-regions.md) — `list_regions`
- [Топ и похожие запросы](./top-requests.md) — `top_requests`

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

- **Воздействие:** только чтение
- **Группа:** Поисковый спрос
- **Источник описания:** регистрация `regions` в `src/tools/wordstat.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)