{
  "markdown": "> ## 🗄 Репозиторий заархивирован\n>\n> Разработка переехала в **[theYahia/YaAll](https://github.com/theYahia/YaAll)** —\n> сборку, где весь яндексовский слой лежит в одном месте: официальные MCP-серверы\n> Яндекса, MCP под Директ и Метрику, скилл YaGEO и Wordstat-гейт.\n>\n> Актуальная версия того, что лежало здесь: [`mcp/yandex-direct-mcp/`](https://github.com/theYahia/YaAll/tree/main/mcp/yandex-direct-mcp)\n>\n> Здесь больше ничего не обновляется. Задачи и pull request'ы — в YaAll.\n>\n> **Archived — development moved to [theYahia/YaAll](https://github.com/theYahia/YaAll),**\n> a single repository bundling the whole Yandex stack. The current version of this\n> package now lives at [`mcp/yandex-direct-mcp/`](https://github.com/theYahia/YaAll/tree/main/mcp/yandex-direct-mcp). Please open issues and pull requests there.\n\n# @theyahia/yandex-direct-mcp\n\nMCP-сервер для API Яндекс.Директ — управление контекстной рекламой из любого MCP-клиента (Claude, Cursor и др.): кампании, группы, объявления, ключевые слова, **ставки**, **минус-фразы**, статистика, баланс. **20 инструментов.**\n\n[![npm](https://img.shields.io/npm/v/@theyahia/yandex-direct-mcp)](https://www.npmjs.com/package/@theyahia/yandex-direct-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n> Деньги — **в рублях** (бюджеты, ставки на вводе и выводе); сервер сам конвертирует в микроединицы API. Поддержаны **песочница** для безопасного теста и **агентский режим** (Client-Login).\n\n## Установка\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"yandex-direct\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/yandex-direct-mcp\"],\n      \"env\": {\n        \"YANDEX_DIRECT_TOKEN\": \"ваш_токен\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y @theyahia/yandex-direct-mcp\n```\n\n## Конфигурация (переменные окружения)\n\n| Переменная | Обязательна | Назначение |\n|------------|:-----------:|------------|\n| `YANDEX_DIRECT_TOKEN` | да | OAuth-токен Яндекс.Директ |\n| `YANDEX_DIRECT_SANDBOX` | нет | `1` — работа в [песочнице](https://yandex.ru/dev/direct/doc/concepts/sandbox.html) (изолированные данные, без трат). Тот же токен, отличается только URL |\n| `YANDEX_DIRECT_LOGIN` | нет | Логин клиента для агентских токенов (заголовок `Client-Login`). Обязателен, если токен агентский |\n\n### Как получить токен\n\nOAuth-токен выпускается для приложения, зарегистрированного в [Яндекс OAuth](https://oauth.yandex.ru/), с доступом к API Директа. Подробности — [регистрация приложения и получение токена](https://yandex.ru/dev/direct/doc/start/token.html). Доступ к API нужно [запросить в интерфейсе Директа](https://yandex.ru/dev/direct/doc/start/step1.html).\n\n## ⚠️ Внимание: реальные траты\n\nИнструменты `create_campaign`, `create_text_ad`, `add_keywords`, `set_keyword_bids` и др. меняют боевой рекламный аккаунт и могут **расходовать деньги**. Для отладки сценариев включайте песочницу (`YANDEX_DIRECT_SANDBOX=1`).\n\n## Инструменты (20)\n\n**Кампании**\n\n| Инструмент | Описание |\n|------------|----------|\n| `list_campaigns` | Список кампаний (фильтр по статусу/типу, пагинация) |\n| `get_campaign` | Детальная информация о кампании по ID |\n| `create_campaign` | Создать кампанию (бюджет в рублях, выбор стратегии) |\n| `update_campaign` | Обновить название/бюджет и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE) |\n\n**Группы объявлений**\n\n| Инструмент | Описание |\n|------------|----------|\n| `list_ad_groups` | Группы объявлений выбранных кампаний |\n| `create_ad_group` | Создать группу с таргетингом по регионам |\n| `delete_ad_groups` | Удалить группы по ID |\n| `set_ad_group_negative_keywords` | Задать минус-фразы группы |\n\n**Объявления**\n\n| Инструмент | Описание |\n|------------|----------|\n| `list_ads` | Объявления в группах |\n| `create_text_ad` | Создать текстовое объявление (≤56/≤30/≤81) |\n| `update_text_ad` | Обновить заголовок/текст/ссылку |\n| `manage_ads` | suspend/resume/archive/unarchive/moderate/delete |\n\n**Ключевые слова и ставки**\n\n| Инструмент | Описание |\n|------------|----------|\n| `list_keywords` | Ключевые фразы в группах (ставки в рублях) |\n| `add_keywords` | Добавить ключевые фразы |\n| `set_keyword_bids` | Установить ставки (поиск/сети, рубли) на фразах/группах/кампаниях |\n| `manage_keywords` | suspend/resume/delete |\n| `set_campaign_negative_keywords` | Задать минус-фразы кампании |\n\n**Статистика, аккаунт, справочники**\n\n| Инструмент | Описание |\n|------------|----------|\n| `get_statistics` | Статистика за период (показы, клики, расход, CTR, CPC) |\n| `get_account_balance` | Баланс аккаунта (Live API v4) |\n| `get_regions` | Справочник кодов регионов (225 = Россия) |\n\n## Примеры запросов\n\n```\nПокажи все активные рекламные кампании\nСоздай кампанию \"Летняя распродажа\" с бюджетом 5000 ₽/день, старт 2026-05-01\nУстанови ставку 25 ₽ на ключевые фразы 111 и 222\nДобавь минус-фразы \"бесплатно\", \"скачать\" в кампанию 12345\nКакая статистика у кампаний 12345 и 67890 за последнюю неделю?\nНайди код региона для Новосибирска\nПокажи баланс аккаунта\n```\n\n## Разработка\n\n```bash\nnpm install\nnpm run build      # tsc → dist/\nnpm test           # vitest (моки fetch)\nnpm run dev        # tsx src/index.ts\n```\n\n## Лицензия\n\nMIT\n",
  "bytes": 5245,
  "sha": "1928c07c92c7559350cbf8cad7c6128681bc9fb7e5e39c0e67b42687a9f527cf",
  "repo_slug": "theyahia/yandex-direct-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theyahia_yandex_direct_mcp_f6fae5b4/readme"
}