К содержимому
Интеграции

Подключение Яндекса

Обновлено

Два разных токена

OAuth-токен Яндекса вводится в настройки плагина и даёт серверу доступ к аккаунту Вебмастера. Токен MCP используется клиентом агента для подключения к приложению MCP и определяет доступный набор инструментов. Один токен не заменяет другой.

Получение OAuth-токена

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

Этот способ получения токена приведён в описании продукта. Если Яндекс отклоняет токен, проверьте полноту скопированного значения и не был ли он отозван.

Какие права нужны

Право Яндекса Назначение
webmaster:verify Работа с сайтами, запросами, индексацией и переобходом; добавление, удаление и запуск подтверждения сайта.
webmaster:hostinfo Получение внешних ссылок и битых внутренних ссылок.

Права токена MCP настраиваются независимо. Даже при полном OAuth-доступе агент должен получить право на каждый нужный инструмент в группе «Яндекс.Вебмастер».

Какие данные передаются

Плагин отправляет запросы с сервера Webasyst в https://api.webmaster.yandex.net/v4. OAuth-токен передаётся в заголовке Authorization: OAuth ….

В зависимости от инструмента передаются идентификаторы владельца и сайта, период, показатели, параметры постраничной выборки, идентификатор запроса, sitemap или заявки. При добавлении сайта передаётся его адрес, при переобходе — адрес страницы, при запуске подтверждения — выбранный способ проверки. Удаление отправляет запрос для явно указанного сайта.

Ответы Яндекса возвращаются MCP-клиенту: это могут быть адреса страниц, запросы и статистика, ссылки, сведения о владельцах и диагностика. OAuth-токен не включается плагином в результаты инструментов.

Токен и выбранный сайт сохраняются в настройках приложения Webasyst. Там же плагин кеширует идентификатор владельца и список сайтов. Планировщика, webhook и отдельных CLI-команд для этой интеграции нет: запросы выполняются при обращении к инструментам или загрузке списка сайтов в настройках.