Yandex Webmaster MCP Server

MCP-сервер для Yandex Webmaster API v4. Предоставляет 46 инструментов для управления сайтами, картами сайтов, индексацией, поисковой аналитикой, обратными ссылками, фидами и многим другим через Model Context Protocol.

Возможности

• Core --- информация о пользователе, управление хостами, верификация, диагностика
• Content --- карты сайтов, индексация, URL в поиске, важные URL, битые ссылки, события поиска
• Analytics --- поисковые запросы, популярные запросы, внешние ссылки, SQI, аналитика запросов
• Actions --- переобход страниц, оригинальные тексты, управление фидами

Примеры промптов

Аудит сайта --- быстрая проверка состояния и проблем:

• «Какие проблемы обнаружены на сайте dellshop.ru?»
• «Есть ли битые внутренние ссылки на сайте?»
• «Найди страницы, исключённые из поиска как малоценные»

Мониторинг позиций --- отслеживание видимости в поиске:

• «Покажи популярные поисковые запросы за последнюю неделю»
• «Покажи историю SQI за последние 3 месяца»
• «Сколько страниц проиндексировано и какие HTTP-коды возвращают?»

Ссылочный профиль --- анализ внешних и внутренних ссылок:

• «Какие внешние ссылки ведут на мой сайт?»
• «Покажи динамику внешних ссылок за последний месяц»

Действия --- управление индексацией и контентом:

• «Отправь главную страницу на переобход»
• «Покажи список всех моих сайтов в Яндекс Вебмастере»

Установка

Через npx (без установки)

npx -y yandex-webmaster-mcp-server

Глобальная установка

npm install -g yandex-webmaster-mcp-server
yandex-webmaster-mcp-server

Из исходников

git clone https://github.com/weselow/yandex-webmaster-mcp-server.git
cd yandex-webmaster-mcp-server
pnpm install
pnpm build

Настройка

Переменные окружения

Получение OAuth-токена

1. Перейдите на oauth.yandex.ru/client/new
2. Создайте приложение:
   • Укажите название (любое, например «Webmaster MCP»)
   • В разделе «Доступ к данным» добавьте права:
     • webmaster:verify --- верификация сайтов
     • webmaster:hostinfo --- доступ к информации о сайтах
   • Нажмите «Создать приложение»
   • Скопируйте ClientID из созданного приложения
3. Откройте в браузере ссылку для получения токена (подставьте свой ClientID):

   https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID
   

4. Авторизуйтесь и разрешите доступ приложению
5. Яндекс перенаправит на страницу с токеном --- скопируйте значение access_token из адресной строки
6. Установите токен в переменную окружения YANDEX_WEBMASTER_OAUTH_TOKEN

Использование

Режим stdio (по умолчанию)

YANDEX_WEBMASTER_OAUTH_TOKEN=your-token npx -y yandex-webmaster-mcp-server

HTTP-режим

YANDEX_WEBMASTER_OAUTH_TOKEN=your-token npx -y yandex-webmaster-mcp-server --http --port=3000

Настройка MCP-клиента

Для Claude Desktop или .mcp.json:

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "yandex-webmaster-mcp-server"],
      "env": {
        "YANDEX_WEBMASTER_OAUTH_TOKEN": "your-token",
        "YANDEX_WEBMASTER_HOST_URL": "https://example.com"
      }
    }
  }
}

YANDEX_WEBMASTER_HOST_URL --- необязательная переменная. Если указать URL вашего основного сайта, сервер будет использовать его по умолчанию во всех запросах. Это сокращает количество API-вызовов и экономит токены, так как не нужно каждый раз передавать host_id.

Или, если установлено из исходников:

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "YANDEX_WEBMASTER_OAUTH_TOKEN": "your-token",
        "YANDEX_WEBMASTER_HOST_URL": "https://example.com"
      }
    }
  }
}

Доступные инструменты

Core --- базовые операции (10)

Управление аккаунтом, хостами (сайтами), верификация и диагностика.

Content --- контент и индексация (16)

Карты сайтов, статус индексации, URL в поиске, важные URL, битые ссылки и события поиска.

Analytics --- аналитика (7)

Поисковые запросы, внешние ссылки, SQI и продвинутая аналитика запросов.

Actions --- действия (13)

Переобход страниц, оригинальные тексты и управление фидами.

Разработка

pnpm install          # Установка зависимостей
pnpm dev              # Запуск в режиме разработки (watch)
pnpm build            # Сборка для продакшена
pnpm test             # Запуск тестов
pnpm test:watch       # Запуск тестов в режиме наблюдения

Лицензия

MIT