Skip to main content
Glama
Sign In
Yandex Webmaster MCP Server

Yandex Webmaster MCP Server

by Crash-SV
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

MCP-сервер для Яндекс Вебмастер API v4.1 — полное покрытие: индексация, поисковые запросы, диагностика, переобход, карты сайта, ссылки, мониторинг важных URL.

Возможности

37 инструментов, покрывающих весь Яндекс Вебмастер API:

  • Пользователь и сайты — список сайтов, добавление/удаление, информация о сайте

  • Верификация — статус подтверждения, запуск подтверждения, список владельцев

  • Сводка и ИКС — общая информация по сайту с индексом качества, история ИКС

  • Поисковые запросы — популярные запросы (ТОП-3000), история запросов с позициями/кликами/показами, аналитика запросов

  • Переобход — квота на переобход, отправка URL на переиндексацию, отслеживание задач

  • Диагностика — проблемы сайта и рекомендации

  • Индексация — история индексации по HTTP-статусам, примеры проиндексированных страниц

  • Важные URL — мониторинг критичных страниц, отслеживание изменений

  • Страницы в поиске — страницы в выдаче (история + примеры), события появления/исчезновения

  • Карты сайта — автоматически обнаруженные и добавленные вручную карты сайта

  • Ссылки — внешние обратные ссылки, битые внутренние ссылки

Related MCP server: yandex-mcp

Установка

pip install -e .

Настройка

Переменная окружения

export YANDEX_WEBMASTER_API_KEY=ваш_oauth_токен

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "python",
      "args": ["/путь/к/yandex-webmaster-mcp-server-python/src/yandex_webmaster_mcp/server.py"],
      "env": {
        "YANDEX_WEBMASTER_API_KEY": "ваш_oauth_токен"
      }
    }
  }
}

Claude Code

Добавьте в settings.json:

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "python",
      "args": ["/путь/к/yandex-webmaster-mcp-server-python/src/yandex_webmaster_mcp/server.py"],
      "env": {
        "YANDEX_WEBMASTER_API_KEY": "ваш_oauth_токен"
      }
    }
  }
}

Получение OAuth-токена

  1. Создайте приложение на https://oauth.yandex.ru/client/new

  2. Выберите права: webmaster:hostinfo и webmaster:verify

  3. Получите токен: https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID

  4. Токен действует 6 месяцев

Примеры использования

# Получить user_id
get_user_id()

# Список всех сайтов
get_hosts(user_id="12345")

# Популярные запросы с позициями
get_popular_queries(
    user_id="12345",
    host_id="https:example.com:443",
    date_from="2026-03-01",
    date_to="2026-03-31",
    query_indicator="TOTAL_SHOWS,TOTAL_CLICKS,AVG_SHOW_POSITION"
)

# Отправить страницу на переобход
request_recrawl(
    user_id="12345",
    host_id="https:example.com:443",
    url="https://example.com/updated-page/"
)

# Мониторинг важных страниц
get_important_urls(
    user_id="12345",
    host_id="https:example.com:443"
)

Формат host_id

Яндекс Вебмастер использует особый формат идентификаторов сайтов:

  • https:example.com:443 (не URL — протокол:домен:порт без слешей)

  • http:example.com:80

Сервер автоматически URL-кодирует host_id при отправке запросов к API.

Лицензия

MIT

Available Tools

37 tools
add_hostAdd HostC

Add a new site to Yandex Webmaster.

Inputs: user_id (required), host_url (required). Returns: result

add_sitemapAdd SitemapC

Add a sitemap to the site.

Inputs: host_id (required), user_id (required), sitemap_url (required). Returns: result

delete_hostDelete HostC

Remove a site from Yandex Webmaster.

Inputs: host_id (required), user_id (required). Returns: result

delete_sitemapDelete SitemapC

Delete a user-added sitemap.

Inputs: host_id (required), user_id (required), sitemap_id (required). Returns: result

get_diagnosticsGet DiagnosticsB

