yandex-webmaster-mcp

このサーバーは theYahia/YaAll の一部です。 ヤンデックス関連のスタック全体を1つのリポジトリにまとめています。10個のMCPサーバー、SEOと需要検証向けのClaude Codeスキル、そしてヤンデックス公式サーバーの資料が含まれています。 ここでは単独で、あちらではほかのサーバーと並んでいます：mcp/yandex-webmaster-mcp/

theYahia/YaAll の一部です。ヤンデックス関連のスタック全体を1つのリポジトリにまとめています。

@theyahia/yandex-webmaster-mcp

ヤンデックスウェブマスター API 用のMCPサーバーです。サイト、インデックス登録、検索クエリ、サイトマップ、 診断、再クロールに対応します。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 のみです。webmaster:api 権限を持つOAuthトークンを使用します。 user_id は GET /user/ で自動的に取得されるため、手動で設定する必要はありません。

トークンの取得方法：

1. https://oauth.yandex.ru/ でアプリケーションを作成し、ヤンデックスウェブマスター（webmaster:api） 権限を付与します。
2. ヤンデックスの手順に従ってOAuthトークンを取得し、 YANDEX_WEBMASTER_TOKEN に設定します。

環境変数

変数	必須	用途
YANDEX_WEBMASTER_TOKEN	はい	webmaster:api 権限を持つOAuthトークン
YANDEX_WEBMASTER_USER_ID	いいえ	数値のユーザーID。未設定の場合は自動的に取得されます
PORT	いいえ	HTTPモードのポート（デフォルトは 3100）
MCP_ALLOWED_HOSTS	いいえ	HTTPで許可するHost（CSV）。* はDNSリバインディング対策を無効にします
MCP_HTTP_AUTH_TOKEN	いいえ	設定すると、POST /mcp で Authorization: Bearer <token> が必要になります

Инструменты (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