Яндекс Вебмастер через ИИ

Проверяйте индексацию, sitemap, поисковые запросы, технические проблемы и переобход URL из ChatGPT, Claude, Codex или другого MCP-клиента.

Endpoint
https://lidfly.ru/mcp/v3
Инструменты
50+ webmaster_*
Основная сущность
host_id сайта
OAuth
отдельный от Директа

Яндекс Вебмастер в LidFly — это отдельное подключение для SEO и технического состояния сайтов. Он показывает индексацию, sitemap, переобход URL, поисковые запросы, ссылки, ИКС, диагностику и права на сайт. Это не Яндекс Директ и не расширение рекламного OAuth.

Отдельное подключение, не Яндекс Директ

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

В Директе основная сущность — рекламный кабинет и часто client_login. В Вебмастере основная сущность — сайт, точнее host_id. Его нужно получить через webmaster_get_hosts и передавать в дальнейшие инструменты. client_login здесь не используется.

Как подключить

Откройте Яндекс Вебмастер в кабинете LidFly В личном кабинете перейдите в пункт «Яндекс Вебмастер». Это отдельный раздел, не список кабинетов Директа.
Нажмите OAuth-подключение Авторизуйтесь в Яндексе под аккаунтом, который видит нужные сайты в Яндекс Вебмастере.
Проверьте статус После подключения LidFly показывает активный статус, user_id Яндекса и список сайтов, доступных этому аккаунту.
Если сайтов нет Сначала добавьте и подтвердите сайт в Яндекс Вебмастере или сделайте это через инструменты LidFly, если у аккаунта есть нужные права.

ИИ видит только сайты, которые доступны подключённому Яндекс-аккаунту. Для клиентских проектов и агентского режима правильно привязывайте host_id к проекту в Пространствах, чтобы данные разных клиентов не смешивались.

Основные сценарии

Проверить доступ и сайты

Понять, активен ли OAuth, какой user_id подключён и какие сайты доступны.

webmaster_check_access → webmaster_get_hosts

Посмотреть карточку сайта

Получить базовые данные, сводку по ИКС, страницам в поиске, исключённым URL и проблемам.

webmaster_get_host → webmaster_get_host_summary

Найти технические проблемы

Проверить диагностику, критичность проблем и состояние сайта глазами Яндекс Вебмастера.

webmaster_get_host_diagnostics

Проверить индексацию

Посмотреть историю загрузки, примеры страниц, страницы в поиске и события появления или исключения URL.

indexing → in-search → search events

Анализировать поисковые запросы

Найти популярные запросы, историю показателей и связку запросов с URL за последние периоды.

popular queries → history → analytics

Работать с sitemap и переобходом

Проверить найденные sitemap, добавить пользовательский sitemap и отправить URL или sitemap на переобход с учётом квот.

sitemaps → quota → recrawl

Проверить ссылки

Найти внешние ссылки, их историю и внутренние битые ссылки, которые мешают обходу и SEO.

external links → internal broken links

Подтвердить права и работать с фидами

Получить способы подтверждения прав, запустить проверку, загрузить YML-фиды и проверить Pro/export, если они доступны аккаунту.

verification → feeds → Pro export

Как ИИ вызывает инструменты в MCP v3

Рекомендуемый endpoint для новых подключений — https://lidfly.ru/mcp/v3. В нём ИИ не получает огромный список инструментов сразу. Сначала он ищет нужные инструменты, затем запрашивает их схему, и только потом вызывает рабочий метод.

  1. Найти инструменты: search_tools по запросу вроде «вебмастер индексация sitemap».
  2. Получить схему: get_tool_schema для выбранного webmaster_* инструмента.
  3. Получить сайт: webmaster_get_hosts возвращает точный host_id.
  4. Вызвать действие: просмотр через call_tool, изменения через call_write_tool.

Не используйте client_login для Вебмастера. Это не рекламный кабинет Яндекс Директа. Для всех задач по сайту берите host_id из webmaster_get_hosts.

Read-only и действия с подтверждением

Аудит, просмотр, диагностика, история индексации, поисковые запросы, ссылки, sitemap и статусы идут через call_tool. Такие инструменты читают данные и не меняют состояние аккаунта.

