プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Yandex Webmaster MCP

作者:askadsバージョン 1.2.4i★ –iパソコンで動く
レジストリ名io.github.askads/mcp-yandex-webmaster

インストール

概要

作者による説明(英語の原文)

MCP server for Yandex Webmaster API: indexing, search queries, sitemaps, diagnostics, links.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンで動く
  • トランスポート: stdio
  • カテゴリ: 検索・AIの記憶
  • 入力が必要なもの:YANDEX_OAUTH_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

  • 基本チェック:1項目中1項目に合格
  • あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
  • 自分で入力するもの: YANDEX_OAUTH_TOKEN, YANDEX_USER_ID, YANDEX_WEBMASTER_HOST_ID, YANDEX_WEBMASTER_API_BASE, YANDEX_WEBMASTER_TIMEOUT_MS, YANDEX_WEBMASTER_MAX_RETRIES

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

  • npmNode.jsのインストール(npxコマンドに必要)

どのアプリを使っていますか?

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "your-value",
        "YANDEX_USER_ID": "your-value",
        "YANDEX_WEBMASTER_HOST_ID": "your-value",
        "YANDEX_WEBMASTER_API_BASE": "your-value",
        "YANDEX_WEBMASTER_TIMEOUT_MS": "your-value",
        "YANDEX_WEBMASTER_MAX_RETRIES": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add yandex-webmaster --env YANDEX_OAUTH_TOKEN=your-value --env YANDEX_USER_ID=your-value --env YANDEX_WEBMASTER_HOST_ID=your-value --env YANDEX_WEBMASTER_API_BASE=your-value --env YANDEX_WEBMASTER_TIMEOUT_MS=your-value --env YANDEX_WEBMASTER_MAX_RETRIES=your-value -- npx -y mcp-yandex-webmaster

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "your-value",
        "YANDEX_USER_ID": "your-value",
        "YANDEX_WEBMASTER_HOST_ID": "your-value",
        "YANDEX_WEBMASTER_API_BASE": "your-value",
        "YANDEX_WEBMASTER_TIMEOUT_MS": "your-value",
        "YANDEX_WEBMASTER_MAX_RETRIES": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "yandex-webmaster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "your-value",
        "YANDEX_USER_ID": "your-value",
        "YANDEX_WEBMASTER_HOST_ID": "your-value",
        "YANDEX_WEBMASTER_API_BASE": "your-value",
        "YANDEX_WEBMASTER_TIMEOUT_MS": "your-value",
        "YANDEX_WEBMASTER_MAX_RETRIES": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

  • YANDEX_OAUTH_TOKEN 秘密 必須 env
    Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth `. Treat it as a secret.
  • YANDEX_USER_ID env
    Token owner's user id; auto-detected via GET /v4/user when unset.
  • YANDEX_WEBMASTER_HOST_ID env
    Default host_id (e.g. https:example.com:443) used when a tool call omits one.
  • YANDEX_WEBMASTER_API_BASE env
    API root override.
  • YANDEX_WEBMASTER_TIMEOUT_MS env
    Per-request timeout in milliseconds.
  • YANDEX_WEBMASTER_MAX_RETRIES env
    Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント askads で確認済みです

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの7275件のうち0%よりスターが多い
  • このカテゴリのほかの7275件のうち85%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの7275件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Yandex Webmaster MCPは安全ですか?

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:YANDEX_OAUTH_TOKEN

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(1.2.4)がレジストリに届いたのは6 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Context7, Codebase Memory, Exa

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Context7

作者:upstash

Up-to-date docs for AI agents

パソコンでもクラウドでも★ 64,224MIT昨日更新
インストール

Codebase Memory

作者:DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

パソコンで動く★ 48,148MIT21 日前更新
インストール

Exa

作者:exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

クラウドで動く★ 5,213MIT先月更新
インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

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

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

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

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

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


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

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

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

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

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

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

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

Содержание

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

Быстрый старт

Нужен Node.js 20+. npx скачает сервер при первом запуске — отдельно устанавливать пакет не нужно. Токен заранее получать не нужно: подключение проходит прямо в диалоге.

  1. Добавьте сервер в своё AI-приложение. Выберите инструкцию ниже.
  2. Напишите: «Подключи Яндекс Вебмастер» — ассистент проведёт через вход в Яндекс и проверит, что видит ваши сайты.
  3. Задайте первый вопрос, например: «Какие критичные проблемы сейчас видит диагностика на моём сайте?»

Для CI и автоматических установок можно задать готовый токен — см. Подключение и настройка.

Codex

Через интерфейс. Откройте Settings → Plugins → MCP servers , нажмите Add server и укажите:

  • имя: yandex-webmaster ;
  • команда: npx ;
  • аргументы: -y mcp-yandex-webmaster@latest .

Сохраните сервер. Он появится в списке MCP-серверов Codex.

Через командную строку. Вместо интерфейса можно выполнить:

codex mcp add yandex-webmaster \

-- npx -y mcp-yandex-webmaster@latest

Проверить, что сервер добавлен: codex mcp list.

Claude Code

claude mcp add --transport stdio --scope user \

yandex-webmaster -- npx -y mcp-yandex-webmaster@latest

Проверить подключение: claude mcp list.

Claude Desktop

Откройте Settings → Developer → Edit Config и добавьте в claude_desktop_config.json:

{

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

Если раздела Developer нет, откройте файл вручную: macOS — ~/Library/Application Support/Claude/claude_desktop_config.json, Windows — %APPDATA%\Claude\claude_desktop_config.json. Перезапустите Claude Desktop.

Cursor

Откройте ~/.cursor/mcp.json, чтобы подключить сервер во всех проектах, или .cursor/mcp.json в конкретном проекте. Добавьте:

{

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

VS Code

В палитре команд выполните MCP: Open User Configuration . В открывшемся mcp.json добавьте сервер:

{

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

После сохранения выполните MCP: List Servers и запустите сервер из списка.

Что можно поручить

Понять состояние сайта в поиске
  • «Покажи мои сайты в Вебмастере и их ИКС».
  • «Сколько страниц основного сайта находится в поиске и сколько исключено?»
  • «Какие критичные и фатальные проблемы есть на сайте?»
  • «Какие важные страницы изменили статус индексации?»
Разобраться с поисковыми запросами
  • «По каким запросам сайт чаще всего показывался за последнюю неделю?»
  • «Как менялись показы, клики и средняя позиция сайта за последний месяц?»
  • «Сравни видимость сайта на мобильных устройствах и компьютерах».
Проверить обход, sitemap и внешние ссылки
  • «Покажи, какие HTTP-ошибки робот Яндекса встречал при обходе сайта».
  • «Есть ли ошибки в sitemap и когда робот в последний раз его читал?»
  • «Покажи примеры внешних ссылок на сайт».
Подготовить действие на сайте
  • «Проверь, добавлен ли sitemap https://example.com/sitemap.xml, и объясни, что изменится при добавлении».
  • «Сколько переобходов осталось на сегодня для сайта и можно ли отправить страницу в очередь?»
  • «Как подтвердить права на новый сайт через DNS?»

Как это работает

Работа начинается со списка сайтов. У каждого есть технический идентификатор host_id — сервер подхватывает его из вашего запроса или из переменной YANDEX_WEBMASTER_HOST_ID, если она задана.

После подтверждения прав на сайт сервер может собрать в одном диалоге:

  • состояние в поиске — ИКС, число страниц в поиске и исключённых страниц, текущие проблемы;
  • видимость по запросам — показы, клики и средние позиции по датам и типам устройств;
  • обход и индексацию — HTTP-коды при обходе, статус важных страниц, sitemap и очередь на переобход;
  • ссылочный профиль — примеры страниц, которые ссылаются на ваш сайт.

Если прав на сайт нет, Вебмастер вернёт HOST_NOT_VERIFIED. Если сайт ещё не загружен или не проиндексирован, HOST_NOT_LOADED и HOST_NOT_INDEXED означают, что данных пока нет, а не нулевые показатели.

Что может изменить данные

Большинство вопросов к серверу только читают данные. Следующие операции меняют состояние в Яндекс Вебмастере:

ДействиеЧто происходитНа что обратить внимание
Добавить сайтСайт появляется в списке сайтов аккаунта.Права на него нужно подтвердить отдельно.
Запустить подтверждение правВебмастер начинает проверять DNS-запись, HTML-файл или мета-тег.Перед запуском нужно разместить код, который выдал Вебмастер.
Добавить sitemapSitemap передаётся Вебмастеру.Повторное добавление вернёт сообщение, что файл уже есть.
Отправить страницу на переобходURL попадает в очередь на обход роботом.Тратится суточная квота сайта; ответ покажет её остаток.
Выполнить прямой запрос APIraw_request открывает пути API, для которых нет отдельного инструмента.POST тоже может менять данные, а DELETE — безвозвратно удалить сайт или sitemap.

Инструменты, которые меняют состояние, помечены для AI-приложения как действия, а raw_request с возможным удалением — как потенциально необратимое. Приложение может запросить подтверждение, но его поведение зависит от конкретного клиента. Для удаления нужна явная просьба.

Подключение и настройка

Сервер обращается к Yandex Webmaster API v4 от имени вашего аккаунта Яндекса и видит те же сайты, которые доступны этому аккаунту в веб-интерфейсе Вебмастера.

Для обычного использования токен заранее не нужен:

  1. В чате попросите подключить Яндекс Вебмастер.
  2. Откройте ссылку на Яндекс OAuth под аккаунтом, которому в Вебмастере видны нужные сайты.
  3. Подтвердите доступ и пришлите показанный код ассистенту. Код одноразовый, действует 10 минут и меняется на токен только внутри работающего сервера — перезапускать приложение и править конфигурацию не нужно.

Сервер использует PKCE: код из чата сам по себе нельзя обменять на токен, поэтому пересылать его в чате безопасно. Полученный токен хранится локально в ~/.config/mcp-yandex-webmaster/credentials.json с правами только для владельца (0600). Дальше подключение живёт само: доступ продлевается автоматически и не отваливается через год. Проверить состояние — попросите «покажи статус подключения», отключить — «отключи Вебмастер»; выданный доступ отзывается в Яндекс ID.

Для CI и нестандартных установок доступна настройка через переменные окружения:

ПеременнаяНазначение
YANDEX_OAUTH_TOKENГотовый OAuth-токен с доступом к Вебмастеру; имеет приоритет над входом из диалога — такой токен сервер не обновляет и не удаляет.
YANDEX_WEBMASTER_HOST_IDСайт (host_id) по умолчанию, чтобы не уточнять его в каждом запросе. Узнать host_id можно командой «Покажи мои сайты в Вебмастере».
YANDEX_WEBMASTER_OAUTH_CLIENT_IDClientID собственного OAuth-приложения вместо приложения по умолчанию.
YANDEX_USER_IDИдентификатор пользователя Вебмастера; по умолчанию определяется автоматически.
YANDEX_WEBMASTER_TIMEOUT_MSТаймаут запроса; по умолчанию 60 000 мс.
YANDEX_WEBMASTER_MAX_RETRIESЧисло повторов при временных ошибках; по умолчанию 3.
YANDEX_WEBMASTER_API_BASEБазовый адрес API; по умолчанию https://api.webmaster.yandex.net/v4.

Готовый токен для YANDEX_OAUTH_TOKEN можно получить так: создайте приложение на oauth.yandex.ru, в правах доступа выберите API Яндекс Вебмастера — оба права, webmaster:hostinfo и webmaster:verify, и получите токен по инструкции Яндекс OAuth. Это же приложение подойдёт и для входа из диалога — задайте его ClientID в YANDEX_WEBMASTER_OAUTH_CLIENT_ID (Redirect URI — https://oauth.yandex.ru/verification_code).

Не публикуйте токен в чате, репозитории или скриншотах: он даёт доступ к сайтам вашего аккаунта.

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

По умолчанию сервер отправляет анонимные технические события: случайный идентификатор установки, название вызванного инструмента, версии сервера, AI-приложения, Node.js и операционной системы. При вызове инструмента сервер также отправляет его исход, а при ошибке - фрагмент её текста: код и сообщение, в которых e-mail, адреса, токены, числа от 4 цифр и текст в кавычках заменены на «#

冒頭だけを表示しています。続きはリポジトリで読めます

PopNxに聞く