Get site diagnostics — problems and recommendations (FATAL, CRITICAL, etc.).

Inputs: host_id (required), user_id (required). Returns: result

get_external_linksGet External LinksB

Get samples of external links (backlinks) pointing to the site.

Inputs: host_id (required), user_id (required), limit, offset. Returns: result

get_external_links_historyGet External Links HistoryB

Get history of external links count over time.

Inputs: host_id (required), user_id (required). Returns: result

get_host_infoGet Host InfoC

Get detailed information about a specific site.

Inputs: host_id (required), user_id (required). Returns: result

get_host_ownersGet Host OwnersC

Get list of verified site owners/managers.

Inputs: host_id (required), user_id (required). Returns: result

get_hostsGet HostsB

Get list of all sites added to Yandex Webmaster.

Inputs: user_id (required). Returns: result

get_important_url_historyGet Important Url HistoryB

Get monitoring history for a specific important URL.

Inputs: url (required), host_id (required), user_id (required). Returns: result

get_important_urlsGet Important UrlsC

Get monitoring data for important pages — indexing status, search status, change indicators.

Inputs: host_id (required), user_id (required). Returns: result

get_indexing_historyGet Indexing HistoryB

Get indexing history — number of indexed pages by HTTP status over time.

Inputs: date_to (required), host_id (required), user_id (required), date_from (required). Returns: result

get_indexing_samplesGet Indexing SamplesB

Get samples of indexed pages (up to 50,000 URLs).

Inputs: host_id (required), user_id (required), limit, offset. Returns: result

get_internal_broken_linksGet Internal Broken LinksC

Get samples of broken internal links.

Inputs: host_id (required), user_id (required), limit, offset, +1 more. Returns: result

get_internal_broken_links_historyGet Internal Broken Links HistoryC

Get history of broken internal links count over time.

Inputs: host_id (required), user_id (required), date_to, date_from. Returns: result

get_popular_queriesGet Popular QueriesC

Get TOP-3000 popular search queries with indicators (shows, clicks, positions).

Inputs: date_to (required), host_id (required), user_id (required), date_from (required), +5 more. Returns: result

get_query_analyticsGet Query AnalyticsC

Advanced search query analytics (POST). Data for last 2 weeks only.

Inputs: host_id (required), user_id (required), limit, offset, +8 more. Returns: result

get_query_historyGet Query HistoryC

Get aggregated search query statistics (all queries) over time — shows, clicks, positions by day.

Inputs: date_to (required), host_id (required), user_id (required), date_from (required), +2 more. Returns: result

get_recrawl_quotaGet Recrawl QuotaA

Get daily recrawl quota (how many URLs can be submitted per day).

Inputs: host_id (required), user_id (required). Returns: result

get_recrawl_tasksGet Recrawl TasksC

Get list of recrawl tasks.

Inputs: host_id (required), user_id (required), limit, offset, +2 more. Returns: result

get_recrawl_task_statusGet Recrawl Task StatusC

Get status of a specific recrawl task.

Inputs: host_id (required), task_id (required), user_id (required). Returns: result

get_search_urls_events_historyGet Search Urls Events HistoryC

Get history of pages appearing/disappearing from Yandex search.

Inputs: date_to (required), host_id (required), user_id (required), date_from (required). Returns: result

get_search_urls_events_samplesGet Search Urls Events SamplesC

Get samples of pages that recently appeared or disappeared from Yandex search.

Inputs: host_id (required), user_id (required), limit, offset. Returns: result

get_search_urls_historyGet Search Urls HistoryB

Get history of pages count in Yandex search results over time.

Inputs: date_to (required), host_id (required), user_id (required), date_from (required). Returns: result

get_search_urls_samplesGet Search Urls SamplesB

Get samples of pages currently in Yandex search results (up to 50,000).

Inputs: host_id (required), user_id (required), limit, offset. Returns: result

get_single_query_historyGet Single Query HistoryB

Get search statistics history for a specific query (by query_id from get_popular_queries).

