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.txtpython3 -m venv .venv
.venv/bin/pip install -r requirements.txtКлюч
Нужен OAuth-токен Яндекса с правом webmaster:hostinfo:
- Создайте приложение на oauth.yandex.ru/client/new: платформа «Веб-сервисы», Redirect URI
https://oauth.yandex.ru/verification_code, право Яндекс Вебмастер → webmaster:hostinfo. Если поставите и сервер Метрики, отметьте сразу иmetrika:read— токен будет один на оба. - Откройте
https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID, нажмите «Разрешить» и скопируйте токенy0_…. - В папке сервера переименуйте
.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.
Claude Desktop: Settings → Developer → Edit Config. Cursor: Settings → MCP или файл ~/.cursor/mcp.json. Слеши — прямые.
{
"mcpServers": {
"yandex-webmaster": {
"command": "C:/mcp/yandex-webmaster-mcp/.venv/Scripts/python.exe",
"args": ["C:/mcp/yandex-webmaster-mcp/server.py"]
}
}
}Если в файле уже есть другие серверы, добавьте этот внутрь блока "mcpServers". Claude Desktop перезапустите полностью — через значок в трее.
claude mcp add yandex-webmaster --scope user -- ~/mcp/yandex-webmaster-mcp/.venv/bin/python ~/mcp/yandex-webmaster-mcp/server.pyВ JSON для Claude Desktop и Cursor — те же пути с .venv/bin/python.
Названия пунктов меню у клиентов меняются — сверяйтесь с их документацией.
Проверка
Спросите агента: «Покажи мои сайты в Яндекс Вебмастере и ИКС каждого». Если агент ответил данными — всё работает. Если пишет, что инструмента нет, — проверьте путь: команда .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, там же общий архив и настройка сразу для всех.