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

@theyahia/yandex-webmaster-mcp

MCP-сервер на TypeScript для API Яндекс Вебмастера: сайты, индексация, поисковые запросы, карты сайта, диагностика и переобход, 13 инструментов

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

theyahia/yandex-webmaster-mcpАвтор:theYahia

Установка

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

npx skillfoxx add mcp/theyahia-yandex-webmaster-mcp

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

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

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

claude mcp add --transport stdio --env 'YANDEX_WEBMASTER_TOKEN=<ваш YANDEX_WEBMASTER_TOKEN>' yandex-webmaster -- npx -y @theyahia/yandex-webmaster-mcp

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

codex mcp add yandex-webmaster --env 'YANDEX_WEBMASTER_TOKEN=<ваш YANDEX_WEBMASTER_TOKEN>' -- npx -y @theyahia/yandex-webmaster-mcp

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

Бывший Windsurf.

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

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

YANDEX_WEBMASTER_TOKENсекрет, обязательная

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

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

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

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

Создай приложение на oauth.yandex.ru с правом webmaster:api, получи OAuth-токен, затем выполни claude mcp add yandex-webmaster -e YANDEX_WEBMASTER_TOKEN=твой_токен -- npx -y @theyahia/yandex-webmaster-mcp.

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

claude mcp add yandex-webmaster -e YANDEX_WEBMASTER_TOKEN=ваш_oauth_токен -- npx -y @theyahia/yandex-webmaster-mcp

Команда из README для подключения в Claude Code.

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

Что делает

Сервер дает 13 инструментов для Яндекс Вебмастера: список подтвержденных сайтов, данные аккаунта, поисковые запросы по сайту с показами, кликами и средней позицией, агрегированный тренд трафика во времени, сводку индексации, работу с картами сайта, важными URL, диагностикой хостов и запросом на переобход страниц. Вывод по умолчанию идет компактным Markdown, но можно получить и сырой JSON. Авторизация нужна только по токену webmaster:api, числовой user_id сервер определяет сам через API, вручную его указывать не нужно. Сервер входит в более широкую сборку YaAll того же автора, где рядом собраны десять MCP-серверов под разные сервисы Яндекса, но распространяется и работает отдельным npm-пакетом.

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

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

Нужны индексация, поисковые запросы и диагностика конкретного сайта в Вебмастере
Нужен компактный Markdown-вывод вместо сырого JSON для экономии контекста
Нужен переобход страниц после правок на сайте

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

Нужен весь стек Яндекс-сервисов сразу: проще взять сборку YaAll того же автора целиком
Нужны данные не по своему подтвержденному сайту: доступ ограничен сайтами из аккаунта токена

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

Покажи сводку индексации сайта и запроси переобход страниц, которые давно не обновлялись

Ограничения

Нужен OAuth-токен с правом webmaster:api, полученный через приложение на oauth.yandex.ru. Инструмент get_search_queries помечен в README как устаревший псевдоним get_popular_search_queries. HTTP-режим по умолчанию не проверяет Host-заголовок против DNS-rebinding, если явно не задан список MCP_ALLOWED_HOSTS.

Как отключить. Удалите сервер командой claude mcp remove yandex-webmaster или уберите блок yandex-webmaster из конфигурации MCP клиента.

MCP

Транспорт: stdio, http
Авторизация: API-ключ

Переменные окружения
Переменные окружения
YANDEX_WEBMASTER_TOKEN обязательная, секрет	OAuth-токен с правом webmaster:api
YANDEX_WEBMASTER_USER_ID	Числовой user ID, определяется автоматически если не задан
MCP_ALLOWED_HOSTS	Разрешенные хосты для HTTP-режима, защита от DNS-rebinding

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

Может запрашивать переобход страниц и менять карты сайта, если такие права есть у токена
OAuth-токен дает доступ ко всем подтвержденным сайтам аккаунта Вебмастера

Коротко о README

README отмечает, что сервер входит в более широкую сборку YaAll с десятью MCP-серверами под Яндекс, но здесь распространяется отдельно. Перечислены 13 инструментов по сайтам, индексации, поисковым запросам, картам сайта, важным URL, диагностике и переобходу, таблица переменных окружения с токеном, опциональным user_id и настройками HTTP-режима, установка для Claude Desktop и Claude Code через npx, и получение токена через oauth.yandex.ru с правом webmaster:api.

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

Нужно ли указывать user_id вручную?

Нет, сервер определяет его сам через запрос GET /user/.

Можно ли получить сырой JSON вместо Markdown?

Да, вывод по умолчанию компактный Markdown, но доступен и режим сырого JSON.

Скиллы 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