MCP-server voor Yandex Webmaster: acht tools voor LLM-agent en interactieve OAuth-login
Яндекс
Een MCP-server wordt uiteengezet die een LLM-agent toegang geeft tot de API van Yandex Webmaster. Meer dan twintig endpoints zijn teruggebracht tot acht tools, gegroepeerd op betekenis. Een interactieve OAuth-login met PKCE en loopback-redirect is geïmplementeerd, zonder handmatig kopiëren van code.
Een artikel op Habr beschrijft het maken van een MCP-server voor de API van Yandex Webmaster v4 in TypeScript. De server reduceert talloze endpoints tot acht tools, vernoemd volgens het principe 'één vraag, één tool': get_hosts, search_queries, get_indexing, get_diagnostics, list_sitemaps, get_external_links, recrawl_status en recrawl_submit. Voor authenticatie is een OAuth-stroom met PKCE en een loopback-URI geïmplementeerd, waarmee de agent zelfstandig kan inloggen bij Yandex zonder terminal of clientgeheim, en die fouten (onder andere EADDRINUSE) correct afhandelt. De valkuilen van de API worden gedetailleerd besproken: de noodzaak om eerst een user_id te verkrijgen, het formaat van arrays via herhaalde sleutels, het verschil tussen status 403 en 401, verschillende foutformaten bij Yandex Webmaster en Yandex Metrica, en throttling bij status 420 en 429. De broncode van de server is open-source onder de MIT-licentie.
Bron: Habr — хаб ИИ —
origineel
