Инструменты MCP

Права и доступ

В настройках токена приложения MCP предоставьте нужные права группы «Яндекс.Вордстат», раздела «Чтение». У каждого инструмента отдельное право с тем же техническим именем. Без права инструмент не появляется для этого токена в tools/list.

Плагин также регистрирует материал для агента «Вордстат: сценарии и подводные камни». Он поясняет ограничения и смысл показателей; его использование зависит от возможностей MCP-клиента.

В группе «Чтение» показаны шесть инструментов с отдельными флажками доступа.

Общие аргументы

Аргументы инструментов задаёт агент на основании вашей просьбы. Они не являются дополнительными полями настроек плагина.

В wordstat_compare_phrases вместо phrase обязателен массив phrases.

Частотность фразы

wordstat_get_phrases получает частотность за последние 30 дней.

Дополнительный аргумент num_phrases задаёт желаемое число похожих запросов: от 1 до 2000, по умолчанию 20. Саму исходную фразу плагин из списка убирает; фактически строк может оказаться меньше запрошенного количества.

Основные поля ответа: total_count — частотность самой фразы, phrases — запросы с её словами, associations — смысловые ассоциации. У строк списков есть phrase и count.

Проверь в Вордстате фразу «садовая мебель» по Москве,
только с телефонов. Передавай phrase без кавычек.
Покажи частотность, 10 похожих запросов и отдельно ассоциации.

Сравнение фраз

wordstat_compare_phrases принимает обязательный phrases — список до 20 фраз. Пустые строки удаляются, точные дубли после обрезки пробелов не повторяются. Превышение предела приводит к отказу, список не обрезается до первых 20.

Ответ rows отсортирован по убыванию частотности. Для каждой фразы возвращаются count, share и до трёх уточнений в refinements. Общая сумма — sum_count, число начатых обработок фраз — requests_spent.

При ошибке отдельной фразы в строке будет count: null, error_code и error_message. При not_configured, access_forbidden или quota_exceeded обработка оставшегося списка прекращается, появляется stopped_after. Даже при ok: true нужно проверить ошибки строк и признак остановки.

Сравни в Вордстате фразы «садовая мебель», «мебель для дачи»
и «уличная мебель» по всей России. Передавай фразы без кавычек.
Покажи частотности, уточнения и requests_spent.
Не называй сумму частотностей общим спросом на тему.

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

Динамика спроса

wordstat_get_dynamics возвращает series — точки с датой date, частотностью count и долей share.

Если даты переданы, плагин проверяет и выравнивает границы. Фактические даты всегда находятся в date_from и date_to; изменения явно переданных дат отражаются в period_adjusted. Подробнее — в правилах чтения результатов.

Покажи динамику спроса на «кондиционер» по месяцам
за последние 12 завершённых месяцев, по всей России.
Передавай phrase без кавычек и назови фактические даты ответа.

Сезонность

wordstat_get_seasonality принимает months: 12 или 24, по умолчанию 24. Текущий неполный месяц не включается. Произвольных дат у этого инструмента нет.

В ответе:

• months — месяцы с date, count и index;
• average_count — средняя месячная частотность;
• peak и low — месяцы с максимальным и минимальным индексом;
• peak_stability и low_stability — проверка повторяемости, если есть два наблюдения соответствующего календарного месяца;
• note — готовое текстовое пояснение.

Оцени сезонность фразы «купить лыжи» за 24 месяца
по всей России. Передавай phrase без кавычек.
Покажи пик, минимум и результат проверки их повторяемости.

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

География спроса

wordstat_get_regions получает распределение за последние 30 дней и сортирует строки по убыванию count.

В regions возвращаются region_id, region_name, count, share, affinity_index. Число строк страницы — row_count, всего строк — total_rows. Для следующей страницы увеличьте offset на limit. Если справочник недоступен, названия могут быть пустыми, но статистика с номерами регионов возвращается.

Аргумента region_ids здесь нет: получить этим методом распределение только внутри выбранной области нельзя.

Покажи 20 первых строк географии спроса на «тепловой насос».
Передавай phrase без кавычек. Сравни частотность и индекс
аффинитивности, не складывай показатели разных территорий.

Агент показывает регионы с индексом аффинитивности, долей запросов и частотностью.

Справочник регионов

wordstat_get_regions_tree не требует обязательных аргументов.

С query возвращаются найденные regions: номер region_id, название name, родитель parent_id / parent_name и уровень level. Без query возвращаются только два верхних уровня tree, а не полный справочник.

Найди в справочнике Вордстата номер Самарской области.
Затем используй найденный region_id для оценки частотности
фразы «купить велосипед» в этом регионе.

Для такой последовательности токену нужны оба права: «Справочник регионов» и «Частотность фразы».