Плагин «Яндекс.Вебмастер» для MCP

Яндекс.Вебмастер для приложения «MCP»

Запросы, индексация, переобход и ИКС для агента

Яндекс.Вебмастер в руках ИИ-агента: запросы, индексация, переобход

Плагин к приложению 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