MCP-сервер для Яндекс Вебмастера: как дать LLM-агенту доступ к данным сайта

LLM-агенты всё активнее проникают в рутинные задачи, но их главное ограничение — изоляция от внешних данных. Без специального моста нейросеть не может обратиться к Яндекс Вебмастеру, чтобы узнать, как поисковик оценивает сайт. MCP-сервер решает эту проблему, превращая API Вебмастера в набор инструментов, понятных агенту. В этой статье разберём, как устроен такой сервер, какие эндпоинты API v4 объединены в восемь инструментов, с какими сложностями пришлось столкнуться при авторизации и как реализован вход в Яндекс без участия человека.

Как MCP-сервер подключает LLM-агента к Яндекс Вебмастеру

MCP (Model Context Protocol) — это протокол, который позволяет LLM-агентам взаимодействовать с внешними сервисами через стандартизированные инструменты. В случае с Яндекс Вебмастером MCP-сервер выступает посредником: он принимает запросы от агента, обращается к API v4 Яндекса и возвращает структурированные данные. Автор проекта, опубликовавший код на GitHub, поставил перед собой задачу — дать агенту возможность самостоятельно выполнять типичные действия вебмастера: проверять, по каким запросам сайт получает показы, но не клики, какие страницы выпали из индекса, и что Яндекс считает проблемой. Для этого потребовалось упаковать несколько десятков эндпоинтов API в компактный набор из восьми инструментов. Каждый инструмент отвечает за одну задачу: получение списка запросов с показателями, сводки по индексации, информации о проблемах сайта и так далее. Агент выбирает нужный инструмент на основе естественно-языкового запроса пользователя.

Какие проблемы решает MCP-сервер для интеграции с API Яндекса

Яндекс Вебмастер — один из ключевых инструментов для SEO-специалистов и владельцев сайтов. Его API v4 существует уже несколько лет, но интеграция с LLM-агентами оставалась нишевой задачей. Проблема в том, что API требует OAuth-авторизации, а передавать клиентский секрет агенту — небезопасно. Кроме того, API v4 имеет свои «грабли»: например, некоторые эндпоинты возвращают данные в неочевидном формате или требуют специфических параметров. MCP-сервер решает обе проблемы. Во-первых, он берёт на себя всю работу с авторизацией: агент отправляет запросы на локальный сервер, который уже имеет доступ к токену. Во-вторых, сервер преобразует «сырые» ответы API в удобные для агента структуры, скрывая сложность протокола.

Как работает авторизация без терминала и клиентского секрета

Обычно для работы с API Яндекса нужно получить OAuth-токен через браузер, затем вручную передать его в код. MCP-сервер автоматизирует этот процесс: при первом запуске он открывает страницу авторизации Яндекса, пользователь даёт разрешение, и сервер сохраняет токен локально. Никаких клиентских секретов в коде не хранится — всё взаимодействие идёт через стандартный OAuth-флоу с редиректом. Агент, в свою очередь, вообще не видит токен: он просто вызывает инструменты сервера, а тот уже авторизуется сам. Это безопасно и удобно: достаточно один раз настроить сервер, и агент сможет работать с данными Вебмастера без дополнительных действий.

Технические подробности: как упаковать эндпоинты в инструменты

API Яндекс Вебмастера v4 содержит множество эндпоинтов: для получения статистики по запросам, проверки индексации, управления sitemap, просмотра ошибок и так далее. MCP-сервер группирует их в восемь инструментов, каждый из которых покрывает конкретную потребность. Например, инструмент «getqueries» получает данные по поисковым запросам: показы, клики, CTR, позицию. Агент может задать период и фильтр. Инструмент «getindexationstatus» возвращает информацию о том, сколько страниц проиндексировано, а сколько — нет. Инструмент «getproblems» показывает проблемы, которые Яндекс нашёл на сайте: от дублей до медленных страниц. Сложность в том, что некоторые эндпоинты API v4 возвращают данные в пагинированном виде, и серверу приходится собирать полную картину за несколько запросов. Кроме того, формат дат и числовых значений в API не всегда очевиден — сервер нормализует их перед передачей агенту.

Какие данные можно получить через MCP-сервер для Яндекс Вебмастера

С помощью MCP-сервера LLM-агент может получать широкий спектр данных: поисковые запросы с показателями, статус индексации, ошибки сайта, информацию о sitemap, историю изменений и многое другое. Это позволяет автоматизировать типичные SEO-задачи, такие как мониторинг позиций, выявление проблем и анализ трафика. Агент может не только получать данные, но и интерпретировать их, давая рекомендации на естественном языке.

Кого затронет и как

MCP-сервер для Яндекс Вебмастера в первую очередь полезен SEO-специалистам и разработчикам, которые хотят автоматизировать рутинные проверки. Вместо того чтобы каждый раз заходить в интерфейс Вебмастера и вручную выгружать отчёты, можно просто написать запрос агенту: «Покажи запросы, по которым упала позиция за последнюю неделю». Агент сам выполнит все шаги. Владельцы сайтов, не знакомые с программированием, тоже смогут пользоваться таким инструментом, если агент интегрирован в удобный интерфейс, например, через чат-бота или голосового ассистента. Для российского рынка это особенно актуально: Яндекс остаётся доминирующей поисковой системой, и доступ к данным Вебмастера через LLM-агента может упростить работу многим вебмастерам.

Что будет дальше

MCP-сервер — это open-source проект, и его можно дорабатывать. В планах автора — добавить больше инструментов: например, для управления sitemap или для получения детальной статистики по отдельным страницам. Также возможно появление поддержки других сервисов Яндекса, таких как Яндекс Метрика. Сам протокол MCP активно развивается, и подобные серверы могут стать стандартным способом интеграции LLM-агентов с любыми API. Если эксперимент окажется успешным, можно ожидать появления аналогичных решений для Google Search Console, Ahrefs и других SEO-платформ.

Итог

MCP-сервер для Яндекс Вебмастера — это практичный инструмент, который даёт LLM-агентам доступ к данным о сайте без необходимости вручную работать с API. Он решает проблемы авторизации и форматирования данных, позволяя агенту сосредоточиться на анализе. Проект особенно полезен для SEO-специалистов, которые хотят автоматизировать рутину, и для всех, кто интересуется интеграцией нейросетей с внешними сервисами. Если вы ищете способ дать вашему LLM-агенту доступ к Яндекс Вебмастеру, этот MCP-сервер — отличное решение.