Частые вопросы
Обновлено
Почему появляется token_missing или token_invalid?
token_missing означает, что поле «OAuth-токен Яндекса» не заполнено. token_invalid возвращается, когда Яндекс отклонил токен: проверьте, не отозван ли он и полностью ли скопирован. Исправьте значение и сохраните настройки плагина.
Почему данные по ссылкам недоступны, хотя другие запросы работают?
webmaster_get_external_links и webmaster_get_broken_internal_links требуют права Яндекса webmaster:hostinfo. Получите токен с обоими правами — webmaster:verify и webmaster:hostinfo. При access_forbidden проверьте также подтверждение прав на нужный сайт: неподтверждённые сайты помечаются в списке настроек.
Почему агент не видит нужного инструмента?
Проверьте права используемого токена MCP в группе «Яндекс.Вебмастер». Каждый инструмент регистрируется с отдельным правом. Наличие OAuth-токена Яндекса само по себе не выдаёт эти права MCP-клиенту.
Что означает host_not_configured?
В вызове нет host_id, а «Сайт по умолчанию» не выбран. Выберите сайт в настройках либо передайте идентификатор из webmaster_get_hosts. Для удаления сайта идентификатор всегда требуется явно.
Почему сайт не виден в настройках или возвращается not_found?
Проверьте аккаунт сохранённого OAuth-токена и список webmaster_get_hosts. Список кешируется на 600 секунд; добавление и удаление через инструменты плагина сбрасывают этот кеш. У HTTP- и HTTPS-версии сайта разные host_id: при not_found проверьте, что используется идентификатор нужной версии.
Почему страницы из обхода не совпадают со страницами в поиске?
Это разные выборки. webmaster_get_indexing_samples возвращает страницы, которые обходил робот, с кодами ответа и статусом обхода. Для участвующих в поиске страниц используйте webmaster_get_in_search_samples, а для вошедших и выпавших — webmaster_get_search_events_samples.
Можно ли получить историю запроса по его тексту?
Инструмент истории принимает query_id, а не текст. Сначала получите популярные запросы через webmaster_get_popular_queries, найдите нужную строку и передайте её идентификатор в webmaster_get_single_query_history.
Почему за выбранный период нет данных?
Проверьте сайт, схему HTTP/HTTPS и границы периода. Плагин передаёт даты в Яндекс и возвращает полученный результат, не создавая недостающие данные. Без дат инструменты с периодом берут текущую дату сервера как окончание и начало на 28 дней раньше, для ИКС — на 180 дней раньше. Для проверки попробуйте явно указать завершившийся период.
Почему переобход требует подтверждения и когда будет результат?
webmaster_request_recrawl без confirm: true возвращает confirm_required, поскольку расходует суточную квоту сайта. Остаток узнаётся через webmaster_get_recrawl_quota. Отправка создаёт заявку; её состояние смотрят через webmaster_get_recrawl_tasks или webmaster_get_recrawl_task_status. Плагин не гарантирует срок обхода.
Можно ли удалить страницу из поиска или изменить sitemap?
Таких инструментов в плагине нет. Удаление сайта через webmaster_delete_host убирает его из кабинета, а переобход отправляет страницу в очередь робота. Сведения о sitemap и YML-фидах доступны только для чтения.
Что делать при rate_limited или ошибке соединения?
При rate_limited превышен лимит API Яндекса — повторите запрос позже. При проблемах соединения разработчику следует проверить исходящий HTTPS к api.webmaster.yandex.net. Временные сетевые ошибки и ответы с кодом 500 и выше плагин повторяет до двух раз после первой попытки.
При internal_error подробности неожиданной ошибки записываются в wa-log/webmaster.log. Этот же журнал используется для неожиданных ошибок загрузки списка сайтов в настройках. Код api_error означает ошибку API без отдельного кода Яндекса; ориентируйтесь на error_message.