Яндекс.Вебмастер в руках ИИ-агента: запросы, индексация, переобход
Плагин к приложению MCP открывает данные Яндекс.Вебмастера для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются к сайту и разбирают SEO сами: какие запросы просели, сколько страниц выпало из индекса, что Вебмастер считает проблемой. Двадцать два инструмента, и ни один не может ничего сломать в Вебмастере.
Поисковые запросы
Топ запросов с показами, кликами и позициями за период, динамика по всем запросам сразу и история отдельного запроса. «Что просело за месяц» — один вопрос вместо получаса в интерфейсе.
Индексация
Сколько страниц в поиске и в обходе сейчас, как менялось за период, выборка страниц с кодами ответа. Плюс карты сайта и товарные YML-фиды с результатом обработки.
Переобход страниц
Отправка страницы в очередь переобхода, состояние заявок и остаток суточной квоты. Агент видит, сколько заявок осталось, и не тратит их на страницы, которые и так в индексе.
Ссылки, ИКС, диагностика
Внешние ссылки на сайт, битые внутренние ссылки, история индекса качества и полный список проблем, которые Вебмастер нашёл на сайте, — с уровнем важности каждой.
Плагин не может ничего сломать в Вебмастере
В API Яндекса есть добавление, удаление и подтверждение сайтов, правка карт сайта и фидов. Ничего этого в плагине нет — намеренно.
Такие операции делают один раз при заведении сайта, и делают руками. Инструмент, к которому ассистент ходит каждый день, не должен уметь снять сайт с обслуживания по неудачно понятой фразе. Двадцать один инструмент из двадцати двух только читает.
Единственное исключение — заявка на переобход: она расходует суточную квоту сайта, поэтому требует явного подтверждения. Без него агент получает отказ с напоминанием про квоту.
Вы решаете, что агенту можно
У каждого инструмента своё право, права собраны в две группы. Выдавая токен в приложении MCP, вы отмечаете нужные — и агент физически не видит остальных инструментов.
- Чтение — двадцать один инструмент: запросы, индексация, ссылки, ИКС, диагностика
- Переобход — отдельной группой, чтобы выдавать осознанно
Ассистенту не нужно знать про user_id и host_id
В API Вебмастера каждый вызов идёт по пути с идентификатором владельца и идентификатором сайта, а даты периода обязательны. Модель, которая должна собрать эти три вещи до первого вопроса, спотыкается на них раз за разом.
Поэтому плагин берёт их на себя. Идентификатор владельца вычисляется по токену и кешируется. Сайт берётся из настроек — вы выбираете его один раз из списка, который подгружается прямо из Вебмастера. Период по умолчанию — последние 28 дней, для ИКС — полгода.
В итоге «сколько страниц в индексе» работает вызовом без единого аргумента. А если установка обслуживает несколько доменов, сайт передаётся явным параметром — это по-прежнему возможно.
Агент знает подводные камни Вебмастера
Вместе с инструментами плагин отдаёт агенту страницу документации — MCP-клиент читает её сам. В ней ровно то, обо что спотыкаются модели:
- у http- и https-версии сайта разные идентификаторы, и данные у них разные
- историю одного запроса API отдаёт только по его идентификатору, искать по тексту запроса нельзя
- данные Вебмастера отстают на день-два, поэтому «за сегодня» почти всегда пусто
- два инструмента по ссылкам требуют отдельного права токена Яндекса и без него отвечают отказом
Отказы плагин тоже переводит на человеческий: «токен отозван», «не хватает права webmaster:hostinfo», «не тот идентификатор сайта» — вместо кода ошибки, по которому агент начинает гадать.
Что нужно для работы
- приложение MCP версии 1.3.0 или новее — оно держит сервер и токены
- OAuth-токен Яндекса с правами webmaster:verify и webmaster:hostinfo
- исходящий HTTPS к api.webmaster.yandex.net — ни Node, ни cron, ни своих таблиц в базе плагин не требует
- MCP-клиент: Claude Desktop, Cursor, любой другой или собственный скрипт
Как получить токен Яндекса
- Завести приложение на oauth.yandex.ru.
- В разделе «Яндекс.Вебмастер API» отметить оба права: webmaster:verify и webmaster:hostinfo. Они не взаимозаменяемы: без второго не работают инструменты по ссылкам.
- Получить токен по ссылке вида oauth.yandex.ru/authorize?response_type=token&client_id=… и вставить его в настройки плагина.
После сохранения токена в настройках появится список ваших сайтов — выберите тот, с которым агент работает по умолчанию.
Мы в социальных сетях
Узнавайте первыми о наших новых решениях и акциях.
- Вконтакте — https://vk.com/easyweb_su
- Телеграм — https://t.me/easyweb_su