ai-hub-open/yandex-direct-mcp

MCP server for Yandex Direct API: campaigns, ads, keywords, bids, reports. Click.ru proxy or direct OAuth with sandbox. Docs in Russian.

About yandex-direct-mcp

MCP-сервер для Yandex Direct JSON API v5 на Bun + TypeScript.

49 инструментов: кампании (включая ЕПК, стратегии торгов и цели Метрики), группы объявлений, объявления (текстовые и комбинаторные), расширения (быстрые ссылки, уточнения), изображения, ставки, корректировки ставок, ключевые фразы, отчёты, справочники.

Скопируйте .env.example в .env и заполните один из двух режимов (переменные окружения имеют приоритет над .env):

A. Прямой режим — свой OAuth-токен Яндекс.Директа:

По умолчанию используется версия API v501 (обязательна для ЕПК); переключить можно через YANDEXDIRECTAPIVERSION=v5.

B. Через прокси Click.ru — OAuth-токен Яндекса не нужен:

Токен создаётся в профиле https://click.ru/userinfo.html → поле «API Token» → «Создать». Аккаунт Яндекс.Директа должен быть подключён в Click.ru. Справка: https://help.click.ru/81, https://api.click.ru/V0/docs/.

Прокси Click.ru работает только с продакшн-API Яндекса (песочница недоступна).

В HTTP-режиме MCPAUTHTOKEN обязателен — см. HTTP-режим.

Обязательный гейт перед изменениями — мок-тесты (тела запросов к API, без сети) и тесты HTTP-транспорта (авторизация, CORS):

E2E-прогон на песочнице (создаёт и удаляет тестовые кампании; нужны YANDEXDIRECTTOKEN и YANDEXDIRECTSANDBOX=true):

Ограничения песочницы Яндекса (в проде их нет; часть лечится пересозданием песочницы в кабинете — Инструменты → Настройки API → Песочница). E2E помечает такие шаги как «пропуск», а не как ошибку:

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/ai-hub-open--yandex-direct-mcp.html)

Related MCP servers