Yandex Webmaster MCP

Яндекс Вебмастер MCP

Яндекс Вебмастер MCP подключает AI-приложение — Claude, Cursor, Codex и другие — к данным Яндекс Вебмастера. Спросите на естественном языке, как сайт выглядит в поиске Яндекса: какие страницы попали или не попали в поиск, что происходит с показами и кликами, какие проблемы видит Вебмастер, как устроены sitemap и внешние ссылки. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.

• 20 инструментов. Сайты, диагностика, поисковые запросы, индексация, sitemap, внешние ссылки и подключение аккаунта прямо из диалога.
• Работает с органическим поиском. Это не Метрика, не Вордстат и не рекламный кабинет: здесь нет данных о посещаемости, поисковом спросе и рекламе.
• Подключение в чате. Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к сайтам сразу после подключения.
• Почти всё — чтение. Отдельные инструменты могут добавить сайт или sitemap, запустить подтверждение прав либо поставить страницу в очередь на переобход.
• Только ваши сайты. Сервер видит данные тех сайтов, к которым у токена есть доступ; для статистики и диагностики права на сайт должны быть подтверждены в Вебмастере.

Попробуйте первым сообщением:

Какие критичные проблемы сейчас видит диагностика на моём сайте?

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

Увидеть работу за минуту

Вы: Покажи мои сайты в Вебмастере и кратко оцени их состояние.

Ассистент: Показывает сайты, доступные по токену, их ИКС, число страниц в поиске и исключённых страниц, а также количество проблем по степени серьёзности.

Вы: Какие критичные проблемы есть у основного сайта и что проверить в первую очередь?

Ассистент: Разбирает текущую диагностику Вебмастера, отделяет критичные проблемы от рекомендаций и объясняет, какие из них требуют действий на сайте.

Вы: По каким запросам сайт чаще всего показывался за последнюю неделю?

Ассистент: Показывает запросы с показами, кликами и средними позициями. При необходимости сравнивает динамику для компьютеров и мобильных устройств.

Содержание

• Быстрый старт
• Что можно поручить
• Как это работает
• Что может изменить данные
• Подключение и настройка
• Данные и телеметрия
• Ограничения
• Техническая документация
• Поддержка

クイックスタート

Node.js 20+ が必要です。初回起動時に npx がサーバーをダウンロードするため、パッケージを別途インストールする必要はありません。 トークンを事前に取得する必要はありません。接続は対話中にそのまま行われます。

1. サーバーを AI アプリに追加します。以下から手順を選んでください。
2. **「Yandex Webmaster に接続して」**と入力します。アシスタントが Yandex へのログインを案内し、サイトが表示されることを確認します。
3. 最初の質問をします。例：「サイトの診断で、現在どのような重大な問題が検出されていますか？」

CI や自動インストールでは、あらかじめ取得したトークンを設定できます。接続と設定を参照してください。

codex mcp add yandex-webmaster \
  -- npx -y mcp-yandex-webmaster@latest

claude mcp add --transport stdio --scope user \
  yandex-webmaster -- npx -y mcp-yandex-webmaster@latest

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-webmaster@latest"]
    }
  }
}

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-webmaster@latest"]
    }
  }
}

{
  "servers": {
    "yandex-webmaster": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-webmaster@latest"]
    }
  }
}

依頼できること

検索におけるサイトの状態を把握する

• 「Webmaster に登録している自分のサイトと、それぞれの TIC を表示して」。
• 「メインサイトのページのうち、検索結果に表示されているページと除外されているページはいくつですか？」
• 「サイトに重大な問題や致命的な問題はありますか？」
• 「インデックス登録のステータスが変わった重要なページはどれですか？」

検索クエリについて調べる

• 「過去 1 週間で、サイトが最も多く表示された検索クエリは何ですか？」
• 「過去 1 か月で、サイトの表示回数、クリック数、平均掲載順位はどのように変化しましたか？」
• 「モバイル端末とパソコンでのサイトの表示状況を比較して」।

クロール、sitemap、外部リンクを確認する

• 「サイトのクロール中に Yandex のロボットが検出した HTTP エラーを表示して」。
• 「sitemap にエラーはありますか？ロボットが最後に読み取ったのはいつですか？」
• 「サイトへの外部リンクの例を表示して」。

サイトでの操作を準備する

• 「sitemap https://example.com/sitemap.xml が追加されているか確認して、追加すると何が変わるか説明して」。
• 「今日、サイトの再クロール枠はいくつ残っていますか？ページをキューに追加できますか？」
• 「DNS を使って新しいサイトの所有権を確認するにはどうすればよいですか？」

仕組み

まず、サイト一覧を取得します。各サイトには技術識別子 host_id が割り当てられています。サーバーはリクエストから識別子を取得するか、設定されている場合は環境変数 YANDEX_WEBMASTER_HOST_ID から取得します。

