AI导哈

搜索引擎API服务器

Yandex Webmaster的MCP服务器，提供全面的API覆盖，包括索引、搜索查询、诊断、重新爬取、站点地图、链接和重要URL监控等功能。

  • by Crash-SV
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Crash-SV/yandex-webmaster-mcp-server-for-api-v4-1

使用说明

Яндекс Вебмастер 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

相关 MCP