Скилл Яндекс Вебмастер в Aizor: как получить токен и смотреть SEO-данные сайта
Содержание
Коротко. Скилл Яндекс Вебмастер даёт ИИ-агенту Aizor SEO-данные вашего сайта: индексацию, поисковые запросы, ошибки и переходы страниц. Для подключения нужен OAuth-токен: вы создаёте приложение в Яндекс OAuth и получаете токен по ссылке. Токен действует 6 месяцев. Плата за использование API в документации не упоминается. Сайт должен быть добавлен в Вебмастер.
Что даёт скилл Яндекс Вебмастер в Aizor
Официальное описание скилла от команды Aizor: SEO-данные сайта из Яндекс Вебмастера: индексация, поисковые запросы, ошибки и переходы страниц. Агент получает эти данные по API и пересказывает их обычным языком.
Скилл подойдёт владельцу сайта, SEO-специалисту и маркетологу, который ведёт несколько сайтов. Вместо ручного захода в кабинет вы спрашиваете агента: сколько страниц в поиске, какие запросы приводят людей, есть ли ошибки. Если вам нужны данные о посетителях, посмотрите также скилл Яндекс Метрики.
Что понадобится
- Аккаунт на Яндексе, под которым сайт добавлен в Яндекс Вебмастер с подтверждёнными правами. Для неподтверждённого сайта API отвечает ошибкой
HOST_NOT_VERIFIED. - Приложение в Яндекс OAuth: его создают на странице создания приложения.
- Установленный Aizor (macOS или Windows) и скилл из каталога.
Использование API подразумевает принятие условий использования сервиса «API Яндекс Вебмастер». Там же описано, что пользователь должен согласиться с пользовательским соглашением службы Вебмастер.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Как получить ключ API: по шагам
- Откройте страницу создания приложения в Яндекс OAuth под нужным аккаунтом.
- Заполните поля: название (любое), платформа «веб-сервисы», redirect URI
https://oauth.yandex.ru/verification_code. В «Доступе к данным» укажитеwebmaster:hostinfoиwebmaster:verify. - Нажмите «Создать приложение» и скопируйте ClientID.
- Подставьте ClientID в ссылку
https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENTIDи откройте её. - На открывшейся странице скопируйте авторизационный токен.
Токен действует 6 месяцев. Новый токен получают той же ссылкой из шага 4. Авторизация идёт по протоколу OAuth 2.0.
Запросы к API идут на адрес https://api.webmaster.yandex.net/ с заголовком Authorization: OAuth ваш_токен. Кроме токена нужны два идентификатора. user_id возвращает запрос GET /v4/user. host_id, идентификатор сайта вида http:ya.ru:80, возвращает запрос списка сайтов GET /v4/user/{user-id}/hosts. Агент может найти их сам, если вы попросите показать ваши сайты.
В Aizor установите скилл Яндекс Вебмастер из каталога и вставьте токен в его настройки. Весь список скиллов есть в рубрике о скиллах Aizor.
Проверка: первые запросы агенту
- «Покажи список моих сайтов в Яндекс Вебмастере» (только чтение).
- «Сколько страниц сайта сейчас в поиске и сколько исключено?» (только чтение).
- «Покажи популярные поисковые запросы сайта за последнюю неделю» (только чтение).
- «Есть ли у сайта ошибки в диагностике?» (только чтение).
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Сценарии автоматизации
Еженедельный SEO-отчёт
Агент по расписанию собирает данные об индексации и поисковых запросах и присылает краткий отчёт. Можно сравнивать с прошлой неделей, если вы просите сохранять итоги в таблице, например в Google Таблицах.
Контроль ошибок сайта
Раз в день агент проверяет диагностику сайта и сообщает, если появились новые ошибки. API также отдаёт сведения о неработающих внутренних ссылках.
Разбор поисковых запросов
По запросу агент берёт популярные запросы сайта и показывает, по каким из них много показов и мало кликов. Выводы делаете вы, агент даёт материал.
Проверка индексации новых страниц
Вы публикуете статью и просите проверить, появилась ли она в поиске. В API есть методы для файлов Sitemap и отправки страниц на переобход, но такие действия оставьте под подтверждением.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
| HTTP 401 Unauthorized | Запрос к данным пользователя без токена | Проверьте, что токен вставлен в настройки скилла |
Ошибка 403 INVALID_OAUTH_TOKEN | Токен отсутствует или недействителен, например истёк через 6 месяцев | Получите новый токен по ссылке авторизации |
Ошибка HOST_NOT_VERIFIED | Не подтверждены права на сайт | Подтвердите сайт в интерфейсе Вебмастера |
Ошибка HOST_NOT_INDEXED | Сайт ещё не проиндексирован | Подождите индексации и повторите запрос |
Ошибка LIMITS_EXCEEDED | Превышены лимиты расширенного доступа | Дождитесь нового периода или уточните условия в документации |
Ошибка ACCESS_FORBIDDEN с кодом 403 тоже есть в справочнике ошибок API. Если запрос не проходит, попросите агента показать полный текст ответа сервера: в нём указаны название и описание ошибки.
Безопасность
- Токен открывает доступ к данным ваших сайтов в Вебмастере. Не публикуйте его и не пересылайте в чатах.
- Указывайте при создании приложения только те права, которые называет документация, и не добавляйте лишних.
- Добавление и удаление сайтов, отправку страниц на переобход и работу с Sitemap оставьте под ручным подтверждением в Aizor.
- Токен живёт 6 месяцев. Если он мог утечь, получите новый и замените его в настройках скилла.
- Используйте отдельное приложение OAuth под агента, чтобы не смешивать его с другими интеграциями.
Инструкция написана по официальной документации API Яндекс Вебмастера (yandex.ru/dev/webmaster, версия API 4.1), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.
Читайте также
