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

Почему агент не видит инструменты Вордстата?

Проверьте установку плагина и права используемого токена MCP. В группе «Яндекс.Вордстат», разделе «Чтение», каждому из шести инструментов соответствует отдельное право. Право на частотность не открывает автоматически сезонность или справочник.

Почему возвращается not_configured?

В MCP → Плагины → Яндекс.Вордстат для MCP проверьте поле «Api-Key сервисного аккаунта». Оно не должно быть пустым. Кириллица, пробел внутри ключа или внутренний перенос строки тоже вызывают этот отказ. Скопируйте ключ заново из Yandex Cloud.

Ключ указан, но Яндекс отказал в доступе. Что проверить?

При access_forbidden проверьте оплату и баланс Yandex Cloud, а также роль search-api.webSearch.user у сервисного аккаунта. Плагин возвращает такой код при HTTP 401 и 403; читайте полный error_message, чтобы не делать вывод только по одному коду.

Можно ли использовать OAuth-токен или указать folderId?

Нет соответствующих настроек. Реализовано подключение через Api-Key сервисного аккаунта к Wordstat API в Yandex Search API. folderId в запросы не добавляется.

Почему нельзя запросить частотность в кавычках или с минус-словами?

Такие операторы плагин намеренно отклоняет с operators_not_supported. Частотность считается только по широкому соответствию. Уберите операторы; дефис внутри обычного слова допускается.

Почему регионы по умолчанию не применились?

Они действуют только на частотность, сравнение, динамику и сезонность. Непустой region_ids в вызове заменяет настройку. «География спроса» всегда запрашивает распределение по стране и регионального фильтра не имеет.

Номера должны быть положительными числами, а не названиями. Если распознана лишь часть списка, проверьте region_ids_ignored и фактический region_ids ответа. Пустой массив в вызове возвращает выбор к настройкам; чтобы явно выбрать Россию, используйте [225].

Почему полученный период отличается от запрошенного?

Плагин выравнивает недели и месяцы до полных периодов и исключает текущий незавершённый период. Для дневного шага действует окно последних 60 дней, считая сегодняшний. Ориентируйтесь на date_from, date_to и period_adjusted. Для истории глубже дневного окна выберите weekly или monthly.

Почему сравнение вернуло не все фразы или ошибки внутри успешного ответа?

При отказе отдельной фразы остальные результаты сохраняются: строка ошибки содержит count: null. При проблемах настройки, доступа или квоты обход прекращается с stopped_after. Поэтому ok: true в сравнении не означает успех каждой строки. Список более 20 фраз отклоняется целиком; пустые строки и точные дубли предварительно удаляются.

Почему нет ассоциаций, названий регионов или расчёта сезонности?

Пустые associations допустимы. Если не удалось загрузить справочник, география может вернуть номера с пустыми названиями, сохранив статистику. В сезонности no_data означает отсутствие точек либо одни нули в ряду: проверьте написание или возьмите более общую фразу. При 12 месяцах данных не хватает для проверки повторяемости одного календарного месяца.

Можно ли сложить частотности и получить общий спрос?

Складывать похожие запросы нельзя: они пересекаются. sum_count в сравнении — сумма выбранных фраз, а не уникальный спрос. Строки географии дополнительно относятся к территориям разных уровней и тоже не суммируются. Частотность не равна трафику вашего сайта.

Что делать при quota_exceeded или service_busy?

При quota_exceeded повторите позже; если сообщение содержит время ожидания, следуйте ему. Проверьте лимиты и расход в Yandex Cloud. При service_busy сервис временно занят — повторите через несколько секунд. Быстрое повторение длинного списка фраз не устраняет причину и создаёт новые обращения.

Как передать разработчику сведения о другой ошибке?

Сохраните имя инструмента, аргументы без секретов, error_code, error_message и, если есть, request_id. При network_error администратору нужно проверить исходящий HTTPS к searchapi.api.cloud.yandex.net. При bad_request исправьте аргументы по тексту отказа. При api_error изучите полученное сообщение Яндекса или промежуточного сервера. При internal_error разработчик может проверить журнал wa-log/wordstat.log на сервере. Api-Key передавать не нужно.