Изменения идут только через call_write_tool. Перед write-вызовом ИИ должен явно объяснить действие: какой сайт, какой URL или sitemap, какая квота может быть потрачена и какой результат ожидается.

К write-действиям относятся добавление или удаление сайта, добавление или удаление sitemap, отправка URL на переобход, запуск подтверждения прав, запуск архива индексации, загрузка или удаление фидов, Pro-выгрузки и приоритетный переобход sitemap.

Примеры запросов

Ограничения

Ошибки и что они значат

Ошибка Что означает Что сделать
ACCESS_FORBIDDEN Нет нужного доступа к API Вебмастера. Переподключить Яндекс Вебмастер в LidFly и убедиться, что аккаунт видит сайт.
INVALID_OAUTH_TOKEN Токен не принят Яндекс Вебмастером. Переподключить OAuth-доступ Вебмастера.
HOST_NOT_FOUND host_id не найден или указан неверно. Сначала вызвать webmaster_get_hosts и взять точное значение host_id.
HOST_NOT_VERIFIED Права на сайт не подтверждены. Получить способы через webmaster_get_verification и запустить проверку после подготовки сайта.
QUOTA_EXCEEDED Исчерпана квота Яндекса, например на переобход. Проверить квоту и повторить позже.

Инструменты по группам

Полный текущий каталог webmaster_* в LidFly. Для каждого инструмента сначала открывайте схему через get_tool_schema: там указаны параметры, лимиты и то, нужно ли вызывать метод через call_tool или call_write_tool.

Доступ и сайты

webmaster_check_access
Проверить отдельный OAuth-доступ Вебмастера, вернуть статус, user_id, connection_id и количество сайтов.
чтение
webmaster_get_user
Получить user_id текущего OAuth-подключения Яндекс Вебмастера.
чтение
webmaster_get_hosts
Получить список сайтов пользователя; стартовый инструмент для выбора точного host_id.
чтение
webmaster_get_host
Получить карточку сайта по host_id.
чтение
webmaster_add_host
Добавить сайт в аккаунт Яндекс Вебмастера; после добавления нужно подтвердить права.
запись
webmaster_delete_host
Удалить сайт из Яндекс Вебмастера у пользователя.
удаление

Сводка, диагностика и права

webmaster_get_host_summary
Получить сводку сайта: ИКС, страницы в поиске, исключённые страницы и проблемы по severity.
чтение
webmaster_get_host_diagnostics
Получить диагностические проблемы сайта и их состояние.
чтение
webmaster_get_sqi_history
Получить историю ИКС сайта за период.
чтение
webmaster_get_owners
Получить список пользователей, подтвердивших права на сайт.
чтение
webmaster_get_verification
Получить verification_uin, состояние и доступные способы подтверждения прав.
чтение
webmaster_start_verification
Запустить проверку подтверждения прав способом DNS, HTML_FILE или META_TAG.
запись

Важные страницы

webmaster_get_important_urls
Получить мониторинг важных страниц сайта.
чтение
webmaster_get_important_url_history
Получить историю изменений важной страницы по URL.
чтение

Индексация и страницы в поиске

webmaster_get_indexing_history
Получить историю индексирования сайта по HTTP-статусам.
чтение
webmaster_get_indexing_samples
Получить примеры страниц, загруженных роботом Яндекса.
чтение
webmaster_get_insearch_history
Получить историю количества страниц сайта в поиске Яндекса.
чтение
webmaster_get_insearch_samples
Получить примеры страниц сайта, участвующих в поиске Яндекса.
чтение
webmaster_get_search_events_history
Получить историю появления и исключения страниц из поиска.
чтение
webmaster_get_search_events_samples
Получить примеры страниц, появившихся или удалённых из поиска.
чтение
webmaster_start_indexing_archive
Запустить формирование архива всех страниц сайта из раздела «Индексирование».
запись
webmaster_get_indexing_archive
Получить статус архива всех страниц сайта по task_id.
чтение

Поисковые запросы

