@theyahia/yandex-direct-mcp

MCP-сервер для API Яндекс.Директ — кампании, объявления, группы объявлений, ключевые слова, ставки, статистика. OAuth-токен.

Установка

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

Streamable HTTP

YANDEX_DIRECT_TOKEN=ваш_токен npx @theyahia/yandex-direct-mcp --http
# Сервер запустится на порту 3000 (или PORT)

Smithery

npx @smithery/cli install @theyahia/yandex-direct-mcp

Авторизация

YANDEX_DIRECT_TOKEN — OAuth-токен Яндекс.Директ. Передается как Authorization: Bearer {token} к https://api.direct.yandex.com/json/v5/.

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

Инструмент	Описание
`get_campaigns`	Список рекламных кампаний с бюджетом и статусом
`get_ads`	Объявления кампании: заголовки, тексты, ссылки
`get_ad_groups`	Группы объявлений кампании
`get_keywords`	Ключевые слова: фразы, ставки, статусы
`get_statistics`	Статистика: показы, клики, расход, CTR, CPC за период
`get_bids`	Ставки по ключевым словам кампании
`set_bids`	Установить ставки для ключевых слов
`suspend_campaign`	Остановить рекламную кампанию
`resume_campaign`	Возобновить рекламную кампанию

Skills (навыки)

Навык	Описание
`skill-campaign-stats`	Статистика рекламной кампании за период
`skill-check-budget`	Проверь бюджет и расход по кампаниям

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

Покажи статистику кампании за март
Какие ключевые слова самые эффективные?
Покажи все активные рекламные кампании
Какая статистика у кампании 12345 за последнюю неделю?
Останови кампанию 67890
Какой бюджет у моих кампаний?
Установи ставку 15 руб на ключевые слова 100, 101, 102
Покажи группы объявлений в кампании 12345

Разработка

npm install
npm test          # Vitest
npm run build     # TypeScript → dist/
npm run dev       # tsx watch
npm run start:http  # Streamable HTTP на :3000

Лицензия

MIT

yandex-direct-mcp

Quick Install