MCP-сервер для Яндекс Вебмастера: восемь инструментов для LLM-агента и интерактивный вход через OAuth
Яндекс
Разобран MCP-сервер, который даёт LLM-агенту доступ к API Яндекс Вебмастера. 20+ эндпоинтов сведены к восьми инструментам, сгруппированным по смыслу. Реализован интерактивный вход через OAuth с PKCE и loopback-редиректом без копирования кода вручную.
Статья на Habr описывает создание MCP-сервера для API Яндекс Вебмастера v4 на TypeScript. Сервер сводит множество эндпоинтов к восьми инструментам, названным по принципу «один вопрос — один инструмент»: get_hosts, search_queries, get_indexing, get_diagnostics, list_sitemaps, get_external_links, recrawl_status, recrawl_submit. Для авторизации реализован поток OAuth с PKCE и loopback URI, позволяющий агенту самостоятельно войти в Яндекси без терминала и клиентского секрета, корректно обрабатывая ошибки (EADDRINUSE и др.). Подробно разобраны грабли API: необходимость сначала получить user_id, формат массивов через повторяющиеся ключи, различие статусов 403 и 401, разные форматы ошибок у Яндекс Вебмастера и Метрики, троттлинг по статусам 420 и 429. Код сервера открыт под лицензией MIT.
- Сокращения
- API = Application Programming Interface — интерфейс программирования приложений
- CI = Continuous Integration — непрерывная интеграция
- DNS = Domain Name System — система доменных имён
- HTTP = Hypertext Transfer Protocol — протокол передачи гипертекста
- ID = Identifier — идентификатор
- JSON = JavaScript Object Notation — JavaScript-нотация объектов
- MCP = Model Context Protocol — протокол контекста модели
- MIT = Massachusetts Institute of Technology (license) — лицензия MIT
- OAuth = Open Authorization — открытая авторизация
- PKCE = Proof Key for Code Exchange — доказательство ключа для обмена кодом
- RFC = Request for Comments — запрос комментариев
- SSH = Secure Shell — безопасная оболочка
- SHA-256 = Secure Hash Algorithm 256-bit — алгоритм безопасного хеширования 256 бит
- URI = Uniform Resource Identifier — унифицированный идентификатор ресурса
- URL = Uniform Resource Locator — унифицированный указатель ресурса
Source: Habr — хаб ИИ —
original