Yandex Webmaster向けMCPサーバー:LLMエージェント向け8つのツールとOAuthによるインタラクティブ認証
Яндекс
Yandex WebmasterのAPIにLLMエージェントがアクセスできるようにするMCPサーバーを解説。20以上のエンドポイントを意味でグループ化した8つのツールに集約。PKCEとループバックリダイレクトを用いたOAuthによるインタラクティブ認証を実装し、コードの手動コピーは不要。
Хабрに掲載された記事では、TypeScriptでYandex Webmaster API v4用のMCPサーバーを構築する方法が解説されています。このサーバーは多数のエンドポイントを8つのツールに集約しており、その命名は「1つの質問に1つのツール」という原則に従っています。具体的には、get_hosts、search_queries、get_indexing、get_diagnostics、list_sitemaps、get_external_links、recrawl_status、recrawl_submitです。認証にはPKCEとループバックURIを用いたOAuthフローが実装されており、エージェントが端末やクライアントシークレットを必要とせずにYandexに自動ログインでき、エラー(EADDRINUSEなど)も適切に処理されます。API特有の注意点として、まずuser_idを取得する必要があること、配列を繰り返しキーで表現する形式、ステータスコード403と401の違い、Yandex WebmasterとMetrikaでの異なるエラーフォーマット、ステータスコード420と429によるスロットリングが詳細に説明されています。サーバーコードはMITライセンスで公開されています。
出典: Habr — хаб ИИ —
原文