webmaster_get_popular_queries
Получить популярные поисковые запросы сайта за последнюю неделю или заданный период.
чтение
webmaster_get_queries_history
Получить агрегированную историю показателей по всем поисковым запросам сайта.
чтение
webmaster_get_query_history
Получить историю показателей по одному query_id из популярных запросов.
чтение
webmaster_query_analytics
Получить мониторинг поисковых запросов и URL через query-analytics/list с фильтрами и пагинацией.
чтение

Sitemap и переобход

webmaster_get_sitemaps
Получить sitemap, обнаруженные роботами Яндекса.
чтение
webmaster_get_sitemap
Получить карточку sitemap по sitemap_id.
чтение
webmaster_get_user_added_sitemaps
Получить sitemap, добавленные пользователем через Вебмастер или API.
чтение
webmaster_get_user_added_sitemap
Получить карточку пользовательского sitemap по sitemap_id.
чтение
webmaster_add_sitemap
Добавить пользовательский sitemap URL в Яндекс Вебмастер.
запись
webmaster_delete_sitemap
Удалить пользовательский sitemap из Яндекс Вебмастера по sitemap_id.
удаление
webmaster_get_recrawl_quota
Получить суточную квоту переобхода страниц сайта.
чтение
webmaster_get_recrawl_tasks
Получить очередь задач на переобход страниц сайта.
чтение
webmaster_get_recrawl_task
Получить статус задачи на переобход по task_id.
чтение
webmaster_request_recrawl
Отправить URL страницы на переобход с расходом суточной квоты.
запись
webmaster_get_priority_sitemap_recrawl_quota
Получить месячный лимит приоритетного переобхода sitemap.
чтение
webmaster_request_priority_sitemap_recrawl
Отправить sitemap на приоритетный переобход через API v4.1.
запись

YML-фиды

webmaster_get_feeds
Получить YML-фиды, загруженные в Вебмастер для сайта.
чтение
webmaster_start_feed_upload
Асинхронно загрузить один YML-фид, затем проверить статус по request_id.
запись
webmaster_get_feed_upload_status
Получить статус асинхронной загрузки фида по request_id.
чтение
webmaster_batch_add_feeds
Загрузить до 50 YML-фидов одним batch-запросом.
запись
webmaster_batch_delete_feeds
Удалить несколько YML-фидов из Яндекс Вебмастера.
удаление
webmaster_change_feed_regions
Изменить регионы существующего YML-фида.
запись

Pro/export поисковых запросов

webmaster_get_pro_limits
Получить доступы и лимиты Pro или расширенной выгрузки поисковых запросов для домена.
чтение
webmaster_get_pro_available_dates
Получить доступные даты для Pro-выгрузок поисковых запросов.
чтение
webmaster_get_pro_regions
Получить справочник регионов для Pro-выгрузок поисковых запросов.
чтение
webmaster_start_pro_queries_export
Создать задачу Pro или расширенной выгрузки поисковых запросов по URL.
запись
webmaster_get_pro_queries_export_status
Получить статус Pro-выгрузки поисковых запросов по task_id.
чтение

Статус старых функций

webmaster_original_texts_status
Проверить статус API «Оригинальные тексты»: метод больше не поддерживается Яндексом, используйте переобход URL или sitemap.
чтение

FAQ

Это то же самое, что Яндекс Директ?

Нет. Яндекс Вебмастер — отдельное подключение для SEO и технического состояния сайтов. У него отдельный OAuth, отдельные токены и нет client_login.

Нужно ли подключать Директ?

Нет. Вебмастер подключается отдельно и не зависит от рекламного кабинета.

Можно ли использовать с ChatGPT, Claude и Codex?

Да. Подключайте MCP-клиент к https://lidfly.ru/mcp/v3, а ИИ найдёт нужные webmaster_* инструменты через search_tools.

Можно ли менять сам сайт?

Нет. API работает с Яндекс Вебмастером: проверки, sitemap, подтверждение прав, переобход, фиды и выгрузки. Файлы, CMS и код сайта он не меняет.

Можно ли смотреть сайты клиента в агентском режиме?

Да, но нужно правильно привязывать host_id к проекту в Пространствах, чтобы ИИ работал в границах конкретного клиента.