@theyahia/yandex-webmaster-mcp
MCP-сервер для API Яндекс.Вебмастер — сайты, индексация, поисковые запросы, sitemaps, диагностика и переобход. 13 инструментов, вывод в компактном Markdown (или сыром JSON).
Установка
Claude Desktop
{
"mcpServers": {
"yandex-webmaster": {
"command": "npx",
"args": ["-y", "@theyahia/yandex-webmaster-mcp"],
"env": {
"YANDEX_WEBMASTER_TOKEN": "ваш_oauth_токен"
}
}
}
}
Claude Code
claude mcp add yandex-webmaster -e YANDEX_WEBMASTER_TOKEN=ваш_oauth_токен -- npx -y @theyahia/yandex-webmaster-mcp
Авторизация
Нужен только YANDEX_WEBMASTER_TOKEN — OAuth-токен с правом webmaster:api.
user_id определяется автоматически через GET /user/, задавать его руками не нужно.
Как получить токен:
- Создайте приложение на https://oauth.yandex.ru/ и выдайте ему право
Яндекс.Вебмастер (
webmaster:api). - Получите OAuth-токен по
инструкции Яндекса и положите его в
YANDEX_WEBMASTER_TOKEN.
Переменные окружения
| Переменная | Обяз. | Назначение |
|---|---|---|
YANDEX_WEBMASTER_TOKEN | да | OAuth-токен с правом webmaster:api |
YANDEX_WEBMASTER_USER_ID | нет | Числовой user ID. Если не задан — определяется автоматически |
PORT | нет | Порт HTTP-режима (по умолчанию 3100) |
MCP_ALLOWED_HOSTS | нет | Разрешённые Host для HTTP (CSV). * — отключить защиту от DNS-rebinding |
MCP_HTTP_AUTH_TOKEN | нет | Если задан — требует Authorization: Bearer <token> на POST /mcp |
Инструменты (13)
| Инструмент | Описание |
|---|---|
get_hosts | Список сайтов: URL, статус подтверждения |
get_user_info | Данные аккаунта (user_id) |
get_popular_search_queries | Поисковые запросы по сайту: показы, клики, средняя позиция (per-query) |
get_query_analytics | Агрегированный тренд трафика во времени (НЕ per-query) |
get_search_queries | ⚠️ deprecated — алиас get_popular_search_queries |
get_indexing | Сводка индексации сайта |
get_indexing_history | Тренд проиндексированных/исключённых страниц |
submit_url | Отправить URL на переобход (расходует дневную квоту) |
get_recrawl_quota | Остаток дневной квоты переобхода |
get_recrawl_task | Статус задачи переобхода по task_id |
get_sitemaps | Список sitemap'ов сайта |
get_diagnostics | Диагностика сайта: ошибки обхода, DNS, проблемы сервера |
get_important_urls | Мониторинг важных URL |
У каждого инструмента есть параметр format: markdown (по умолчанию, компактно) или
json (сырой ответ API).
Примеры запросов
Какие сайты у меня в Вебмастере?
По каким запросам находят мой сайт за последнюю неделю?
Сколько страниц проиндексировано и есть ли деиндексация?
Отправь https://example.com/new-page на переобход и покажи остаток квоты.
HTTP-режим
Помимо stdio сервер умеет работать по Streamable HTTP:
YANDEX_WEBMASTER_TOKEN=... npx @theyahia/yandex-webmaster-mcp --http
# POST /mcp — MCP endpoint
# GET /health — { "status": "ok", "version": "..." }
По умолчанию включена защита от DNS-rebinding (разрешены только localhost/127.0.0.1).
Для доступа с другого хоста задайте MCP_ALLOWED_HOSTS. Токен в HTTP-режиме общий
(берётся из окружения) — multi-tenancy не поддерживается.
Разработка
npm install
npm run dev # запуск из исходников (tsx)
npm test # тесты (vitest)
npm run typecheck # tsc --noEmit (src + tests)
npm run lint # eslint
npm run format # prettier --check
npm run build # сборка в dist/
Лицензия
MIT