mcp server

yandex-direct-mcp

MCP server for Yandex Direct — PPC campaigns, ads, keywords, stats (Russia). Part of WWmcp — 114 MCP servers for emerging markets.

theYahia/yandex-direct-mcpcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "theyahia-yandex-direct-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-direct-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 17, 2026

@theyahia/yandex-direct-mcp

MCP-сервер для API Яндекс.Директ — управление контекстной рекламой из любого MCP-клиента (Claude, Cursor и др.): кампании, группы, объявления, ключевые слова, ставки, минус-фразы, статистика, баланс. 20 инструментов.

Деньги — в рублях (бюджеты, ставки на вводе и выводе); сервер сам конвертирует в микроединицы API. Поддержаны песочница для безопасного теста и агентский режим (Client-Login).

Установка

Claude Desktop

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "ваш_токен"
      }
    }
  }
}

Claude Code

claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y @theyahia/yandex-direct-mcp

Конфигурация (переменные окружения)

Переменная	Обязательна	Назначение
`YANDEX_DIRECT_TOKEN`	да	OAuth-токен Яндекс.Директ
`YANDEX_DIRECT_SANDBOX`	нет	`1` — работа в песочнице (изолированные данные, без трат). Тот же токен, отличается только URL
`YANDEX_DIRECT_LOGIN`	нет	Логин клиента для агентских токенов (заголовок `Client-Login`). Обязателен, если токен агентский

Как получить токен

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

⚠️ Внимание: реальные траты

Инструменты create_campaign, create_text_ad, add_keywords, set_keyword_bids и др. меняют боевой рекламный аккаунт и могут расходовать деньги. Для отладки сценариев включайте песочницу (YANDEX_DIRECT_SANDBOX=1).

Инструменты (20)

Кампании

Инструмент	Описание
`list_campaigns`	Список кампаний (фильтр по статусу/типу, пагинация)
`get_campaign`	Детальная информация о кампании по ID
`create_campaign`	Создать кампанию (бюджет в рублях, выбор стратегии)
`update_campaign`	Обновить название/бюджет и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE)

Группы объявлений

Инструмент	Описание
`list_ad_groups`	Группы объявлений выбранных кампаний
`create_ad_group`	Создать группу с таргетингом по регионам
`delete_ad_groups`	Удалить группы по ID
`set_ad_group_negative_keywords`	Задать минус-фразы группы

Объявления

Инструмент	Описание
`list_ads`	Объявления в группах
`create_text_ad`	Создать текстовое объявление (≤56/≤30/≤81)
`update_text_ad`	Обновить заголовок/текст/ссылку
`manage_ads`	suspend/resume/archive/unarchive/moderate/delete

Ключевые слова и ставки

Инструмент	Описание
`list_keywords`	Ключевые фразы в группах (ставки в рублях)
`add_keywords`	Добавить ключевые фразы
`set_keyword_bids`	Установить ставки (поиск/сети, рубли) на фразах/группах/кампаниях
`manage_keywords`	suspend/resume/delete
`set_campaign_negative_keywords`	Задать минус-фразы кампании

Статистика, аккаунт, справочники

Инструмент	Описание
`get_statistics`	Статистика за период (показы, клики, расход, CTR, CPC)
`get_account_balance`	Баланс аккаунта (Live API v4)
`get_regions`	Справочник кодов регионов (225 = Россия)

Примеры запросов

Покажи все активные рекламные кампании
Создай кампанию "Летняя распродажа" с бюджетом 5000 ₽/день, старт 2026-05-01
Установи ставку 25 ₽ на ключевые фразы 111 и 222
Добавь минус-фразы "бесплатно", "скачать" в кампанию 12345
Какая статистика у кампаний 12345 и 67890 за последнюю неделю?
Найди код региона для Новосибирска
Покажи баланс аккаунта

Разработка

npm install
npm run build      # tsc → dist/
npm test           # vitest (моки fetch)
npm run dev        # tsx src/index.ts

Лицензия

MIT