Команда Infostart представила готовое решение для автоматической проверки поисковых запросов с использованием искусственного интеллекта и сервиса Wordstat. Ранее ИИ-агенты генерировали гипотезы по целевой аудитории, но не могли самостоятельно верифицировать их актуальность. Теперь агент подключен к Wordstat через API, что позволяет ему проверять частотность запросов и собирать данные напрямую, исключая ручной перенос информации между сервисами. Решение реализовано в виде read-only пакета на Python, включающего четыре метода работы с Wordstat, командную строку и MCP-сервер, код и тесты которого доступны в открытом репозитории.
Интеграция позволяет агенту возвращать фразы с частотностями в рамках одного диалога. В качестве примера приводится задача по анализу спроса на автоматизацию маркетинга в России за последний месяц: агент формирует запрос, получает пять самых частотных формулировок с числовыми показателями и возвращает их в ответе. Для воспроизведения интеграции созданы фиксированные теги в репозитории, например wordstat-v0.1.1, которые привязывают команды и код к конкретной версии статьи. Для работы сервисаному аккаунту назначается роль search-api.webSearch.user, а API-ключ создается со scope yc.search-api.execute.
Архитектура решения разделяет получение данных и их интерпретацию, предоставляя агенту четыре отдельных инструмента, соответствующих методам официального Wordstat API: поиск популярных и связанных фраз, анализ частотности по времени для выявления сезонности, расчет интереса по регионам и преобразование названий территорий в ID. Все операции являются только для чтения, пакет не меняет рекламные кампании и не требует контура согласования для записи в Директ. Клиент валидирует запросы до отправки, используя Pydantic для проверки типов, и обрабатывает ошибки с экспоненциальной задержкой, очищая секреты из сообщений об ошибках.
Стоимость использования сервиса по тарифу Yandex Search API (данные проверены 23 октября 2026 года) составляет 0,02 рубля за один вызов для базовых методов и 0,05 рубля для анализа динамики. Полный проход по трем платным методам обходится в 0,09 рубля. Для оптимизации расходов реализован локальный кэш, который хранит снимки данных на основе SHA256-хеша запроса: обычные ответы кэшируются семь дней, дерево регионов — 30 дней. Кэш ограничивает лишние обращения к API, но агент может обходить его явно через флаг refresh=true или изменяя параметры запроса. В текущей версии MCP-сервер поддерживает лимит в 200 фраз для инструмента топа, а тесты пакета не обращаются к платному API, используя замоченные HTTP-ответы.