Inputs: date_to (required), host_id (required), user_id (required), query_id (required), +3 more. Returns: result

get_sitemap_infoGet Sitemap InfoB

Get details of an auto-detected sitemap.

Inputs: host_id (required), user_id (required), sitemap_id (required). Returns: result

get_sitemapsGet SitemapsC

Get auto-detected sitemaps.

Inputs: host_id (required), user_id (required), limit, offset_id, +1 more. Returns: result

get_sqi_historyGet Sqi HistoryC

Get Site Quality Index (SQI/ИКС) history over time.

Inputs: host_id (required), user_id (required), date_to, date_from. Returns: result

get_summaryGet SummaryB

Get site summary: SQI, indexed pages count, site problems count.

Inputs: host_id (required), user_id (required). Returns: result

get_user_added_sitemap_infoGet User Added Sitemap InfoC

Get details of a user-added sitemap.

Inputs: host_id (required), user_id (required), sitemap_id (required). Returns: result

get_user_added_sitemapsGet User Added SitemapsC

Get list of user-added sitemaps.

Inputs: host_id (required), user_id (required), limit, offset. Returns: result

get_user_idGet User IdA

Get authenticated Yandex Webmaster user ID.

Inputs: no named parameters. Returns: result

get_verification_statusGet Verification StatusC

Get site verification status.

Inputs: host_id (required), user_id (required). Returns: result

request_recrawlRequest RecrawlC

Submit a URL for recrawl/reindexing by Yandex.

Inputs: url (required), host_id (required), user_id (required). Returns: result

verify_hostVerify HostC

Start site verification process.

Inputs: host_id (required), user_id (required), verification_type (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3/5.0

    Scored across 37 tools

    Disambiguation4/5

    Most tools target distinct resources and actions clearly (recrawl, indexing, search URLs, queries, sitemaps). A few clusters risk confusion: get_sitemap_info vs get_user_added_sitemap_info, get_sitemaps vs get_user_added_sitemaps, and get_hosts vs get_host_info, but the descriptions differentiate them.

    Naming Consistency4/5

    Consistent snake_case verb_noun pattern throughout (add_host, get_host_info, delete_sitemap, request_recrawl). Minor deviations like get_X_info/get_X_history/get_X_samples layering and verbs add/get/delete/verify/request are predictable and readable.

    Tool Count3/5

    37 tools is on the heavy side, mapping to broad coverage of a large API domain. Each tool roughly earns its place, but the count is high enough to burden selection and could be consolidated (e.g. sitemap and search-URL variants).

    Completeness4/5

    Strong lifecycle coverage across hosts, sitemaps, recrawl, indexing, queries, diagnostics, and links, with both history and sample endpoints. Some gaps remain (e.g. update/modify operations for monitored URLs), but core workflows are covered.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Yandex Webmaster MCP Server

      theYahia
      A
      license
      A
      quality
      C
      maintenance
      MCP server for interacting with Yandex.Webmaster API to manage sites, retrieve search queries, and check indexing status. Requires an OAuth token.
      13
      77 npm
      6
      MIT

    • yandex-mcp

      SvechaPVL
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Yandex Direct, Metrika, Wordstat, and Webmaster APIs, providing 132 tools to manage advertising campaigns, analytics, keyword research, and reporting through any MCP-compatible client.
      58
      MIT

    • Yandex Webmaster MCP Server

      weselow
      A
      license
      C
      quality
      D
      maintenance
      MCP server that provides 46 tools for managing Yandex Webmaster API v4, enabling site management, sitemaps, indexing, search analytics, and more through natural language.
      46
      30 npm
      7
      MIT

    • kurerok-yandex-webmaster-mcp

      shutovdef-dotcom
      A
      license
      A
      quality
      D
      maintenance
      Local-first MCP server for Yandex Webmaster that exposes tools for SEO operations including search query analytics, sitemap management, indexing history, recrawl quota, and diagnostics.
      15
      MIT