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

MCP-сервер Yandex Webmaster с подключением прямо в диалоге через OAuth PKCE: 20 инструментов для диагностики, запросов, sitemap и переобхода

MCP-серверРоссийский стек

askads/mcp-yandex-webmasterАвтор:Ask Ads

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/yandeks-vebmaster-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'YANDEX_OAUTH_TOKEN=<ваш YANDEX_OAUTH_TOKEN>' mcp-yandex-webmaster -- npx -y mcp-yandex-webmaster@1.1.1

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"mcp-yandex-webmaster","type":"stdio","command":"npx","args":["-y","mcp-yandex-webmaster@1.1.1"],"env":{"YANDEX_OAUTH_TOKEN":"<ваш YANDEX_OAUTH_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "mcp-yandex-webmaster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add mcp-yandex-webmaster --env 'YANDEX_OAUTH_TOKEN=<ваш YANDEX_OAUTH_TOKEN>' -- npx -y mcp-yandex-webmaster@1.1.1

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.mcp-yandex-webmaster]
command = "npx"
args = ["-y", "mcp-yandex-webmaster@1.1.1"]
env = { YANDEX_OAUTH_TOKEN = "<ваш YANDEX_OAUTH_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "mcp-yandex-webmaster": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "environment": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster@1.1.1"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<ваш YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_OAUTH_TOKENсекрет, обязательная: Yandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.
YANDEX_USER_IDнеобязательная: Token owner's user id; auto-detected via GET /v4/user when unset.
YANDEX_WEBMASTER_HOST_IDнеобязательная: Default host_id (e.g. https:example.com:443) used when a tool call omits one.
YANDEX_WEBMASTER_API_BASEнеобязательная: API root override.
YANDEX_WEBMASTER_TIMEOUT_MSнеобязательная: Per-request timeout in milliseconds.
YANDEX_WEBMASTER_MAX_RETRIESнеобязательная: Retries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 727d1ca.

Текст для агента

Добавь сервер командой claude mcp add --transport stdio --scope user yandex-webmaster -- npx -y mcp-yandex-webmaster@latest, затем в диалоге попроси «Подключи Яндекс Вебмастер» и пройди вход по ссылке.

Другие способы из описания автора

claude mcp add --transport stdio --scope user yandex-webmaster -- npx -y mcp-yandex-webmaster@latest

Команда из README, токен не нужен: вход проходит в диалоге после подключения.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает 20 инструментов для Yandex Webmaster API v4: список сайтов с ИКС, диагностика проблем по степени серьезности, статистика показов и кликов по запросам с разбивкой по устройствам, история индексации, HTTP-ошибки при обходе, sitemap и внешние ссылки. Почти все инструменты только читают, отдельные могут добавить сайт или sitemap, запустить подтверждение прав или поставить страницу в очередь на переобход. Подключение проходит прямо в диалоге: агент открывает страницу входа Яндекса, пользователь присылает одноразовый код, который по PKCE обменивается на токен внутри работающего сервера, без правки конфигурации и создания токена заранее.

Для кого. Для SEO-специалистов и владельцев сайтов, которым нужен быстрый разговорный доступ к данным Яндекс Вебмастера без ручной настройки токена.

Подходит, если

Хочется подключиться без предварительного создания OAuth-приложения и токена
Нужен разбор диагностики, показов, кликов и позиций естественным языком
Нужно проверить sitemap, поставить страницу на переобход или добавить новый сайт

Не подходит, если

Нужны данные Метрики, Вордстата или рекламного кабинета: сервер работает только с органическим поиском Вебмастера
Нужен постоянный фоновый мониторинг: сервер отвечает только на вызовы агента

Пример запроса к агенту

Какие критичные проблемы сейчас видит диагностика на моем сайте?

Ограничения

Диагностика, запросы и индексация доступны только для сайтов с подтвержденными правами, без подтверждения видны лишь список сайтов и статус прав. Переобход ограничен суточной квотой сайта. Топ запросов ограничен 3000 строками за неделю, максимум 500 строк за один запрос. По умолчанию сервер отправляет анонимную техническую телеметрию (можно отключить переменной ASKADS_TELEMETRY=0), токен и данные аккаунта в нее не попадают.

Как отключить. Скажите агенту «отключи Вебмастер» или удалите сервер из конфигурации клиента, доступ также можно отозвать в Яндекс ID.

MCP

Транспорт: stdio
Авторизация: OAuth

Переменные окружения
Переменные окружения
YANDEX_OAUTH_TOKEN секрет	Готовый OAuth-токен для CI, в обычном режиме не нужен: приоритетнее входа из диалога
YANDEX_WEBMASTER_HOST_ID	Сайт по умолчанию, чтобы не уточнять его в каждом запросе
YANDEX_WEBMASTER_OAUTH_CLIENT_ID	ClientID своего OAuth-приложения вместо приложения по умолчанию

Проверка безопасности

Может добавлять сайты и sitemap, запускать проверку прав и переобход, включая удаление через универсальный raw_request
Полученный OAuth-токен дает доступ ко всем сайтам аккаунта Яндекса на год без повторного входа

Коротко о README

README на русском описывает подключение без предварительного токена через OAuth PKCE прямо в диалоге, установку через npx для Codex, Claude Code, Claude Desktop, Cursor и VS Code, таблицу того, какие операции меняют данные, переменные окружения для CI, раздел про телеметрию и ссылки на подробную документацию инструментов.

Частые вопросы

Нужно ли заранее создавать OAuth-токен?

Нет, для обычного использования токен не нужен: подключение проходит прямо в диалоге через одноразовый код по протоколу PKCE, который безопасно пересылать в чате.

Что произойдет при HOST_NOT_VERIFIED?

Это значит, что права на сайт не подтверждены в Вебмастере, доступны только список сайтов и проверка статуса прав, для остального нужно подтверждение через DNS, HTML-файл или мета-тег.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO

Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.

Claude SEO

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

Скиллы DataLens

MCP Яндекс Метрики со всеми 108 методами API

OpenSEO

Claude SEO