サイトの所有権を確認すると、サーバーは 1 つの対話で次の情報をまとめて取得できます。

• 検索での状態 — TIC、検索結果に表示されているページ数と除外されているページ数、現在の問題；
• 検索クエリでの表示状況 — 日付や端末の種類ごとの表示回数、クリック数、平均掲載順位；
• クロールとインデックス登録 — クロール時の HTTP コード、重要なページのステータス、sitemap、再クロールキュー；
• リンクプロファイル — サイトにリンクしているページの例。

サイトの所有権が確認されていない場合、Webmaster は HOST_NOT_VERIFIED を返します。サイトがまだ読み込まれていない、またはインデックスに登録されていない場合、HOST_NOT_LOADED と HOST_NOT_INDEXED は、データがまだないことを意味し、数値がゼロであることを示すものではありません。

データを変更する操作

サーバーへの質問の大半は、データを読み取るだけです。次の操作は、Yandex Webmaster の状態を変更します。

状態を変更するツールは AI アプリケーションに対してアクションとして示され、削除の可能性がある raw_request は、取り消せない可能性のある操作として示されます。アプリケーションが確認を求めることがありますが、その動作はクライアントによって異なります。削除には明示的な依頼が必要です。

接続と設定

サーバーは、お使いの Yandex アカウントを通じて Yandex Webmaster API v4 にアクセスし、Webmaster のウェブインターフェースでそのアカウントから利用できるサイトを参照します。

通常の利用では、トークンを事前に用意する必要はありません。

1. チャットで Yandex Webmaster への接続を依頼します。
2. Webmaster で必要なサイトを参照できるアカウントで、Yandex OAuth のリンクを開きます。
3. アクセスを許可し、表示されたコードをアシスタントに送信します。コードは使い捨てで、有効期限は 10 分です。稼働中のサーバー内でのみトークンに交換されるため、アプリケーションの再起動や設定の編集は不要です。

サーバーは PKCE を使用します。チャットに表示されたコードだけではトークンに交換できないため、チャットでコードを送信しても安全です。取得したトークンは、所有者のみがアクセスできる権限（0600）で ~/.config/mcp-yandex-webmaster/credentials.json にローカル保存されます。その後は接続が自動的に維持され、アクセス権は自動で延長されるため、1 年後に切れることもありません。状態を確認するには「接続ステータスを表示して」と依頼してください。切断するには「Webmaster を切断して」と依頼します。付与したアクセス権は Yandex ID で取り消せます。

CI や標準以外のインストールでは、環境変数による設定も利用できます。

YANDEX_OAUTH_TOKEN に設定するトークンは、次の手順で取得できます。oauth.yandex.ru でアプリケーションを作成し、アクセス権で Yandex Webmaster API を選択して、Yandex OAuth の手順に従ってトークンを取得します。同じアプリケーションをダイアログからのログインにも使用できます。その場合は、ClientID を YANDEX_WEBMASTER_OAUTH_CLIENT_ID に設定します（Redirect URI は https://oauth.yandex.ru/verification_code）。

トークンをチャット、リポジトリ、スクリーンショットで公開しないでください。アカウント内のサイトへのアクセス権が付与されます。

Данные и телеметрия

По умолчанию сервер отправляет анонимные технические события: случайный идентификатор установки, название вызванного инструмента, версии сервера, AI-приложения, Node.js и операционной системы. Токен Яндекса, данные аккаунта, аргументы инструментов, тексты запросов, значения и названия переменных окружения не отправляются.

Чтобы отключить телеметрию для MCP-серверов Ask Ads, задайте переменную окружения:

ASKADS_TELEMETRY=0

Ограничения

• Подтверждённые права обязательны для статистики. Без них доступны список сайтов и проверка статуса прав, но не диагностика, запросы и индексация.
• Переобход ограничен суточной квотой сайта. В ответе есть quota_remainder — остаток на сегодня. При 429 QUOTA_EXCEEDED ожидание не поможет: квота восстановится завтра.
• Популярные запросы ограничены данными Вебмастера. В топ попадает до 3 000 запросов за последнюю неделю, а за один запрос можно получить до 500 строк.
• Повторы запросов предусмотрены только для временных ошибок. Сервер делает до трёх повторов для обычных ограничений частоты; ошибки сети и сервера повторяются только при чтении, чтобы не продублировать действие.
• Нет постоянного наблюдения. Сервер работает, когда его вызывает AI-приложение. Если приложение поддерживает регулярные задания, можно настроить периодический запрос к серверу для проверки нужных показателей.

Техническая документация

• Все инструменты — параметры, ответы и примеры вызовов.
• Разработка — устройство проекта и работа с исходным кодом.
• Пакет в npm.
• Документация Yandex Webmaster API — первоисточник по API и его ограничениям.

Поддержка

Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.