Skip to main content
Glama
theYahia

Yandex Webmaster MCP Server

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@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: yandex-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

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/yandex-webmaster-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server