Настройки плагина
Обновлено
Где находятся настройки
Откройте MCP → Плагины → Яндекс.Вордстат для MCP. В плагине два поля; подписи приведены в точности как в конфигурации формы.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Api-Key сервисного аккаунта | Авторизует обращения к Wordstat API в Yandex Cloud | Строка ключа сервисного аккаунта с ролью search-api.webSearch.user. По умолчанию пусто; без ключа запросы не выполняются |
| Регионы по умолчанию | Задаёт регионы для частотности, сравнения фраз, динамики и сезонности, когда в вызове нет непустого списка region_ids |
Положительные номера регионов Яндекса через запятую, например 213, 2. По умолчанию пусто — вся Россия. Не более 100 разных номеров |
Форма показывает ключ сервисного аккаунта и поле регионов по умолчанию.
Api-Key
Нужен ключ сервисного аккаунта Yandex Cloud. OAuth-токен вместо него не предусмотрен. Настроек выбора сервиса, folderId или идентификатора каталога у плагина нет.
Ключ сохраняется в настройках приложения на сервере. Плагин передаёт его Яндексу в заголовке авторизации; в обычные результаты инструментов ключ не включается. Для работы агента вводить ключ в переписку не требуется.
Кириллические символы, пробел внутри ключа и внутренний перенос строки приводят к not_configured. Скопируйте ключ заново целиком из консоли Yandex Cloud.
Регионы
Примеры значений:
| Значение | Область запроса |
|---|---|
213 |
Москва |
2 |
Санкт-Петербург |
213, 2 |
Москва и Санкт-Петербург |
225 |
Вся Россия |
| Пустое поле | Вся Россия, если в вызове также нет регионов |
Название «Москва» вместо номера не подходит. Найти номер по названию можно инструментом wordstat_get_regions_tree.
Непустой список region_ids в вызове заменяет регионы из настроек. Пустой массив region_ids: [] не отключает настройку: плагин снова обращается к регионам по умолчанию. Для запроса по всей России при заполненной настройке передавайте [225].
Если в списке есть и корректные номера, и непонятные значения, запрос выполняется по корректным. Отброшенные значения возвращаются в region_ids_ignored с пояснением region_ids_note. Если не распознан ни один номер, плагин возвращает bad_request.
«География спроса» (wordstat_get_regions) не принимает region_ids и не использует «Регионы по умолчанию». Этот инструмент получает распределение по стране. «Справочник регионов» также не использует эту настройку.