Skip to main content
Glama
Yandex Webmaster MCP Server

Yandex Webmaster MCP Server

by theYahia

Этот сервер входит в сборку 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).

npm License: MIT

Установка

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

Related MCP server: kurerok-yandex-webmaster-mcp

Авторизация

Нужен только YANDEX_WEBMASTER_TOKEN — OAuth-токен с правом webmaster:api. user_id определяется автоматически через GET /user/, задавать его руками не нужно.

Как получить токен:

  1. Создайте приложение на https://oauth.yandex.ru/ и выдайте ему право Яндекс.Вебмастер (webmaster:api).

  2. Получите 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

Available Tools

13 tools
get_diagnosticsA
Read-only

Site diagnostics: crawl errors, DNS issues, server problems.

Inputs: host_id (required), format.

get_hostsA
Read-only

List all sites in Yandex.Webmaster: URL, verification status.

Inputs: format.

get_important_urlsB
Read-only

Monitored important URLs for a host and their status history.

Inputs: host_id (required), format.

get_indexingB
Read-only

Indexing status summary for a host (quality index, problem counts).

Inputs: host_id (required), format.

get_indexing_historyA
Read-only

Indexed / excluded page-count trend over time (detect deindexing).

Inputs: host_id (required), format, date_to, date_from.

get_query_analyticsA
Read-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_quotaB
Read-only

Remaining daily re-crawl (re-indexing) quota for a host.

Inputs: host_id (required), format.

get_recrawl_taskA
Read-only

Status of a re-crawl task by id (from submit_url).

Inputs: host_id (required), task_id (required), format.

get_search_queriesA
Read-only

[DEPRECATED — use get_popular_search_queries] Per-query search analytics: clicks, impressions, position.

Inputs: host_id (required), format, date_to, date_from.

get_sitemapsA
Read-only

List sitemaps for a host: URL, status, last checked, indexed count.

Inputs: host_id (required), format.

get_user_infoA
Read-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

    A3.9/5.0

    Scored across 13 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    13 tools is a well-scoped size for a Yandex Webmaster server, covering diagnostics, analytics, indexing, and recrawl without being overwhelming or too sparse.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • 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
      22 npm
      8
      MIT
    • 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
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Yandex.Metrica API providing 15 tools for managing counters, goals, reports, logs, traffic sources, and top pages with OAuth Bearer token authentication.
      15
      130 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Yandex Metrika API, enabling reporting, counter management, goals, filters, and other operations via natural language.
      12
      2
      MIT