Back to Browse

Yandex Webmaster MCP Server

Developer ToolsModerate5.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.0
Moderate5.0Moderate Risk

Valid MCP server (2 strong, 3 medium validity signals). 4 known CVEs in dependencies (1 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.

12 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

API keyRequired

Environment variable: YANDEX_WEBMASTER_TOKEN

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-theyahia-yandex-webmaster-mcp": {
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "your-yandex-webmaster-token-here"
      },
      "args": [
        "-y",
        "@theyahia/yandex-webmaster-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

@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

Авторизация

Нужен только 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

Reviews

No reviews yet

Be the first to review this server!

Yandex Webmaster MCP Server - MCP server for Yandex.Webmaster API — hosts, search | MCP Marketplace