Инструменты MCP

Права агента

В токене приложения MCP выберите нужные права группы «Яндекс.Вебмастер». Право каждого инструмента совпадает с его техническим именем. Плагин регистрирует три группы:

• «Чтение» — 25 инструментов получения данных, включая очередь и квоту переобхода.
• «Управление сайтами» — добавление, удаление и запуск подтверждения сайта.
• «Переобход» — только отправка страницы на переобход.

Для анализа данных достаточно нужных прав из «Чтение». Удаление сайта и переобход дополнительно требуют аргумент confirm: true. Добавление сайта и запуск подтверждения прав этого аргумента не требуют.

В токене отдельно показаны чтение, управление сайтами и отправка страниц на переобход.

Справочник инструментов

Подписи в таблицах соответствуют названиям прав в бэкенде.

Чтение

Управление сайтами

Переобход

Общие аргументы

webmaster_get_user_id и webmaster_get_hosts вызываются без аргументов. Инструменты для конкретного сайта используют host_id или «Сайт по умолчанию». Удаление требует явного host_id.

Период и показатели

date_from и date_to доступны в популярных запросах и инструментах истории: запросов, отдельного запроса, индексации, страниц в поиске, изменений в поиске и ИКС. Формат дат — YYYY-MM-DD.

Без date_to берётся текущая дата сервера. Без date_from начало вычисляется на 28 дней раньше даты окончания; для webmaster_get_sqi_history — на 180 дней раньше. Эти значения не настраиваются в форме плагина.

Для запросов используются показатели:

В webmaster_get_popular_queries аргумент order_by задаёт сортировку, по умолчанию TOTAL_SHOWS. Аргумент query_indicator принимает один показатель; если его нет, плагин не передаёт его Яндексу.

В webmaster_get_query_history и webmaster_get_single_query_history аргумент query_indicator принимает один показатель или массив. Если он отсутствует или пуст, используется TOTAL_SHOWS.

Для истории одного запроса обязателен query_id. Его получают из webmaster_get_popular_queries: инструмент истории не ищет запрос по тексту.

Постраничные выборки

У этих инструментов offset по умолчанию равен 0. Плагин ограничивает limit диапазоном от 1 до указанного максимума, отрицательный offset заменяет на 0. Это размер одной выборки, а не обещание получить весь набор данных за один вызов.

Дополнительные обязательные аргументы

Примеры просьб агенту

Покажи сводку по индексации сайта по умолчанию и проблемы из диагностики Яндекс.Вебмастера.

Покажи популярные запросы за сентябрь 2026 года с сортировкой по кликам.
Для выбранного запроса получи историю показов и кликов по query_id.

Покажи страницы, которые выпали из поиска, и причины исключения.
Не смешивай эту выборку со страницами из обхода робота.

Проверь остаток квоты переобхода для https:example.com:443.
Отправь https://example.com/catalog/ на переобход, подтверждаю расход квоты.
После отправки покажи идентификатор заявки.

Последний сценарий выполняется двумя вызовами: сначала webmaster_get_recrawl_quota, затем webmaster_request_recrawl с confirm: true. Проверку квоты плагин автоматически перед отправкой не выполняет. Состояние заявки запрашивается отдельно; отправка не означает завершённый обход.

В диалоге показаны вызовы инструментов индексации и диагностики, а также сводка о страницах в поиске.

Агент показывает запросы, показы, клики, среднюю позицию и изменения относительно прошлого периода.

Ответы и справка для агента

Успешный результат содержит ok: true. Обработанная ошибка содержит ok: false, error_code и error_message. Для части ошибок Яндекса дополнительно возвращаются исходный yandex_error_code и поля ответа сервиса.

Плагин также регистрирует справку «Вебмастер: сценарии и подводные камни» для MCP-клиента. Она объясняет выбор сайта, работу с идентификаторами запросов, подтверждением прав и переобходом.