English Français العربية

io.github.theYahia/yandex-webmaster-mcp

Registre officiel Recherche et web

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @theyahia/yandex-webmaster-mcp
Claude Code 
claude mcp add yandex-webmaster-mcp -e 'YANDEX_WEBMASTER_TOKEN=<your yandex_webmaster_token>' -- npx -y @theyahia/yandex-webmaster-mcp@1.0.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "yandex-webmaster-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/yandex-webmaster-mcp@1.0.2"
            ],
            "env": {
                "YANDEX_WEBMASTER_TOKEN": "<your yandex_webmaster_token>"
            }
        }
    }
}

Variables d'environnement

  • YANDEX_WEBMASTER_TOKEN obligatoire secret API key

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @theyahia/yandex-webmaster-mcp
  2. Установка
  3. Авторизация
  4. Инструменты (13)
  5. Примеры запросов
  6. HTTP-режим
  7. Разработка
  8. Лицензия

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

Установка

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

Questions fréquentes

Qu'est-ce que io.github.theYahia/yandex-webmaster-mcp ?

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

Comment installer io.github.theYahia/yandex-webmaster-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add yandex-webmaster-mcp -e 'YANDEX_WEBMASTER_TOKEN=<your yandex_webmaster_token>' -- npx -y @theyahia/yandex-webmaster-mcp@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.theYahia/yandex-webmaster-mcp ?

Oui. Il attend YANDEX_WEBMASTER_TOKEN, à renseigner dans sa configuration.

io.github.theYahia/yandex-webmaster-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.theYahia/yandex-webmaster-mcp ?

Il est publié par theYahia. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.