yandex-api-mcp: Вебмастер, Директ, Метрика, Wordstat в одном MCP
yandex-api-mcp
Один MCP-сервер в Docker читает данные Яндекс Вебмастера, Директа, Метрики, Wordstat, Аудиторий и Search API, запись по умолчанию заблокирована
- 0 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Токен Яндекса дает чтение статистики сайтов, кабинетов Директа и счетчиков, а сервис запущен с доступом к Docker
- Публичная сборка блокирует запись, но pro-сборка умеет менять данные с подтверждением
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/5iNeX/yandex-api-mcp.git && cd yandex-api-mcp && sudo ./install.shСтавит сервер в `/opt/yandex-api-mcp`, дальше `sudo yp-api oauth` и `sudo yp-api service start`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен Яндекса дает чтение статистики сайтов, кабинетов Директа и счетчиков, а сервис запущен с доступом к Docker
- Публичная сборка блокирует запись, но pro-сборка умеет менять данные с подтверждением
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Шлюз собирает шесть сервисов Яндекса за одним адресом MCP. Вебмастер отдает сайты, диагностику, запросы, индексирование, sitemap и лимит переобхода. Директ показывает кампании, группы, объявления, ключевые фразы, ставки и отчеты, включая клиентов агентства. Метрика дает счетчики, цели, сегменты и отчеты, Wordstat частотность, динамику и регионы, а Search API поисковую выдачу через Yandex Cloud. Несколько проектов используют один OAuth-токен Яндекса, а связи сайта, счетчика и логина Директа хранятся как локальные профили. Установка идет скриптом `install.sh`, управление командой `yp-api`. Публичный образ Docker блокирует любые вызовы записи, отдельная pro-сборка с предпросмотром не публикуется автоматически. Подключают сервер к Claude, Codex и Cursor через stdio-команду `docker exec`.
Для кого. SEO-специалистам и агентствам, которые ведут несколько сайтов и кабинетов Директа и хотят получать данные Яндекса в диалоге с агентом.
Подходит, если
- Нужна сводка по Вебмастеру: индексирование, диагностика и запросы нескольких сайтов
- Менеджер просит отчет Директа по кампаниям и ключевым фразам клиента агентства
- Частотность и динамику фраз из Wordstat надо сопоставить со счетчиками Метрики
- Для нескольких проектов нужен один OAuth-токен и профили сайт плюс счетчик
Не подходит, если
- Требуется менять кампании, ставки и цели: публичная сборка блокирует запись
- Нет сервера с Debian или Ubuntu и Docker Engine: установщик на них рассчитан
- Нужен только Яндекс Директ или только Метрика: проще взять узкий сервер одного сервиса
Пример запроса к агенту
Покажи, по каким запросам сайт example.com получил показы в Вебмастере за месяц, и сравни с динамикой WordstatMCP
- Транспорт
- stdio, sse
- Авторизация
- OAuth
Переменные окружения
YANDEX_CLIENT_IDобязательная- Client ID OAuth-приложения Яндекса, установщик спрашивает его при запуске
YANDEX_CLIENT_SECRETобязательная, секрет- Client Secret приложения, вводится скрыто и хранится в secrets/
Ограничения
Нужны Debian 12 или 13 либо Ubuntu 22.04 или 24.04, Docker Engine с Compose v2, `sudo`, свое OAuth-приложение Яндекса и доступ к Direct API. Для Wordstat и Search API требуется отдельный ключ Yandex Cloud. Операции записи в боевых аккаунтах автор не проверял. После добавления новых прав OAuth нужно пройти заново. Доступ к Docker дает широкие права на сервере. Лицензия Apache-2.0, ядро на TypeScript под MIT, последний коммит в сентябре 2026 года, звезд нет.
Как отключить. Остановите сервер командой `sudo yp-api service stop`, уберите его из настроек MCP-клиента и отзовите токен приложения на oauth.yandex.ru. Каталоги `state/` и `secrets/` в `/opt/yandex-api-mcp` удаляются вручную.
Частые вопросы
Можно ли менять кампании Директа через этот сервер?
Нет, публичная сборка блокирует любые вызовы записи. Отдельная pro-сборка с предпросмотром и подтверждением в публичный образ не входит.
Какие права OAuth нужны?
`webmaster:hostinfo` и `webmaster:verify` для Вебмастера, `direct:api` для Директа, `metrika:read` для Метрики и `audience:read` для Аудиторий. После добавления права OAuth проходят заново.
Чем авторизуются Wordstat и Search API?
Ключом Yandex Cloud сервисного аккаунта с ролью `search-api.webSearch.user`. Токен Директа для них не подходит. Ключ кладут в `secrets/yandex.env` и перезапускают службу.
Как подключить сервер к ChatGPT?
Через отдельный OpenAI Secure MCP Tunnel с `tunnel-client`, у которого stdio-командой служит `docker exec`. Публичный порт MCP для этого не нужен.
Как проверить установку?
Команды `sudo yp-api doctor`, `sudo yp-api discover` и `sudo yp-api verify` проверяют связь, показывают доступные сайты и счетчики и делают read-запросы через MCP.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер от ZAI.ONE сводит Директ, Метрику, поиск, Wordstat и Вебмастер в одном агенте, с мастером настройки и включаемыми пишущими операциями
MCP-сервер со 125 инструментами для Яндекс Вебмастера, Директа и Метрики, несколько проектов и токенов в одном процессе
MCP для Директа, Метрики, Wordstat и Вебмастера
yandex-marketing-mcp
MCP-сервер на 155 инструментов для Яндекс Директа, Метрики, Wordstat и Вебмастера с самонастройкой OAuth и режимами read-only и confirm
Пять MCP-серверов для API Яндекса: Вордстат, Поиск, Вебмастер, Метрика и Директ, плюс плагин со скиллами для Claude Code
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
Монорепозиторий MCP-серверов для Яндекса: Директ, Метрика, Вебмастер, Wordstat, Трекер, 360, Карты, SpeechKit, YandexGPT и AppMetrica
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| yandex-api-mcp: Вебмастер, Директ, Метрика, Wordstat в одном MCP (эта карточка) | нет | OAuth | 0 | |
| Yandex Direct MCP | нет | не нужна | 14 | охватывает шесть сервисов Яндекса с общими проектами, запись заблокирована |
| Yandex Metrika MCP | нет | API-ключ | 24 | Метрика входит как одна из шести, рядом Вебмастер, Директ и Wordstat |
Коротко о README
В README описаны шесть сервисов, подготовка OAuth и ключей Yandex Cloud, установка скриптом, профили проектов, подключение локальных клиентов и ChatGPT, команды управления и таблица частых проблем.