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

Статья на 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.