MCP для Яндекс Вордстата

Как дать ИИ-агенту доступ к частотности запросов: выпустить токен, собрать адрес, добавить его в агентную среду и проверить связь одной фразой.

Подключение к рекламному кабинету — кампании, ставки, отчёты — описано отдельно: MCP для Яндекс Директа.

Задача

Агент собирает семантику для кампании, и ему нужны настоящие числа: сколько показов в месяц собирает запрос в Яндексе в вашем регионе. Без подключения эти числа приходится снимать в Вордстате руками и переносить в диалог — по одной фразе. Связь агента с Вордстатом даёт MCP: так называется подключение агента к внешней системе. Через него агент отправляет список фраз и получает по каждой число показов в месяц и дату замера. Дата важна: часть значений приходит из старого кэша, об этом ниже. Эта статья доводит до момента, когда агент по просьбе называет частотность фразы с датой.

Что понадобится

• Агентная среда — программа, в которой работает агент. Она должна поддерживать подключение MCP по адресу.
• Аккаунт click.ru и доступ к его профилю: в профиле выпускается API-токен. Рекламный кабинет для этого подключения не нужен — подключение проверяет только токен, поэтому отдельной формы адреса для кабинета, заведённого напрямую в Яндексе, здесь нет: частотность одинаково доступна любому аккаунту click.ru. Кабинет понадобится позже, когда агент будет заводить кампанию, — это отдельное подключение к Яндекс Директу.

Устанавливать на компьютер ничего не требуется: в агентную среду добавляется адрес, сервер подключения работает на стороне click.ru. Свой доступ к Вордстату тоже не нужен — его держит сервер.

Адрес подключения

Форма адреса одна:

https://wordstat-mcp.aihub.click.ru/c/<токен click.ru>

Хвост /mcp в конце допускается — если среда подставляет его сама, исправлять ничего не нужно. В среде, где настраиваются заголовки запроса, тот же токен можно передать заголовком к адресу https://wordstat-mcp.aihub.click.ru/mcp — тогда он не попадает в адрес.

Адрес подключения равносилен паролю. В строке зашит ваш API-токен click.ru, а он открывает и Вордстат, и кабинеты Яндекс Директа и VK Рекламы этого аккаунта. Адрес не пересылают в переписке и не публикуют. Если он всё-таки ушёл — нажмите в профиле click.ru «пересоздать»: новый токен заменит прежний. Старый адрес перестанет работать в течение нескольких минут: подключение хранит результат проверки токена короткое время. Остальные подключения придётся собрать заново — с новым токеном.

Шаги

Шаг 1. Получите API-токен click.ru

Откройте профиль click.ru и найдите поле «API Token». Если в поле уже есть токен, используйте его: токен один на все подключения через click.ru из этого аккаунта — к Директу, Вордстату и VK Рекламе. Новый токен заменяет прежний, и все подключения на старом перестают работать, их приходится собирать заново. Поэтому «пересоздать» нажимают только при утечке. Если поле пустое, нажмите «Создать».

Результат: в поле «API Token» есть строка — её можно скопировать.

Шаг 2. Соберите адрес подключения

Подставьте токен в форму:

https://wordstat-mcp.aihub.click.ru/c/<токен click.ru>

Вместо <токен click.ru> — строка из шага 1, угловые скобки уберите.

Результат: адрес собран одной строкой, без пробелов и переносов. Проверить его можно прямо в браузере: откройте адрес с хвостом /tools — при верном токене откроется список инструментов подключения, при ошибке в токене — отказ.

Шаг 3. Добавьте подключение в агентную среду

Добавьте собранный адрес в среду как MCP. Где именно это делается, зависит от среды.

Результат: подключение появилось в списке подключений среды.

ClaudeCodex

В приложении Claude: Настройки → Connectors → Add custom connector. Имя любое, в поле адреса вставьте собранный адрес и нажмите Continue, затем Add. Способ аутентификации оставьте тем, который приложение определит само.

В приложении ChatGPT откройте Codex, затем настройки → Плагины → Добавить → Добавить сервер MCP. Тип — «Потоковая передача HTTP», имя любое, в поле URL вставьте собранный адрес, остальные поля оставьте пустыми и нажмите «Сохранить».

Шаг 4. Перезапустите агентную среду

Закройте среду и откройте заново. Пока сессия не перезапущена, новое подключение может не появиться в списке инструментов.

Результат: подключение отмечено как доступное, у него виден набор инструментов Вордстата.

Как убедиться, что получилось

Подключение только читает Вордстат — до рекламных кабинетов оно не дотягивается, поэтому любая команда безопасна.

• Проверь частотность фразы «паркет» по России и покажи дату замера. — придёт число показов в месяц и дата.
• Проверь частотность этих фраз по Санкт-Петербургу: … — по каждой фразе из списка придёт своё число.

Пришло число и дата — подключение работает. Совпадать с сегодняшним Вордстатом число не обязано: старое значение из кэша расходится с ним, об этом в разделе «Чего подключение не делает».

Что агент умеет через это подключение

