Yandex Webmaster MCP Server
Query and manage Yandex.Webmaster data for your sites via 13 tools (read-only except URL re-crawl submission).
Sites & account: list your sites with verification status (
get_hosts), get accountuser_id(get_user_info).Search analytics: per-query shows, clicks, and average position (
get_popular_search_queries), plus aggregate traffic trends over a date range (get_query_analytics); all endpoints support date ranges, device type, indicators, sorting, and pagination.Indexing: indexing summary and problem counts (
get_indexing), and indexed/excluded page trends to detect deindexing (get_indexing_history).Re-crawl (write): submit URLs for re-indexing, spending daily quota (
submit_url), check remaining quota (get_recrawl_quota), and monitor task status (get_recrawl_task).Sitemaps & health: list sitemaps (
get_sitemaps), run site diagnostics for crawl/DNS/server errors (get_diagnostics), and monitor important URLs (get_important_urls).Output options: every tool returns compact Markdown by default or raw JSON via
format.Deployment: runs over stdio (Claude Desktop/Code) or Streamable HTTP with
/mcpand/health, DNS-rebinding protection, and optional bearer auth; uses a single sharedYANDEX_WEBMASTER_TOKEN(no multi-tenancy).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Yandex Webmaster MCP Server List my sites in Yandex Webmaster"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Этот сервер входит в сборку theYahia/YaAll — весь яндексовский слой в одном репозитории: десять MCP-серверов, скиллы Claude Code под SEO и валидацию спроса, плюс материалы официальных серверов Яндекса. Здесь он живёт отдельно, там — рядом с остальными:
mcp/yandex-webmaster-mcp/Part of theYahia/YaAll — the whole Yandex stack in one repo.
@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-mcpRelated MCP server: kurerok-yandex-webmaster-mcp
Авторизация
Нужен только YANDEX_WEBMASTER_TOKEN — OAuth-токен с правом webmaster:api.
user_id определяется автоматически через GET /user/, задавать его руками не нужно.
Как получить токен:
Создайте приложение на https://oauth.yandex.ru/ и выдайте ему право Яндекс.Вебмастер (
webmaster:api).Получите OAuth-токен по инструкции Яндекса и положите его в
YANDEX_WEBMASTER_TOKEN.
Переменные окружения
Переменная | Обяз. | Назначение |
| да | OAuth-токен с правом |
| нет | Числовой user ID. Если не задан — определяется автоматически |
| нет | Порт HTTP-режима (по умолчанию |
| нет | Разрешённые Host для HTTP (CSV). |
| нет | Если задан — требует |
Инструменты (13)
Инструмент | Описание |
| Список сайтов: URL, статус подтверждения |
| Данные аккаунта (user_id) |
| Поисковые запросы по сайту: показы, клики, средняя позиция (per-query) |
| Агрегированный тренд трафика во времени (НЕ per-query) |
| ⚠️ deprecated — алиас |
| Сводка индексации сайта |
| Тренд проиндексированных/исключённых страниц |
| Отправить URL на переобход (расходует дневную квоту) |
| Остаток дневной квоты переобхода |
| Статус задачи переобхода по |
| Список sitemap'ов сайта |
| Диагностика сайта: ошибки обхода, DNS, проблемы сервера |
| Мониторинг важных 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
Available Tools
13 toolsget_diagnosticsARead-only
Site diagnostics: crawl errors, DNS issues, server problems.
Inputs: host_id (required), format.
get_hostsARead-only
List all sites in Yandex.Webmaster: URL, verification status.
Inputs: format.
get_important_urlsBRead-only
Monitored important URLs for a host and their status history.
Inputs: host_id (required), format.
get_indexingBRead-only
Indexing status summary for a host (quality index, problem counts).
Inputs: host_id (required), format.
get_indexing_historyARead-only
Indexed / excluded page-count trend over time (detect deindexing).
Inputs: host_id (required), format, date_to, date_from.
get_popular_search_queriesARead-only
Per-query analytics: query text, shows, clicks, average position. The data behind 'which queries bring traffic'.
Inputs: host_id (required), limit, format, offset, +5 more.
get_query_analyticsARead-only
Aggregate search-traffic time series (total shows/clicks/position over a date range) — NOT per-query.
Inputs: host_id (required), format, date_to, date_from, +2 more.
get_recrawl_quotaBRead-only
Remaining daily re-crawl (re-indexing) quota for a host.
Inputs: host_id (required), format.
get_recrawl_taskARead-only
Status of a re-crawl task by id (from submit_url).
Inputs: host_id (required), task_id (required), format.
get_search_queriesARead-only
[DEPRECATED — use get_popular_search_queries] Per-query search analytics: clicks, impressions, position.
Inputs: host_id (required), format, date_to, date_from.
get_sitemapsARead-only
List sitemaps for a host: URL, status, last checked, indexed count.
Inputs: host_id (required), format.
get_user_infoARead-only
Get your Yandex Webmaster account info (user_id).
Inputs: format.
submit_urlA
Submit a URL for re-crawling / re-indexing by Yandex (consumes daily quota).
Inputs: url (required), host_id (required), format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools have distinct purposes (e.g., get_hosts lists sites, get_query_analytics aggregates time series), but get_popular_search_queries and get_search_queries overlap, with one explicitly deprecated. The descriptions clarify the distinction, so misselection is unlikely.
All tools follow a consistent 'get_' prefix with descriptive nouns, except submit_url which is a clear action verb. The pattern is uniform and readable, with no mixed conventions.
13 tools is a well-scoped size for a Yandex Webmaster server, covering diagnostics, analytics, indexing, and recrawl without being overwhelming or too sparse.
The surface covers core domain needs: diagnostics, analytics, indexing, sitemaps, and recrawl submission. Minor gaps exist (e.g., no verification or sitemap submission), but most workflows are supported. The deprecated get_search_queries slightly clutters the set.
Maintenance
Related MCP Connectors
MCP servers for Yandex APIs: Wordstat, Search, Webmaster, Metrika, Direct. Open source, by Seyka AI.
Read-only Google Search Console MCP server for AI assistants.
MCP server for Google search results via SERP API
Audit, rank-track and analyze SEO for sites via an authenticated MCP server.
Related MCP Servers
- AlicenseCqualityDmaintenanceMCP server that provides 46 tools for managing Yandex Webmaster API v4, enabling site management, sitemaps, indexing, search analytics, and more through natural language.4622 npm8MIT
- AlicenseAqualityDmaintenanceLocal-first MCP server for Yandex Webmaster that exposes tools for SEO operations including search query analytics, sitemap management, indexing history, recrawl quota, and diagnostics.15MIT
- AlicenseAqualityCmaintenanceMCP server for Yandex.Metrica API providing 15 tools for managing counters, goals, reports, logs, traffic sources, and top pages with OAuth Bearer token authentication.15130 npm1MIT
- AlicenseAqualityDmaintenanceMCP server for Yandex Metrika API, enabling reporting, counter management, goals, filters, and other operations via natural language.122MIT