Частотность запросов в руках ИИ-агента: спрос, сезонность, регионы
Плагин к приложению MCP открывает данные Яндекс.Вордстата для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются к сайту и собирают семантику сами: что ищут чаще, когда спрос растёт, где им интересуются сильнее обычного. Шесть инструментов, все только на чтение.
Частотность и семантика
Сколько раз в месяц ищут фразу, какие запросы с ней задают и что ищут вместо неё. Отдельным инструментом — сравнение сразу списка фраз с долей каждой: так за один вопрос видно, на что делать страницу.
Динамика и сезонность
Ряд по дням, неделям или месяцам за любой период. А сезонность агент получает уже посчитанной: индекс каждого месяца к среднему, пик, провал — и проверка, повторился ли пик во втором году или это был разовый всплеск.
География спроса
Распределение по регионам и городам с индексом аффинитивности: где темой интересуются сильнее, чем в среднем по стране. Названия регионов подставлены — агенту не придётся ходить за ними вторым вызовом.
Справочник регионов
Номер региона по части названия — чтобы «Самарская область» превратилась в число, которое примут остальные инструменты. Справочник кешируется на сутки, так что платным будет только первое обращение за день.
Это единственный источник, который знает весь спрос
Яндекс.Вебмастер показывает запросы, по которым сайт уже показывается, — то есть тот спрос, который вы и так собираете. Яндекс.Директ отвечает только «будут показы или нет», без чисел. Сколько людей ищет тему на самом деле и какая доля из них до вас не доходит, знает только Вордстат.
Связка, ради которой всё и делалось: Вордстатом смотрим весь спрос, Вебмастером — какую его часть забираем. Разница между ними и есть упущенное.
Агент предупреждён о главной ошибке Вордстата
В интерфейсе Вордстата частотность уточняют операторами: кавычки, восклицательный знак, квадратные скобки, плюс. В API их нет — и это ловушка, а не ограничение, потому что ошибки в ответ он не вернёт.
Мы проверили: на фразу в кавычках API отвечает успехом, только частотность там 39 997 против 148 627 у той же фразы без кавычек, а в списке похожих запросов первая же строка показывает 1 439 414. Он не спотыкается — он молча считает что-то другое, и понять это по ответу нельзя.
Поэтому плагин на такую фразу отказывает сам и объясняет почему. Молча посчитанное не то — худший исход из возможных: агент выдал бы чужое число за ответ и ничего не заподозрил.
Вместе с инструментами плагин отдаёт агенту страницу документации — MCP-клиент читает её сам. В ней ровно то, обо что спотыкаются модели:
- частотность — это показы запроса в поиске, а не переходы на сайт
- «похожие запросы» и «ассоциации» — разные списки, складывать их в одну таблицу нельзя
- индекс аффинитивности — индекс, где 100 это норма, а не проценты
- сравнение двадцати фраз — это двадцать обращений к API, и агент видит их число в ответе
Периоды агент считать не обязан
Вордстат принимает только целые периоды: месяц — с первого по последнее число, неделя — с понедельника по воскресенье. Модель, которой надо угадать эти границы до первого вопроса, спотыкается на них раз за разом и получает отказ Яндекса вместо данных.
Плагин подтягивает границы сам и сообщает об этом отдельным полем — агент видит, какой период получился на самом деле, и называет пользователю его, а не запрошенный. Без дат берутся последние 12 месяцев, а текущий, неполный месяц не включается: иначе последняя точка ряда выглядела бы обвалом спроса, которого нет.
Отдельная ловушка — ряд по дням: Вордстат отдаёт его только за последние 60 дней, а на более раннюю дату отвечает отказом. Плагин подтягивает начало к границе и объясняет агенту, что за днями глубже двух месяцев ходить некуда — там нужен недельный или месячный шаг.
Вы решаете, что агенту можно
У каждого инструмента своё право. Выдавая токен в приложении MCP, вы отмечаете нужные — и агент физически не видит остальных инструментов. Менять в Вордстате нечего: все шесть только читают.
Что нужно для работы
- приложение MCP версии 1.3.0 или новее — оно держит сервер и токены
- аккаунт в Yandex Cloud с включённым биллингом и Api-Key сервисного аккаунта — как его получить, ниже
- исходящий HTTPS к searchapi.api.cloud.yandex.net — ни Node, ни cron, ни своих таблиц в базе плагин не требует
- MCP-клиент: Claude Desktop, Cursor, любой другой или собственный скрипт
Как получить доступ к Вордстату
Доступ сейчас один — через Yandex Cloud (он же AI Studio). Прежний вход по OAuth-токену закрыт: Яндекс перевёл Вордстат в состав Yandex Search API.
- Завести аккаунт в Yandex Cloud, привязать способ оплаты и пополнить счёт. Обращения к Вордстату платные, и без положительного баланса сервис отвечает отказом даже с верным ключом.
- Выбрать каталог — обычно это default.
- Завести сервисный аккаунт с ролью search-api.webSearch.user. Если ключ создаётся через интерфейс AI Studio, сервисный аккаунт с нужной ролью заводится автоматически; если ключ делали руками в консоли — роль надо назначить самому.
- Получить Api-Key этого сервисного аккаунта.
- Вставить ключ в настройки плагина и, если нужно, задать регионы по умолчанию.
Всё. Идентификатор каталога, который требует документация Yandex Cloud, плагин не спрашивает: мы проверили — API отвечает и без него. Обязательное поле, которое ни на что не влияет, нужно только для того, чтобы в нём ошибиться.
Сколько это стоит
Обращения к Вордстату платит Яндекс Клауд, а не мы. Плагин покупается один раз, а запросы тарифицируются на вашем облачном аккаунте. По нашим замерам в августе 2026 запрос обходится примерно в две-три копейки: два десятка вызовов — меньше полурубля. Тариф устанавливает Яндекс и может его менять, поэтому считайте это ориентиром, а не обещанием.
Что об этом полезно знать заранее:
- сравнение списка из двадцати фраз — это двадцать обращений, а не одно: метода «посчитай список» в Вордстате нет. Плагин возвращает фактический расход полем requests_spent, чтобы это не было сюрпризом;
- справочник регионов тарифицируется как обычный запрос, но кешируется на сутки: платным окажется только первое обращение, дальше номера регионов ищутся бесплатно;
- расход и остаток видно в консоли Yandex Cloud; в самом API метода «сколько потрачено» нет.
Если Яндекс отвечает «отказано в доступе»
Отказ приходит один и тот же, а причин у него три — по ответу Яндекса их не различить, поэтому плагин перечисляет все прямо в тексте ошибки:
- в Yandex Cloud не привязан способ оплаты;
- на счету кончились деньги — обращения платные;
- сервисному аккаунту не выдана роль search-api.webSearch.user.
Чаще всего дело в первых двух, и перевыпуск ключа в этом случае не помогает — а именно с него обычно и начинают. Остальные отказы плагин тоже переводит на человеческий: «упёрлись в лимит», «сервис занят, повторите», «во фразе оператор» — вместо служебной обёртки gRPC, из которой агент выуживает смысл сам. Идентификатор запроса, который спрашивает поддержка Яндекса, плагин кладёт в ответ отдельным полем.
Мы в социальных сетях
Узнавайте первыми о наших новых решениях и акциях.
- Вконтакте — https://vk.com/easyweb_su
- Телеграм — https://t.me/easyweb_su