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

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

Плагин к приложению 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, любой другой или собственный скрипт

Как получить токен Яндекса

1. Завести приложение на oauth.yandex.ru.
2. В разделе «Яндекс.Вебмастер API» отметить оба права: webmaster:verify и webmaster:hostinfo. Они не взаимозаменяемы: без второго не работают инструменты по ссылкам.
3. Получить токен по ссылке вида oauth.yandex.ru/authorize?response_type=token&client_id=… и вставить его в настройки плагина.

После сохранения токена в настройках появится список ваших сайтов — выберите тот, с которым агент работает по умолчанию.

Мы в социальных сетях

Узнавайте первыми о наших новых решениях и акциях.

• Вконтакте — https://vk.com/easyweb_su
• Телеграм — https://t.me/easyweb_su