Платформа
Яндекс Вебмастер
Индексирование, поисковые запросы, диагностика сайтов и рекомендации агента.
Яндекс Вебмастер
Приложение Яндекс Вебмастер даёт агенту доступ к поисковой статистике и техническому состоянию сайтов, подтверждённых в вашем аккаунте Яндекса. Агент анализирует запросы, индексирование, диагностику, важные страницы и внешние ссылки.
Назначение
Вебмастер помогает:
- проверить ИКС, число страниц в поиске и исключённых страниц;
- найти критические и рекомендательные проблемы сайта;
- разобрать показы, клики, CTR и позиции поисковых запросов;
- проверить обход и индексирование URL;
- найти появившиеся и выпавшие из поиска страницы;
- контролировать важные страницы, Sitemap и внешние ссылки;
- отправить отдельный URL на переобход после подтверждения.
Подключение
Подключать и отключать Вебмастер может владелец рабочего пространства.
- Откройте Яндекс Вебмастер → Настройки.
- Нажмите Получить код подтверждения.
- Откройте страницу Яндекса и войдите под аккаунтом, где подтверждены права на нужные сайты.
- Введите код и разрешите доступ.
- Дождитесь появления списка сайтов.
При ручном подключении создайте приложение Яндекс OAuth. Обязательное право — получение информации о сайтах. Право добавления сайтов и подтверждения прав нужно для отправки страниц на переобход. Укажите ClientID, получите токен и вставьте его в Promto; Client secret не требуется.
Интерфейс
На Главной находятся сценарии проверки здоровья сайта, запросов, индексирования, поисковых событий, важных URL и внешних ссылок.
В Настройках видны маска токена и доступные сайты. Для каждого сайта приложение показывает URL, состояние подтверждения, ИКС, число страниц в поиске и вне поиска, а также количество обнаруженных проблем. Отключение удаляет токен с сервера и закрывает агенту доступ ко всем сайтам этого подключения.
Возможности агента
Основной агент использует promto_webmaster.
| Задача | Действия |
|---|---|
| Сайты и сводка | list_hosts, host_summary |
| Поисковые запросы | search_queries, queries_history |
| Индексирование | indexing_history, indexing_samples, pages_in_search, search_events |
| Проверки сайта | important_urls, diagnostics, sitemaps, external_links |
| Переобход | recrawl |
| Дополнительные методы API | request |
Агент начинает с list_hosts. Остальные действия используют host_id, который вернул API. Это служебная строка вроде https:example.com:443, а не обычный URL.
Сценарии
Проверить поисковое здоровье
Агент получает общую сводку, группирует проблемы по важности и объясняет, какие исправления стоит проверить первыми.
Найти точки роста запросов
Попросите собрать запросы за последнюю неделю и выделить фразы с большим числом показов, но низким CTR или слабой средней позицией.
Проверить выпадение страниц
Укажите период. Агент сравнит поисковые события, приведёт конкретные URL и отделит фактические события Яндекса от предположений о причинах.
Ограничения и безопасность
- Агент видит только сайты, доступные подключённому аккаунту. Сайт без подтверждённых прав может не отдавать полные данные.
search_queriesработает с корпусом до 3000 популярных запросов за прошедшую неделю; одна страница ответа содержит не более 500 строк.- История индексирования и поисковые события без дат могут вернуть только текущий день. Для отчёта всегда задавайте период.
- Выборки URL обычно ограничены 100 примерами за запрос и требуют постраничного чтения.
recrawlрасходует дневную квоту конкретного сайта. Агент должен назвать URL и получить подтверждение до отправки.- Доступ ограничен хостом API Вебмастера; токен не передаётся агенту и не должен появляться в сообщениях или файлах.
Если что-то не работает
Сайт не появился. Проверьте, что права на него подтверждены именно у подключённого аккаунта, затем обновите окно.
История пустая. Повторите запрос с явными date_from и date_to и правильным host_id.
Не удаётся отправить URL на переобход. Проверьте право записи и остаток дневной квоты. Не повторяйте запрос, пока не прочитан результат предыдущего.
OAuth-приложение ожидает решения Яндекса. Доступ к отдельным возможностям Вебмастера может начать работать после одобрения приложения.
Токен отозван или истёк. Отключите Вебмастер и пройдите подключение заново.