Yandex Webmaster MCP

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

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

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

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

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

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

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

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

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

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

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

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

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

Содержание

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

快速开始

需要 Node.js 20+。首次运行时，npx 会下载服务，无需单独安装软件包。 无需提前获取令牌：连接过程会在对话中直接完成。

1. 将服务添加到你的 AI 应用中。请选择下方的说明。
2. 输入：“连接 Yandex 网站站长”——助手会引导你登录 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"]
    }
  }
}

可以交给它做什么

了解网站在搜索中的状态

• “显示我在网站站长中的网站及其 ИКС。”
• “主站有多少页面出现在搜索结果中，又有多少被排除？”
• “网站有哪些严重和致命问题？”
• “哪些重要页面的索引状态发生了变化？”

分析搜索查询

• “过去一周，网站最常因哪些查询而展示？”
• “过去一个月，网站的展示次数、点击次数和平均排名有何变化？”
• “比较网站在移动设备和电脑上的可见度。”

检查抓取、sitemap 和外部链接

• “显示 Yandex 机器人抓取网站时遇到的 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 表示暂时没有数据，并非指标为零。

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

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

Инструменты, которые меняют состояние, помечены для 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.ru, в правах доступа выберите API Яндекс Вебмастера и получите токен по инструкции Яндекс 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.