Яндекс.Вебмастер в руках ИИ-агента: запросы, индексация, переобход
Плагин к приложению MCP открывает данные Яндекс.Вебмастера для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются к сайту и разбирают SEO сами: какие запросы просели, сколько страниц выпало из индекса, что Вебмастер считает проблемой, — и заводят новые сайты в Вебмастер сами. Двадцать девять инструментов, из них пишущих четыре, и каждый выдаётся отдельным правом.
Поисковые запросы
Топ запросов с показами, кликами и позициями за период, динамика по всем запросам сразу и история отдельного запроса. «Что просело за месяц» — один вопрос вместо получаса в интерфейсе.
Индексация
Сколько страниц в поиске и в обходе сейчас, как менялось за период, выборка страниц с кодами ответа. Какие страницы вошли в поиск и какие из него выпали — с причиной. Плюс карты сайта и товарные YML-фиды с результатом обработки.
Переобход страниц
Отправка страницы в очередь переобхода, состояние заявок и остаток суточной квоты. Агент видит, сколько заявок осталось, и не тратит их на страницы, которые и так в индексе.
Ссылки, ИКС, диагностика
Внешние ссылки на сайт, битые внутренние ссылки, история индекса качества и полный список проблем, которые Вебмастер нашёл на сайте, — с уровнем важности каждой.
Новый сайт в Вебмастере — без захода в интерфейс
Агент добавляет сайт в кабинет и сразу получает код подтверждения прав. Дальше код ставится на сайт метатегом, HTML-файлом или DNS-записью, и агент просит Яндекс проверить. Поддомены, демо-стенды, новый магазин клиента заводятся одной просьбой в чате.
Удаление сайта из кабинета требует явного идентификатора сайта и подтверждения — сайт по умолчанию туда не подставляется, и по неудачно понятой фразе агент ничего не снимет. Заявка на переобход тоже требует подтверждения: она расходует суточную квоту сайта. Без подтверждения агент получает отказ с объяснением, что произойдёт, и вызов в Яндекс не уходит.
Добавление сайта и запуск проверки прав подтверждения не просят: квоты они не тратят, а добавленный по ошибке сайт так же легко убрать.
Вы решаете, что агенту можно
У каждого инструмента своё право, права собраны в три группы. Выдавая токен в приложении 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















