Яндекс Вебмастер MCP-сервер

MCP-сервер для Яндекс Вебмастер API v4.1 — полное покрытие: индексация, поисковые запросы, диагностика, переобход, карты сайта, ссылки, мониторинг важных URL.

Возможности

37 инструментов, покрывающих весь Яндекс Вебмастер API:

• Пользователь и сайты — список сайтов, добавление/удаление, информация о сайте
• Верификация — статус подтверждения, запуск подтверждения, список владельцев
• Сводка и ИКС — общая информация по сайту с индексом качества, история ИКС
• Поисковые запросы — популярные запросы (ТОП-3000), история запросов с позициями/кликами/показами, аналитика запросов
• Переобход — квота на переобход, отправка URL на переиндексацию, отслеживание задач
• Диагностика — проблемы сайта и рекомендации
• Индексация — история индексации по HTTP-статусам, примеры проиндексированных страниц
• Важные URL — мониторинг критичных страниц, отслеживание изменений
• Страницы в поиске — страницы в выдаче (история + примеры), события появления/исчезновения
• Карты сайта — автоматически обнаруженные и добавленные вручную карты сайта
• Ссылки — внешние обратные ссылки, битые внутренние ссылки

Установка

pip install -e .

Настройка

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

export YANDEX_WEBMASTER_API_KEY=ваш_oauth_токен

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "python",
      "args": ["/путь/к/yandex-webmaster-mcp-server-python/src/yandex_webmaster_mcp/server.py"],
      "env": {
        "YANDEX_WEBMASTER_API_KEY": "ваш_oauth_токен"
      }
    }
  }
}

Claude Code

Добавьте в settings.json:

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "python",
      "args": ["/путь/к/yandex-webmaster-mcp-server-python/src/yandex_webmaster_mcp/server.py"],
      "env": {
        "YANDEX_WEBMASTER_API_KEY": "ваш_oauth_токен"
      }
    }
  }
}

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

1. Создайте приложение на https://oauth.yandex.ru/client/new
2. Выберите права: webmaster:hostinfo и webmaster:verify
3. Получите токен: https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID
4. Токен действует 6 месяцев

Примеры использования

# Получить user_id
get_user_id()

# Список всех сайтов
get_hosts(user_id="12345")

# Популярные запросы с позициями
get_popular_queries(
    user_id="12345",
    host_id="https:example.com:443",
    date_from="2026-03-01",
    date_to="2026-03-31",
    query_indicator="TOTAL_SHOWS,TOTAL_CLICKS,AVG_SHOW_POSITION"
)

# Отправить страницу на переобход
request_recrawl(
    user_id="12345",
    host_id="https:example.com:443",
    url="https://example.com/updated-page/"
)

# Мониторинг важных страниц
get_important_urls(
    user_id="12345",
    host_id="https:example.com:443"
)

Формат host_id

Яндекс Вебмастер использует особый формат идентификаторов сайтов:

• https:example.com:443 (не URL — протокол:домен:порт без слешей)
• http:example.com:80

Сервер автоматически URL-кодирует host_id при отправке запросов к API.

Лицензия

MIT