Яндекс.Директ MCP server
API Яндекс.Директа v5: кампании, объявления, фразы, ставки, минус-фразы, статистика
1 stars546 downloads/wk
Reviews
Write oneNobody has reviewed Яндекс.Директ yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Яндекс.Директ tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.5 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan181 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 6 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
What the publisher says
From the Яндекс.Директ repository's README, as published. We do not edit it. Read it on GitHub
yandex-direct-mcp-plus
Ведение контекстной рекламы Яндекс.Директа из диалога с ассистентом: собрать кампанию, разобрать поисковые запросы, вычистить минус-фразы, поправить ставки и посмотреть расход — не переключаясь между разделами кабинета. Работает в любом MCP-клиенте: Claude Code, Claude Desktop, Cursor и другие.
- 60 инструментов, из них 25 только читают. Кампании и стратегии, группы, объявления и модерация, ключевые фразы и ставки, минус-фразы и общие наборы, быстрые ссылки, уточнения, изображения, визитки, корректировки ставок, ретаргетинг, аудиторные и динамические цели, фиды, расписание показов, статистика, поисковые запросы, баланс и справочники.
- Деньги — в рублях, на вводе и на выводе; в микроединицы API сервер переводит сам. Поддержан агентский режим (Client-Login).
- ID — строками ("1915016273214320641"): 64-битные идентификаторы Директа не помещаются в число JavaScript и молча теряют точность. Здесь это стережёт правило линтера, а не внимательность.
- Реклама боевая. Тестовой среды у Директа больше нет — какие инструменты тратят деньги и что удаляют необратимо, перечислено в разделе Что меняет данные.
- Телеметрии нет. Сервер не отправляет никуда ничего, кроме запросов к API Яндекса.
Содержание
- Что можно делать — примеры запросов обычным текстом
- Установка — Claude Code, Claude Desktop, Cursor, из исходников
- Токен — как получить и какие переменные окружения нужны
- Что меняет данные — что тратит бюджет и что необратимо
- Инструменты — полный список с описаниями
- Разработка — сборка, тесты, архитектура
Что можно делать
Обычным текстом в чате — инструменты сервер подставляет сам:
Собери кампанию «Летняя распродажа»: бюджет 5000 ₽/день, старт 1 мая, показы будни 9–21
Добавь минус-фразы «бесплатно» и «скачать» в кампанию 12345, не затерев остальные
Посмотри поисковые запросы за месяц и предложи, что заминусовать
Подними ставку до 25 ₽ там, где CTR выше 8%, а показов меньше сотни
Что изменилось в кампаниях со вчера?
Покажи расход по кампаниям за неделю и баланс аккаунта
Найди код региона для НовосибирскаПолный список — 60 инструментов ниже.
Установка
Нужен Node.js 22+ и OAuth-токен Яндекс.Директа — как его получить.
Claude Code
claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y yandex-direct-mcp-plusClaude Desktop, Cursor и другие клиенты
{
"mcpServers": {
"yandex-direct": {
"command": "npx",
"args": ["-y", "yandex-direct-mcp-plus"],
"env": {
"YANDEX_DIRECT_TOKEN": "ваш_токен"
}
}
}
}Из исходников
git clone git@github.com:Pavelsiba/yandex-direct-mcp-plus.git
cd yandex-direct-mcp-plus
npm ci && npm run buildДальше тот же конфиг, но "command": "node" и путь к dist/app/index.js вместо npx.
Токен
OAuth-токен выпускается для приложения, зарегистрированного в Яндекс OAuth, с доступом к API Директа. Подробности — регистрация приложения и получение токена. Доступ к API нужно запросить в интерфейсе Директа — заявку рассматривают от часа до нескольких суток.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
Runs npx -y yandex-direct-mcp-plus on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add yandex-direct-mcp-plus -- npx -y yandex-direct-mcp-plus
Яндекс.Директ: common questions
- Is Яндекс.Директ MCP server safe?
- Mostly: it is graded B (83/100). Read the Яндекс.Директ safety report
- How do I install Яндекс.Директ?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Яндекс.Директ need an API key?
- Yes. The registry entry asks for
YANDEX_DIRECT_TOKEN. - Is Яндекс.Директ maintained?
- The last commit was 8 days ago (2026-09-13). The latest release is v1.6.1.