Yandex Webmaster Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.2Updated Nov 3, 2026

MCP server for Yandex.Webmaster API — hosts, search queries, indexing status. Bearer token auth.

VerifiedSTDIODesktop onlyWeb Search & ScrapingSecurity & MonitoringData & Analytics

Overview

AI-generated overview

MCP server for the Yandex.Webmaster API that lets an assistant list sites, read search-query and indexing data, check sitemaps and diagnostics, and request…

What you can do
  • List sites and account info, including verification status and user ID
  • Read search-query performance: impressions, clicks and average position per query, plus aggregated traffic trends over time
  • Check indexing: summary, history of indexed and excluded pages, and monitoring of important URLs
  • Inspect sitemaps and site diagnostics such as crawl errors, DNS and server problems
  • Submit a URL for recrawl, check the remaining daily quota and the status of a recrawl task
  • Choose compact Markdown or raw JSON output for every tool
When to use it
Useful for SEO and site-owner work on sites registered in Yandex.Webmaster: reviewing which queries bring traffic, tracking indexing and deindexing, diagnosing crawl problems, and triggering recrawls of updated pages.
Requirements
Runs locally via npx (Node.js) over stdio, or in an optional HTTP mode on port 3100. Requires an OAuth token with the webmaster:api scope in YANDEX_WEBMASTER_TOKEN; the user ID is detected automatically unless YANDEX_WEBMASTER_USER_ID is set. Network access to the Yandex.Webmaster API is needed.
Before you install
The OAuth token in YANDEX_WEBMASTER_TOKEN grants access to the account's Webmaster data and must be kept secret. submit_url sends a real recrawl request and consumes the daily recrawl quota. In HTTP mode the token is shared for all callers with no multi-tenancy, and MCP_ALLOWED_HOSTS set to * disables DNS-rebinding protection; MCP_HTTP_AUTH_TOKEN can protect the endpoint.

Installation

In SourceWeft

  1. Open Yandex Webmaster Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

json
{  "mcpServers": {    "yandex-webmaster": {      "command": "npx",      "args": ["-y", "@theyahia/yandex-webmaster-mcp"],      "env": {        "YANDEX_WEBMASTER_TOKEN": "ваш_oauth_токен"      }    }  }}

Claude Code

bash
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/, задавать его руками не нужно.

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

  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:

bash
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 не поддерживается.

Разработка

bash
npm installnpm run dev          # запуск из исходников (tsx)npm test             # тесты (vitest)npm run typecheck    # tsc --noEmit (src + tests)npm run lint         # eslintnpm run format       # prettier --checknpm run build        # сборка в dist/

Лицензия

MIT

Source: README.md at commit 7a9f243

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts