Telegram Обсудить проект
MCP · бесплатно · только чтение

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

Подключает Яндекс Вебмастер к Claude, Cursor и другим ИИ-агентам: агент сам смотрит популярные запросы с позициями, ИКС, проблемы сайта и историю обхода и отвечает обычными словами.

Версия 1.0.0 · Python 3.10+ · лицензия MIT

Коротко

MCP-сервер Яндекс Вебмастера — программа на Python, через которую ИИ-агент читает данные Вебмастера по вашему OAuth-токену: сайты, ИКС, проблемы, популярные запросы с показами, кликами и позициями, историю обхода. Работает на вашем компьютере, только чтение, бесплатно.

Что умеет

ИнструментЧто даётПример вопроса
webmaster_list_hostsсайты аккаунта, подтверждены ли права, главное зеркало«Какие сайты у меня в Вебмастере и все ли подтверждены?»
webmaster_host_summaryИКС, страницы в поиске и исключённые, проблемы по уровням«Какие проблемы у example.ru и что исправить первым?»
webmaster_search_queriesпопулярные запросы: показы, клики, средняя позиция, устройства«Какие запросы с позицией 4–15 дают больше всего показов?»
webmaster_indexing_historyобход по дням: страницы с ответами 2xx, 3xx, 4xx, 5xx«Не выросло ли число ошибок 404 при обходе за месяц?»

Агент сам выбирает инструмент и параметры — достаточно спросить обычными словами.

Установка

1. Python 3.10 или новее — python.org/downloads. На Windows отметьте при установке Add python.exe to PATH.

2. Архив. Скачайте yandex-webmaster-mcp.zip и распакуйте, например, в C:\mcp. Откройте папку yandex-webmaster-mcp, в адресной строке Проводника наберите powershell и нажмите Enter.

3. Зависимости:

python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

Ключ

Нужен OAuth-токен Яндекса с правом webmaster:hostinfo:

  1. Создайте приложение на oauth.yandex.ru/client/new: платформа «Веб-сервисы», Redirect URI https://oauth.yandex.ru/verification_code, право Яндекс Вебмастер → webmaster:hostinfo. Если поставите и сервер Метрики, отметьте сразу и metrika:read — токен будет один на оба.
  2. Откройте https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID, нажмите «Разрешить» и скопируйте токен y0_….
  3. В папке сервера переименуйте .env.example в .env, откройте блокнотом и впишите:
YANDEX_OAUTH_TOKEN=y0_ваш_токен

Подробно, со скриншотами шагов и ошибками, — в статье «API Яндекс Вебмастера». Токен живёт 6 месяцев: когда агент начнёт получать ошибку 401, повторите шаг 2.

Подключение к агенту

Пути замените на свои.

claude mcp add yandex-webmaster --scope user -- "C:\mcp\yandex-webmaster-mcp\.venv\Scripts\python.exe" "C:\mcp\yandex-webmaster-mcp\server.py"

Проверка: claude mcp list — статус Connected.

Названия пунктов меню у клиентов меняются — сверяйтесь с их документацией.

Проверка

Спросите агента: «Покажи мои сайты в Яндекс Вебмастере и ИКС каждого». Если агент ответил данными — всё работает. Если пишет, что инструмента нет, — проверьте путь: команда .venv\Scripts\python server.py в папке сервера должна молча «зависнуть» (это норма, выход Ctrl+C).

Необязательные настройки

Все — в файле .env, по одной на строку.

НастройкаЗачем
WEBMASTER_ALLOWED_HOSTSограничить агента этими сайтами через запятую — удобно для агентского аккаунта
YANDEX_WEBMASTER_USER_IDваш user_id, чтобы не тратить на него запрос
HTTP_TIMEOUTтаймаут запросов, по умолчанию 30 секунд
HTTPS_PROXYпрокси, если API Яндекса недоступен напрямую

Частые ошибки

Что видитеЧто делать
YANDEX_OAUTH_TOKEN не заданнет файла .env (а не .env.example) или токен не вставлен
401токен истёк или скопирован не полностью — получите новый
403у приложения нет права webmaster:hostinfo или сайт не подтверждён в этом аккаунте
Пустые запросы по сайтунеглавное зеркало или нет данных за период

Не пересылайте никому файлы .env, credentials.json и gsc_token.json — это доступ к данным ваших сайтов. Вопросы и ошибки — в Telegram-канал @seo_drift.

Чего не умеет

  • Только чтение: переобход и добавление сайтов сервер не делает.
  • Запросы — те, что отдаёт API Вебмастера: до 3000 за период, средняя позиция, история ограничена.
  • Данные только по сайтам с подтверждёнными правами и главным зеркалам.
  • Токен Яндекса живёт 6 месяцев.

Какие данные собирает

Сервер работает у вас на компьютере. Ключ лежит в папке сервера и уходит только в официальный API. SEO Drift не видит ни ключа, ни данных ваших сайтов.

Вопросы и ответы

Это бесплатно?

Да. Сервер бесплатный, с открытым кодом под лицензией MIT, API тоже бесплатный.

С какими агентами работает?

С любым клиентом MCP, который запускает локальные серверы: Claude Code, Claude Desktop, Cursor и другие.

Может ли сервер что-то изменить в кабинете?

Нет, все инструменты только читают данные.

Где остальные серверы?

Все три сервера — Вебмастер, Метрика и Search Console — на странице MCP-серверы для SEO, там же общий архив и настройка сразу для всех.

Читать дальше по теме

Источники

  1. Яндекс — API Вебмастера
  2. Яндекс — API Вебмастера: как получить OAuth-токен

Другие инструменты

Все инструменты →