К содержимому
Интеграции

Подключение Yandex Cloud

Обновлено

Подготовка доступа

Для подключения, описанного в продукте, нужны:

  1. Аккаунт в Yandex Cloud с подключённой оплатой и положительным балансом.
  2. Каталог в облаке.
  3. Сервисный аккаунт с ролью search-api.webSearch.user.
  4. Api-Key этого сервисного аккаунта.

Если сервисный аккаунт создан автоматически при получении ключа через AI Studio, проверьте назначенную ему роль. Если создаёте его вручную, назначьте роль самостоятельно.

Вставьте ключ в MCP → Плагины → Яндекс.Вордстат для MCP → «Api-Key сервисного аккаунта» и сохраните настройки. folderId плагин не запрашивает и не передаёт.

Какие данные передаются

Плагин отправляет HTTPS POST-запросы в https://searchapi.api.cloud.yandex.net/v2/wordstat. Авторизация выполняется заголовком Authorization: Api-Key ….

Сценарий Передаваемые данные
Частотность и сравнение Поисковая фраза, число запрашиваемых похожих фраз, выбранные номера регионов и тип устройств
Динамика и сезонность Поисковая фраза, шаг и даты периода, выбранные номера регионов и тип устройств
География Поисковая фраза, разрез регионов и тип устройств
Справочник регионов Запрос дерева регионов; поиск по названию выполняется плагином по полученному справочнику

Инструменты не запрашивают из магазина заказы, покупателей или товары для отправки Яндексу. Ответы с поисковыми данными возвращаются подключённому MCP-клиенту.

Обращения и расходы

Обращения к API оплачиваются отдельно в Yandex Cloud на аккаунте владельца ключа. Плагин не показывает денежный баланс, остаток квоты или стоимость в рублях; проверяйте их в консоли Yandex Cloud. Фиксированную стоимость обращения документация не устанавливает.

  • Сравнение выполняет отдельный запрос для каждой фразы. Начните с одной опорной фразы, затем сравнивайте короткий список кандидатов.
  • Поле requests_spent в сравнении показывает число начатых обработок фраз через API-клиент. Это не денежный отчёт: автоматические сетевые повторы отдельно в нём не считаются.
  • Справочник кешируется на 86400 секунд. При действующем непустом кеше повторный поиск не обращается к Яндексу. После истечения или очистки кеша потребуется новая загрузка.
  • География может дополнительно загрузить справочник, чтобы подставить названия регионов, если его ещё нет в кеше.

При сетевом сбое или HTTP-ошибке 5xx клиент делает до двух повторов. Тайм-аут одной попытки — 30 секунд. Эти параметры заданы в коде и не являются настройками формы.

Отказ в доступе

При access_forbidden проверьте подключённую оплату, баланс облака и роль сервисного аккаунта. Плагин одинаково обрабатывает HTTP 401 и 403, поэтому один код ошибки не определяет причину. Прочитайте также текст error_message.

Если ответ содержит request_id, сохраните его для обращения в поддержку Yandex Cloud. Сам Api-Key в обращение не включайте.