• Проверять частотность списком — до 1000 фраз за один вызов. Собранное ядро проверяется целиком, а не по одной фразе.
• Считать по региону — регион задаётся номером из общего справочника регионов Яндекса, того же, что в Директе: Москва — 213, Москва и область — 1, Санкт-Петербург — 2, Россия — 225. При подключённом MCP Директа агент найдёт номер по названию региона в справочнике кабинета. Если регион не передан, сервер считает по Москве — называйте регион явно. Один вызов — один регион; для нескольких регионов агент делает несколько вызовов.
• Проверять точную словоформу — как оператор «!» в Вордстате: «купить диван» и «купить диваны» считаются отдельно. По умолчанию счёт широкий, как в интерфейсе Вордстата.
• Проверять большие списки отложенно — длинный список ставится в очередь, результат забирается позже, чтобы вызов не оборвался по времени. Забирайте результат в той же сессии: в очереди он хранится ограниченное время.

Чего подключение не делает

• Не обновляет значение по требованию. У каждой частотности есть дата замера, и она бывает годовой давности и старше: число приходит из кэша, а обновить его по запросу подключение не может. При повторном запросе значение иногда приходит свежее, но рассчитывать на это нельзя. Число со старой датой перепроверьте в Вордстате, прежде чем считать по нему бюджет. Попросите агента показывать дату рядом с частотностью и отмечать старые значения.
• Не подбирает фразы. Подключение отвечает «сколько показов у этой фразы», но не «какие ещё фразы бывают». Похожие запросы, подсказки и ассоциации, которые видны в интерфейсе Вордстата, через подключение не приходят. Расширять семантику агент будет другим способом — своими знаниями, из вашего списка или по методике скилла, папки с инструкциями для агента; подключение проверит то, что собрано.
• Не показывает спрос по регионам списком, динамику и сезонность. Только число показов в месяц по заданному региону.
• Не выполняет вызовы без паузы. Между вызовами одного пользователя подключение выдерживает паузу: несколько команд подряд выполняются по очереди, чуть медленнее. Если агент запускает несколько вызовов разом, часть получит отказ с просьбой повторить через несколько секунд — попросите агента повторить.
• Ничего не меняет. Подключение только читает, поэтому точка подтверждения перед вызовом здесь не нужна. Проверять стоит результат: дату замера и регион, по которому считалось.

Работа без скилла

Подключение отдаёт частотности, но не решает, какие фразы проверять и что делать с результатом. Готовый маршрут даёт скилл «Директолог»: по его инструкциям агент собирает кампанию — проверяет через это подключение частотность базовых фраз (масок), отсеивает фразы ниже порога и пакетно проверяет собранную семантику. Без скилла подключение тоже полезно: проверить готовый список фраз, сравнить спрос по нескольким регионам отдельным вызовом на каждый, отсеять пустые запросы перед загрузкой в кампанию.

Если не получилось

Агент не видит инструменты Вордстата. Чаще всего дело в адресе: при подстановке токена теряется символ или остаются угловые скобки. Сверьте адрес целиком, исправьте и перезапустите агентную среду — без перезапуска правка не подхватится.

Среда сообщает об ошибке авторизации или подключение не проходит проверку. Токен пересоздан после сборки адреса или скопирован не полностью. Откройте профиль click.ru, сверьте токен с действующим и пересоберите адрес. Если токен пришлось пересоздать, остальные подключения на нём тоже соберите заново.

Подключение перестало отвечать без изменений с вашей стороны. Подключение не смогло проверить токен: недоступен сервис click.ru. Ничего не сломано — подождите несколько минут и повторите.

Пришла ошибка сервера. Такое случается время от времени и от размера списка не зависит. Попросите агента повторить один раз, не чаще; если отказ повторился — разбить список пополам.

Вызов оборвался по времени. Так бывает на длинных списках, когда среда не дожидается ответа. Попросите агента разбить список на части или поставить его в очередь и забрать результат позже в той же сессии.

Агент отвечает, что запросов слишком много. Сработал общий лимит на стороне сервера. Подождите минуту и повторите.

У части фраз нет числа. Значение ещё считается на стороне Вордстата. Попросите агента повторить запрос только по этим фразам.

Частотность 0. Это ответ, не сбой: по фразе в этом регионе показов не было. Проверьте регион и словоформу — в точном режиме «купить диваны» не засчитывается за «купить диван».

Число не сходится с Вордстатом. Посмотрите дату замера: старое значение из кэша расходится с сегодняшним. Верным считайте то, что показывает Вордстат.

Ничего из этого не помогло. Опишите ситуацию в Telegram-сообществе. Приложите текст ошибки и адрес подключения без токена: адрес целиком равносилен паролю.

Частые вопросы

Нужно ли уметь программировать?

Нет. Подключение — это адрес в настройках агентной среды, дальше работа идёт обычными словами: «проверь частотность этих фраз по Москве». Какой инструмент вызвать и как разбить список, агент решает сам.

Придётся ли давать агенту пароль от Яндекса?

Нет. Доступ идёт по API-токену click.ru, к самому Вордстату агент не обращается. Закрыть агенту доступ можно без смены паролей: токен пересоздаётся в профиле click.ru.