Servidor MCP para Yandex Webmaster: oito ferramentas para agente LLM e login interativo via OAuth

Um artigo no Habr descreve a criação de um servidor MCP para a API do Yandex Webmaster v4 em TypeScript. O servidor simplifica vários endpoints em oito ferramentas, nomeadas segundo o princípio "uma pergunta, uma ferramenta": get_hosts, search_queries, get_indexing, get_diagnostics, list_sitemaps, get_external_links, recrawl_status e recrawl_submit. Para autorização, foi implementado o fluxo OAuth com PKCE e URI de loopback, permitindo que o agente faça login de forma autônoma no Yandex sem terminal e segredo do cliente, tratando corretamente erros como EADDRINUSE e outros. As dificuldades da API são detalhadas: a necessidade de obter primeiro o user_id, o formato de arrays com chaves repetidas, a diferença entre os status 403 e 401, diferentes formatos de erro entre Yandex Webmaster e Metrica, e o throttle usando os status 420 e 429. O código do servidor é aberto sob a licença MIT.