Установка и первые шаги

Установка

1. Убедитесь, что в Webasyst установлено приложение MCP версии 1.3.0 или новее.
2. Установите плагин из карточки Яндекс.Вордстата в маркете Webasyst, выбрав нужный аккаунт Webasyst.
3. Откройте приложение MCP → Плагины и выберите «Яндекс.Вордстат для MCP».

Первичная настройка

1. Подготовьте сервисный аккаунт Yandex Cloud и его Api-Key по статье «Подключение Yandex Cloud».
2. В поле «Api-Key сервисного аккаунта» укажите полученный ключ и сохраните настройки.
3. Поле «Регионы по умолчанию» можно оставить пустым: тогда запросы без явно указанных регионов используют всю Россию. Если нужны определённые регионы, введите их номера через запятую.
4. В приложении MCP при настройке токена найдите группу «Яндекс.Вордстат», раздел «Чтение», и предоставьте нужные права. Для первой проверки достаточно права «Частотность фразы».
5. Подключите MCP-клиент к приложению MCP с этим токеном. Адрес подключения и токен берите из приложения MCP: плагин не создаёт отдельный MCP-сервер.

Проверка

Попросите агента:

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

Для явного запроса по всей России агент должен передать region_ids: [225], особенно если вы задали другие регионы по умолчанию.

Проверяйте фактический ответ инструмента wordstat_get_phrases: при успехе он содержит ok: true, total_count, phrases и period: last_30_days. Пустой список associations сам по себе не означает ошибку.

Если инструмент не виден агенту, проверьте права используемого токена. Если вернулось ok: false, смотрите error_code и error_message; распространённые причины разобраны в частых вопросах.