yandex-direct-mcp-plus
An MCP server for managing Yandex Direct from a chat client: inspect and change campaigns, ads, keywords, bids, targeting, reports, and account data.
Connect to Yandex Direct via dialog login or configured token, and check auth status.
Browse campaigns, strategies, schedules, ad groups, ads, keywords, negative-keyword sets, sitelinks, callouts, images, vCards, audiences, dynamic targets, retargeting, bid adjustments, feeds, businesses, regions, and time zones.
Create or update campaigns, ad groups, text ads, keywords, negative-keyword rules, sitelinks, callouts, images, retargeting lists, audience/dynamic targets, and bid adjustments.
Set campaign strategy, priority goals, time targeting, keyword bids, and manage statuses such as suspend, resume, archive, and moderation submission.
Run read-only reports: statistics, search queries, keyword auction data, account balance, object changes, and reference lookups.
Perform destructive deletions and budget-affecting actions; many write tools support dry_run previews.
Works against the live Yandex Direct API only, with no test/sandbox environment, so write/destructive actions can affect real ad spend.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yandex-direct-mcp-plus show search queries for the past month and suggest negative keywords"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
yandex-direct-mcp-plus
Ведение контекстной рекламы Яндекс.Директа из диалога с ассистентом: собрать кампанию, разобрать поисковые запросы, вычистить минус-фразы, поправить ставки и посмотреть расход — не переключаясь между разделами кабинета. Работает в любом MCP-клиенте: Claude Code, Claude Desktop, Cursor и другие.
Вход из диалога. Ассистент даёт ссылку, вы входите своим аккаунтом Яндекса и присылаете код — без регистрации приложения, заявки на доступ к API и ручного токена.
68 инструментов, из них 27 только читают. Кампании и стратегии, группы, объявления и модерация, ключевые фразы и ставки, прогноз по фразам без кампании, минус-фразы и общие наборы, запрещённые площадки и IP, быстрые ссылки, уточнения, изображения, визитки, корректировки ставок, ретаргетинг, аудиторные и динамические цели, фиды, расписание показов, статистика, поисковые запросы, баланс и справочники.
Деньги — в рублях, на вводе и на выводе; в микроединицы API сервер переводит сам. Поддержан агентский режим (
Client-Login).ID — строками (
"1915016273214320641"): 64-битные идентификаторы Директа не помещаются в число JavaScript и молча теряют точность.Реклама боевая. Тестовой среды у Директа больше нет — какие инструменты тратят деньги и что удаляют необратимо, перечислено в разделе Что меняет данные.
Телеметрии нет. Сервер не отправляет никуда ничего, кроме запросов к API Яндекса.
Содержание
Что можно делать — примеры запросов обычным текстом
Установка — Claude Code, Claude Desktop, Cursor, из исходников
Подключение к Директу — вход из диалога или свой токен
Что меняет данные — что тратит бюджет и что необратимо
Инструменты — полный список с описаниями
Разработка — сборка, тесты, архитектура
Related MCP server: Yandex MCP Server
Что можно делать
Обычным текстом в чате — инструменты сервер подставляет сам:
Собери кампанию «Летняя распродажа»: бюджет 5000 ₽/день, старт 1 мая, показы будни 9–21
Добавь минус-фразы «бесплатно» и «скачать» в кампанию 12345, не затерев остальные
Посмотри поисковые запросы за месяц и предложи, что заминусовать
Подними ставку до 25 ₽ там, где CTR выше 8%, а показов меньше сотни
Что изменилось в кампаниях со вчера?
Покажи расход по кампаниям за неделю и баланс аккаунта
Найди код региона для НовосибирскаПолный список — в разделе Инструменты.
Установка
Понадобится Node.js не ниже 22. Отдельно ставить сервер не нужно: клиент сам запускает пакет через npx и общается с ним по stdio. Токен заранее не нужен — вход делается из диалога (как).
Claude Code
claude mcp add yandex-direct -- npx -y yandex-direct-mcp-plusClaude Desktop, Cursor и другие клиенты
В конфиг MCP-серверов клиента (claude_desktop_config.json, .cursor/mcp.json и т. п.) добавляется запись:
{
"mcpServers": {
"yandex-direct": {
"command": "npx",
"args": ["-y", "yandex-direct-mcp-plus"]
}
}
}Агентскому аккаунту в env нужен ещё YANDEX_DIRECT_LOGIN — см. Подключение к Директу.
Из исходников
git clone git@github.com:Pavelsiba/yandex-direct-mcp-plus.git
cd yandex-direct-mcp-plus
npm ci
npm run buildВ конфиге клиента вместо npx тогда стоит "command": "node", а в args — абсолютный путь к dist/app/index.js.
Удалённый сервер
Тот же сервер можно поднять по HTTP на своей машине — в Docker, за nginx с HTTPS — и подключаться к нему по адресу из claude.ai, с телефона или из Claude Desktop без установки Node. Вход закрыт секретом. Настройка — docs/deploy.md.
Подключение к Директу
Вход из диалога
Достаточно попросить ассистента подключиться к Директу. Он вызовет start_login и покажет ссылку на вход в Яндекс — входите аккаунтом, у которого есть доступ к нужному кабинету. Яндекс покажет код подтверждения; его нужно прислать в чат, и ассистент передаст его в finish_login.
Вход идёт через приложение этого сервера с одобренным доступом к API, поэтому своё приложение и заявка не нужны. Баллы API тратит ваш аккаунт, как и при собственном токене.
Код одноразовый и без ключа, который хранится только в запущенном сервере, бесполезен — присылать его в чат безопасно.
Токен сохраняется в
~/.config/yd-mcp/credentials.json(или$XDG_CONFIG_HOME/yd-mcp/), файл доступен только владельцу. Срок продлевается сам.Кто подключён и до когда —
auth_status. Выйти —logout: он удаляет сохранённый вход. Отозвать доступ совсем — в Яндекс ID, раздел «Устройства, сервисы и пароли».
Свой токен
Если токен уже есть — например, для CI или удалённого сервера, — его можно передать в окружении, и тогда он главнее входа из диалога. Токен выпускается для приложения, зарегистрированного в Яндекс OAuth, с доступом к API Директа: регистрация приложения и получение токена, доступ запрашивается в интерфейсе Директа — заявку рассматривают от часа до нескольких суток.
claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y yandex-direct-mcp-plusВ JSON-конфиге клиента — "env": { "YANDEX_DIRECT_TOKEN": "ваш_токен" } рядом с args.
Переменные окружения
YANDEX_DIRECT_TOKEN— OAuth-токен. Необязателен: без него сервер берёт сохранённый вход из диалога, а если нет и его — инструмент вернёт ошибку с подсказкой, как подключиться.YANDEX_DIRECT_LOGIN— логин рекламодателя, уходит в заголовокClient-Login. Нужен только агентскому аккаунту: без него запросы идут в собственный кабинет агентства, а не в кабинет клиента.
Что меняет данные
Тестовой среды у Яндекс.Директа больше нет: песочница отключена с июля 2026, и любой вызов идёт по боевому аккаунту. Отлаживать сценарии приходится на отдельной кампании, оставленной черновиком, — показов она не даёт и потому не тратит бюджет, пока не пройдёт модерацию и не будет включена.
Граница проходит не по «чтение или запись», а по скорости, с которой действие превращается в деньги.
Только читают все list_*, get_* и справочники. Вызвать их безопасно всегда.
Тратят бюджет или запускают показы:
Инструмент | Чем именно |
|
|
|
|
| Отправляет объявления на модерацию, после неё начнутся показы |
| Меняет дневной бюджет |
| Меняет ставки, то есть цену клика |
| Пересчитывает ставки под цену нужного объёма трафика — до потолка, если он задан |
| Меняет стратегию — переписывает всю экономику кампании |
| Заводит корректировку: +N% к ставке на срезе аудитории |
| Меняет коэффициент существующей корректировки |
Удаляют необратимо — эти инструменты помечены аннотацией DESTRUCTIVE, и хороший MCP-клиент спросит подтверждение перед вызовом:
manage_campaigns (delete), manage_ads (delete), manage_keywords (delete), delete_ad_groups, delete_ad_extensions, delete_sitelinks, delete_vcards, delete_bid_adjustments, delete_retargeting_lists, manage_ad_images (delete), manage_dynamic_targets (delete), set_audience_targets (delete), manage_negative_keyword_shared_sets (delete).
Сюда же — set_campaign_negative_keywords и set_ad_group_negative_keywords в режиме replace: он затирает прежний список минус-фраз целиком. Именно поэтому у них нет режима по умолчанию — mode приходится назвать явно. Так же устроен set_priority_goals: replace и remove убирают цели стратегии, а любая смена целей перезапускает её обучение.
Остальные инструменты создают и правят объекты. Пока кампания не прошла модерацию и не включена, показов по ней нет и бюджет не расходуется.
Чего API не умеет. Смарт-баннеры и динамические объявления Директ через API не создаёт с 22 мая 2026, визитки — тоже: в WSDL методы есть, боевой API отвечает ошибкой 3500. Такие объекты заводятся в интерфейсе Директа, а дальше сервер с ними работает: кампании читает и правит, визитки читает и удаляет. Единую перфоманс-кампанию сервер пока только читает.
Инструменты
В таблицах — первое предложение описания, которое сервер отдаёт модели; таблицы собираются из кода, поэтому список всегда полный.
Подключение
Инструмент | Описание |
| Первый шаг входа из диалога, без ручного токена: возвращает ссылку на вход в Яндекс. |
| Второй шаг входа: меняет код подтверждения от пользователя на токен и сохраняет его на этом компьютере. |
| Откуда сервер берёт токен (переменная окружения, вход из диалога или запрос) и до когда он действует. |
| Удаляет сохранённый вход из диалога с этого компьютера. |
Кампании и стратегии
Инструмент | Описание |
| Список рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу. |
| Детальная информация о кампании по ID: бюджет (руб), статус и пояснение к нему, даты, статистика, UTM-разметка, цели и их ценность (PriorityGoals), счётчики Метрики, модель атрибуции и прочие настройки. |
| Создать новую текстово-графическую кампанию. |
| Обновить кампанию: название, бюджет (руб), UTM-разметку, счётчики Метрики, модель атрибуции и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE). |
| Запустить, остановить, архивировать, разархивировать или удалить кампании. |
| Получить текущую стратегию показов текстово-графической кампании вместе с целями (PriorityGoals), счётчиками и моделью атрибуции. |
| Изменить стратегию текстово-графической кампании: ручная, максимум кликов, средняя цена клика или конверсии, оплата за конверсию. |
| Задать цели стратегии кампании (PriorityGoals) и их ценность в рублях — по ним автостратегия оптимизирует ставки, в том числе «максимум конверсий» со служебным GoalId 13. |
| Временной таргетинг кампании: часовой пояс, часы показов по дням недели, почасовые коэффициенты и настройка праздников. |
| Задать расписание показов кампании: дни, часы, почасовые коэффициенты, праздники и часовой пояс. |
Группы объявлений
Инструмент | Описание |
| Группы объявлений выбранных кампаний: названия, регионы, статусы. |
| Создать группу объявлений в кампании с таргетингом по регионам (см. get_regions). |
| Изменить группу объявлений без пересоздания: название, регионы показа (полный список, заменяет прежний) и/или UTM-разметку ссылок. |
| Удалить группы объявлений по их ID. |
Объявления
Инструмент | Описание |
| Объявления: все заголовки и тексты, ссылки, статусы, тип и подтип объявления, привязанные сайтлинки, изображения и видео. |
| Создать комбинаторное объявление: от 1 до 7 заголовков (≤56 символов), от 1 до 3 текстов (≤81) и ссылка; варианты показа Директ собирает из них сам. |
| Обновить комбинаторное объявление: заголовки, тексты, ссылка. |
| Действие над объявлениями: suspend/resume/archive/unarchive/moderate/delete. |
| Отправить выбранные объявления на модерацию. |
Ключевые фразы и ставки
Инструмент | Описание |
| Ключевые фразы в группах объявлений: фразы, ставки (руб), статусы. |
| Добавить ключевые фразы в группу объявлений. |
| Изменить текст ключевых фраз, подстановочные переменные {param1}/{param2} и настройки автотаргетинга. |
| Действие над ключевыми фразами: suspend/resume/delete. |
| Установить фиксированные ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний и включить или выключить автоставку автотаргетинга. |
| Назначить ставки по правилу вместо суммы: на поиске — под желаемый объём трафика (5–100%), в сетях — под долю аудитории, с надбавкой в процентах и потолком в рублях. |
| Сколько стоит трафик по фразам: текущие ставки и торги на поиске и в сетях. |
| Прогноз трафика и цены клика по списку фраз без кампании — для подбора семантики. |
Минус-фразы
Инструмент | Описание |
| Получить текущие минус-фразы кампаний по их ID. |
| Минус-фразы на уровне кампании. |
| Минус-фразы на уровне группы объявлений. |
| Получить общие наборы минус-фраз аккаунта. |
| Создать, изменить или удалить общие наборы минус-фраз аккаунта. |
| Заменить привязки общих наборов минус-фраз у кампаний и/или групп объявлений. |
Запреты показа
Инструмент | Описание |
| Площадки РСЯ и приложения, на которых кампания не показывается (до 1000). |
| IP-адреса, которым кампания не показывается (до 25, одиночные публичные IPv4). |
Ассеты объявления
Инструмент | Описание |
| Получить все или выбранные наборы быстрых ссылок. |
| Создать новый набор из 1–8 быстрых ссылок. |
| Удалить наборы быстрых ссылок по ID. |
| Получить уточнения (callouts) с их статусами и текстом. |
| Создать уточнения (callouts), каждый текст до 25 символов. |
| Удалить уточнения по ID. |
| Загрузить, получить или удалить изображения объявлений (AdImages). |
| Получить виртуальные визитки по ID или найти их через объявления выбранных кампаний. |
| Удалить визитки по ID; удаление необратимо. |
Таргетинг и корректировки
Инструмент | Описание |
| Получить условия нацеливания на аудиторию по ID кампании, группы, ретаргетинга или интереса. |
| Добавить, остановить, возобновить, удалить аудиторные цели или изменить их ставки. |
| Получить условия нацеливания динамических текстовых объявлений. |
| Создать, изменить ставки, остановить, возобновить или удалить динамические цели. |
| Получить условия ретаргетинга и подбора аудитории с правилами и областью применения. |
| Создать условие ретаргетинга из целей Метрики, сегментов или интересов. |
| Изменить название, описание и правила условий ретаргетинга. |
| Удалить условия ретаргетинга и подбора аудитории по ID; удаление необратимо. |
| Получить корректировки ставок кампании или группы: устройства, пол и возраст, аудитории, регионы, платёжеспособность, размещение. |
| Создать корректировки ставок на кампаниях или группах. |
| Изменить коэффициенты существующих корректировок по их ID. |
| Удалить корректировки по их ID. |
Отчёты
Инструмент | Описание |
| Статистика за период по кампаниям, группам, объявлениям, условиям показа или аккаунту: показы, клики, расход (руб), CTR, CPC; с goals — конверсии и CPA по целям Метрики (ReportService, TSV). |
| Отчёт по фактическим поисковым запросам для анализа и добавления минус-фраз. |
Аккаунт и справочники
Инструмент | Описание |
| Баланс и финансовая информация аккаунта (Amount, Currency) через Live API v4. |
| Получить доступные профили организаций из Яндекс Бизнеса. |
| Проверить изменения кампаний, групп и объявлений начиная с указанного времени, а также изменения справочников (mode=dictionaries) и текущее время сервера Директа. |
| Получить товарные фиды, их источники, статусы обработки и связанные кампании. |
| Справочник кодов регионов (GeoRegions) для таргетинга. |
| Справочник часовых поясов (TimeZones) для set_time_targeting и create_campaign. |
Разработка
npm ci # зависимости строго по lock-файлу
npm run dev # сервер из исходников, без сборки
npm run build # dist/ — то, что запускает MCP-клиент
npm test # юнит-тесты, сеть подменена
npm run lint # Biome: формат и линт
npm run typecheck # типы в src, тестах и конфигах
npm run lint:md # markdownlint: README и docs по правилам форматтера IDE
npm run lint:dead # knip: неиспользуемый код и зависимости
npm run lint:workflows # actionlint + zizmor: корректность и безопасность workflow
npm run lint:secrets # gitleaks по всей истории
npm run docs:tools # таблицы инструментов в README из реестраgitleaks, actionlint, zizmor и shellcheck — не npm-пакеты; без них хуки pre-commit не пропустят коммит. На Windows:
winget install -e --id Gitleaks.Gitleaks
winget install -e --id rhysd.actionlint
winget install -e --id zizmor.zizmor
winget install -e --id koalaman.shellcheckБез режима разработчика winget не создаёт ссылки в %LOCALAPPDATA%\Microsoft\WinGet\Links,
и каталоги пакетов из %LOCALAPPDATA%\Microsoft\WinGet\Packages придётся добавить в PATH.
Таблицы инструментов выше руками не правятся: после смены описания инструмента — npm run docs:tools, иначе юнит-тест покажет расхождение.
Сетевые тесты (npm run test:int) идут по боевому аккаунту и пишут только в кампанию-полигон, оставленную черновиком: её ID задаётся переменной YANDEX_DIRECT_POLYGON_CAMPAIGN_ID. Без переменной они пропускаются.
Код разложен по слоям app → tools → shared; инструмент — это каталог
src/tools/<домен>/ с schema.ts, handler.ts и tool.ts. Подробности —
в docs/architecture.md.
Происхождение и благодарности
Проект начат на коде theYahia/yandex-direct-mcp под лицензией MIT. Расширение с 20 до 48 инструментов и перевод ID на строки — работа Maxim (DrSeedon), PR #7; в npm эта версия не публиковалась. Дальше проект развивается самостоятельно и апстрим не отслеживает.
История изменений с отделения от апстрима — в CHANGELOG.md.
Лицензия
Copyright © 2026 Pavelsiba. GNU AGPL-3.0-only.
Пользоваться сервером, изменять его и разворачивать у себя можно свободно, в том числе в работе с клиентами. Кто предоставляет изменённый сервер другим людям по сети, обязан дать им исходный код своей версии (раздел 13 лицензии).
Версии до 1.7.0 включительно вышли под MIT и под ней остаются.
Pull request'ы принимаются вместе с передачей прав на вклад автору проекта (CLA) — без этого проект не сможет распоряжаться своим кодом. Перед большой правкой лучше завести issue.
Available Tools
68 toolsadd_ad_extensionsСоздать уточненияC
Создать уточнения (callouts), каждый текст до 25 символов.
Inputs: callouts (required).
add_bid_adjustmentsСоздать корректировки ставокB
Создать корректировки ставок на кампаниях или группах. Коэффициент — проценты от ставки: 100 ничего не меняет, 0 отключает показы среза.
Inputs: adjustments (required), ad_group_ids, campaign_ids.
add_keywordsДобавить ключевые словаC
Добавить ключевые фразы в группу объявлений.
Inputs: keywords (required), ad_group_id (required).
add_retargeting_listСоздать список ретаргетингаC
Создать условие ретаргетинга из целей Метрики, сегментов или интересов.
Inputs: name (required), rules (required), type, description.
auth_statusПодключение к ДиректуARead-only
Откуда сервер берёт токен (переменная окружения, вход из диалога или запрос) и до когда он действует. В сеть не ходит, баллов не тратит.
Inputs: no named parameters.
create_ad_groupСоздать группуB
Создать группу объявлений в кампании с таргетингом по регионам (см. get_regions).
Inputs: name (required), region_ids (required), campaign_id (required).
create_campaignСоздать кампаниюA
Создать новую текстово-графическую кампанию. Бюджет в рублях; счётчики Метрики и модель атрибуции задаются сразу. Смарт-баннеры и динамические объявления Директ через API не создаёт с 22.05.2026, единую перфоманс-кампанию этот сервер пока не создаёт: такие кампании заводятся в интерфейсе Директа, дальше их можно читать и править здесь. ⚠️ Тестовой среды у Директа нет: кампания создаётся в боевом аккаунте. Деньги она начнёт тратить после модерации и включения, поэтому созданную для проверки оставляйте черновиком.
Inputs: name (required), start_date (required), type, time_zone, +6 more.
create_responsive_adСоздать комбинаторное объявлениеA
Создать комбинаторное объявление: от 1 до 7 заголовков (≤56 символов), от 1 до 3 текстов (≤81) и ссылка; варианты показа Директ собирает из них сам. Текстовые объявления через API больше не создаются — Директ заводит их комбинаторными. В группе — не больше 3 неархивных комбинаторных объявлений.
Inputs: href (required), texts (required), titles (required), ad_group_id (required).
delete_ad_extensionsУдалить уточненияCDestructive
Удалить уточнения по ID. ⚠️ Необратимо.
Inputs: ad_extension_ids (required).
delete_ad_groupsУдалить группыADestructive
Удалить группы объявлений по их ID. ⚠️ Необратимо.
Inputs: ad_group_ids (required).
delete_bid_adjustmentsУдалить корректировки ставокADestructive
Удалить корректировки по их ID. Ставка среза возвращается к базовой; отменить удаление нельзя.
Inputs: adjustment_ids (required).
delete_retargeting_listsУдалить списки ретаргетингаADestructive
Удалить условия ретаргетинга и подбора аудитории по ID; удаление необратимо. Отказ по отдельному условию приходит строкой ❌ в ответе, остальные при этом удалены.
Inputs: retargeting_list_ids (required).
delete_sitelinksУдалить быстрые ссылкиADestructive
Удалить наборы быстрых ссылок по ID. Набор, привязанный к объявлению, Директ удалить не даст.
Inputs: sitelink_set_ids (required).
delete_vcardsУдалить визиткиADestructive
Удалить визитки по ID; удаление необратимо. Отказ по отдельной визитке приходит строкой ❌ в ответе, остальные при этом удалены.
Inputs: vcard_ids (required).
finish_loginВход в Яндекс.Директ: кодA
Второй шаг входа: меняет код подтверждения от пользователя на токен и сохраняет его на этом компьютере. Токен в ответ не попадает.
Inputs: code (required).
get_account_balanceБаланс аккаунтаBRead-only
Баланс и финансовая информация аккаунта (Amount, Currency) через Live API v4.
Inputs: logins.
get_bid_adjustmentsКорректировки ставокARead-only
Получить корректировки ставок кампании или группы: устройства, пол и возраст, аудитории, регионы, платёжеспособность, размещение.
Inputs: levels (required), limit, types, offset, +3 more.
get_campaignКампания по IDARead-only
Детальная информация о кампании по ID: бюджет (руб), статус и пояснение к нему, даты, статистика, UTM-разметка, цели и их ценность (PriorityGoals), счётчики Метрики, модель атрибуции и прочие настройки. Реальные ID целей — PriorityGoals.Items[].GoalId; GoalId 13 в стратегии — служебное «ключевые цели», то есть оптимизация по этим PriorityGoals. Пустой ответ по ID из веб-интерфейса не значит, что номер неверный: кампании «Баннер на поиске» (MCBANNER) API не отдаёт, по ID они приходят пустыми.
Inputs: campaign_id (required).
get_campaign_negative_keywordsПолучить минус-фразы кампанийCRead-only
Получить текущие минус-фразы кампаний по их ID.
Inputs: campaign_ids (required).
get_changesИзменения объектовBRead-only
Проверить изменения кампаний, групп и объявлений начиная с указанного времени, а также изменения справочников (mode=dictionaries) и текущее время сервера Директа.
Inputs: mode (required), ad_ids, timestamp, field_names, +2 more.
get_keyword_auctionАукцион по фразамARead-only
Сколько стоит трафик по фразам: текущие ставки и торги на поиске и в сетях. Всё в рублях. На поиске Search.AuctionBids — для каждого объёма трафика фразы TrafficVolume Bid — сколько поставить и Price — сколько спишется за клик. Объём трафика — индекс кликабельности места показа: 100 — первое место премиум-показов, следующие места — 85, 75, 65; выше 100 — места кликабельнее первого, например показ в расширенном формате. В сетях Network.Coverage — ставка под долю аудитории (Probability, %). Отбор по одному уровню: фразы, группы или кампании. Торги видны при любой стратегии, но ставкой управляются только при ручной: на автостратегии (WB_*, AVERAGE_CPA, AVERAGE_CPC и прочие) ставки назначает Директ. Стратегию кампании проверяйте через get_strategy.
Inputs: limit, offset, placements, keyword_ids, +2 more.
get_keyword_forecastПрогноз по фразамARead-only
Прогноз трафика и цены клика по списку фраз без кампании — для подбора семантики. Отдаёт таблицу TSV, строка на фразу: Shows — показы за прошедший месяц; Clicks, CTR — нижний блок без первого места; FirstPlaceClicks, FirstPlaceCTR — первое место; PremiumClicks, PremiumCTR — спецразмещение; Min и Max — цена клика за вход в нижний блок и за первое место в нём; PremiumMin и PremiumMax — то же в спецразмещении. С auction_bids — колонки «P<блок><место> Bid» (ставка за позицию) и «… Price» (списываемая цена): P11–P14 — спецразмещение, P21–P24 — нижний блок. Строка «Итого» — суммы по всем фразам, где Min/Max/PremiumMin уже бюджет за месяц, а не цена клика. Деньги — в валюте из currency. Ждёт готовности отчёта до 90 секунд.
Inputs: phrases (required), currency, region_ids, auction_bids, +1 more.
get_regionsСправочник регионовBRead-only
Справочник кодов регионов (GeoRegions) для таргетинга. Фильтр по названию, 225 = Россия. with_parents=true показывает вложенность и различает одноимённые города.
Inputs: limit, search, with_parents.
get_search_queriesПоисковые запросыBRead-only
Отчёт по фактическим поисковым запросам для анализа и добавления минус-фраз.
Inputs: date_to (required), date_from (required), campaign_ids (required), goals, +5 more.
get_statisticsСтатистикаBRead-only
Статистика за период по кампаниям, группам, объявлениям, условиям показа или аккаунту: показы, клики, расход (руб), CTR, CPC; с goals — конверсии и CPA по целям Метрики (ReportService, TSV).
Inputs: date_to (required), date_from (required), goals, limit, +6 more.
get_strategyСтратегия кампанииARead-only
Получить текущую стратегию показов текстово-графической кампании вместе с целями (PriorityGoals), счётчиками и моделью атрибуции. Реальные ID целей Метрики, по которым работает кампания, — TextCampaign.PriorityGoals.Items[].GoalId (рядом их ценность Value в рублях), счётчики — CounterIds. GoalId внутри BiddingStrategy бывает служебным: 13 — «оптимизировать по ключевым целям», то есть по тем же PriorityGoals; 12 — «Вовлечённые сессии». Названий целей API Директа не отдаёт — они есть только в Метрике.
Inputs: campaign_id (required).
get_time_targetingРасписание показов кампанииBRead-only
Временной таргетинг кампании: часовой пояс, часы показов по дням недели, почасовые коэффициенты и настройка праздников.
Inputs: campaign_id (required).
link_negative_keyword_setsПривязать общие минус-фразыAIdempotent
Заменить привязки общих наборов минус-фраз у кампаний и/или групп объявлений. Привязка к кампании действует на все её группы. Пустой set_ids очищает привязки.
Inputs: set_ids (required), ad_group_ids, campaign_ids.
list_ad_extensionsСписок уточненийBRead-only
Получить уточнения (callouts) с их статусами и текстом.
Inputs: limit, offset, states, statuses, +1 more.
list_ad_groupsСписок группBRead-only
Группы объявлений выбранных кампаний: названия, регионы, статусы. По умолчанию возвращается узкий набор полей; нужны другие (NegativeKeywords, NegativeKeywordSharedSetIds, TrackingParams, ServingStatus и прочие из AdGroupFieldEnum) — перечислите их в fields.
Inputs: campaign_ids (required), limit, fields, offset.
list_adsСписок объявленийARead-only
Объявления: все заголовки и тексты, ссылки, статусы, тип и подтип объявления, привязанные сайтлинки, изображения и видео. Текстовые объявления Директ отдаёт комбинаторными (RESPONSIVE_AD). Причина отказа модерации приходит в StatusClarification. Отбор по ID объявлений, группам или кампаниям — хотя бы одно из трёх; сужается состоянием, статусом и типом. Без фильтра по состоянию архивные приходят наравне с активными. Список может быть неполным: объявления, тексты которых генерирует нейросеть Яндекса, через API недоступны и в выдачу не попадают, а по ответу это никак не видно. Поэтому «в группе только эти объявления» из ответа не следует — ни из пустого, ни из непустого; для полноты картины сверяйтесь с интерфейсом Директа.
Inputs: limit, types, ad_ids, offset, +4 more.
list_audience_targetsАудиторные целиCRead-only
Получить условия нацеливания на аудиторию по ID кампании, группы, ретаргетинга или интереса.
Inputs: limit, offset, states, ad_group_ids, +4 more.
list_businessesПрофили организацийBRead-only
Получить доступные профили организаций из Яндекс Бизнеса.
Inputs: limit, offset, business_ids.
list_campaignsСписок кампанийARead-only
Список рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу. Бюджеты — в рублях. По умолчанию возвращается узкий набор полей; нужны другие (Funds, TimeZone, NegativeKeywords и прочие из CampaignFieldEnum) — перечислите их в fields. Кампаний «Баннер на поиске» (MCBANNER) API не отдаёт вовсе: их нет в списке, и это граница API, а не ошибка логина или фильтра — такие кампании видны только в веб-интерфейсе.
Inputs: limit, types, fields, offset, +1 more.
list_dynamic_targetsДинамические целиCRead-only
Получить условия нацеливания динамических текстовых объявлений.
Inputs: limit, offset, states, ad_group_ids, +2 more.
list_feedsСписок фидовBRead-only
Получить товарные фиды, их источники, статусы обработки и связанные кампании.
Inputs: limit, offset, feed_ids.
list_keywordsСписок ключевых словARead-only
Ключевые фразы в группах объявлений: фразы, ставки (руб), статусы. По умолчанию возвращается узкий набор полей; нужны другие (StatisticsSearch, StatisticsNetwork, Productivity, ServingStatus и прочие из KeywordFieldEnum) — перечислите их в fields. Автотаргетинг — спецфраза ---autotargeting в той же группе; его категории запросов — с autotargeting: true.
Inputs: ad_group_ids (required), limit, fields, offset, +1 more.
list_retargeting_listsСписки ретаргетингаBRead-only
Получить условия ретаргетинга и подбора аудитории с правилами и областью применения.
Inputs: limit, types, offset, retargeting_list_ids.
list_sitelinksСписок быстрых ссылокCRead-only
Получить все или выбранные наборы быстрых ссылок.
Inputs: limit, offset, sitelink_set_ids.
list_time_zonesСправочник часовых поясовBRead-only
Справочник часовых поясов (TimeZones) для set_time_targeting и create_campaign. Фильтр по коду или названию.
Inputs: limit, search.
list_vcardsСписок визитокARead-only
Получить виртуальные визитки по ID или найти их через объявления выбранных кампаний. Создавать визитки Директ через API не даёт — новая визитка заводится в интерфейсе Директа.
Inputs: limit, offset, vcard_ids, campaign_ids.
logoutВыход из ДиректаADestructive
Удаляет сохранённый вход из диалога с этого компьютера. Переменную YANDEX_DIRECT_TOKEN не трогает; доступ приложения отзывается в Яндекс ID.
Inputs: no named parameters.
manage_ad_imagesУправление изображениямиBDestructive
Загрузить, получить или удалить изображения объявлений (AdImages). Для add данные передаются в base64.
Inputs: action (required), limit, images, offset, +2 more.
manage_adsУправление объявлениямиBDestructive
Действие над объявлениями: suspend/resume/archive/unarchive/moderate/delete. ⚠️ delete необратимо.
Inputs: action (required), ad_ids (required).
manage_campaignsУправление кампаниямиADestructive
Запустить, остановить, архивировать, разархивировать или удалить кампании. ⚠️ delete необратимо и недоступен кампании с накопленной статистикой — такую только архивировать.
Inputs: action (required), campaign_ids (required).
manage_dynamic_targetsУправление динамическими целямиCDestructive
Создать, изменить ставки, остановить, возобновить или удалить динамические цели.
Inputs: action (required), bids, targets, dynamic_target_ids.
manage_keywordsУправление ключевыми словамиBDestructive
Действие над ключевыми фразами: suspend/resume/delete. ⚠️ delete необратимо.
Inputs: action (required), keyword_ids (required).
moderate_adsОтправить объявления на модерациюCIdempotent
Отправить выбранные объявления на модерацию.
Inputs: ad_ids (required).
set_ad_group_negative_keywordsМинус-фразы группыADestructive
Минус-фразы на уровне группы объявлений. Режим mode обязателен: replace заменяет список целиком (прежние фразы теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Чтобы добавить фразу к существующим, нужен add: replace с одной фразой сотрёт остальные.
Inputs: mode (required), ad_group_id (required), negative_keywords (required).
set_audience_targetsУправление аудиторными целямиCDestructive
Добавить, остановить, возобновить, удалить аудиторные цели или изменить их ставки.
Inputs: action (required), bids, targets, audience_target_ids.
set_auto_keyword_bidsСтавки под объём трафикаA
Назначить ставки по правилу вместо суммы: на поиске — под желаемый объём трафика (5–100%), в сетях — под долю аудитории, с надбавкой в процентах и потолком в рублях. Директ рассчитает ставку по текущим торгам один раз, следить за ними дальше не будет; назначенные ставки покажет get_keyword_auction. Только при ручной стратегии на соответствующей площадке — иначе Директ отклонит вызов. Отдельному автотаргетингу правило не задаётся: используйте ad_group_ids или campaign_ids.
Inputs: search, network, keyword_ids, ad_group_ids, +1 more.
set_bid_adjustmentsИзменить корректировки ставокBIdempotent
Изменить коэффициенты существующих корректировок по их ID.
Inputs: adjustments (required).
set_campaign_blocked_ipsЗапрещённые IP кампанииADestructive
IP-адреса, которым кампания не показывается (до 25, одиночные публичные IPv4). Режим mode обязателен: replace заменяет список целиком (прежние адреса теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — add и remove читают текущий список сами. Текущий список есть в get_campaign.
Inputs: ips (required), mode (required), campaign_id (required).
set_campaign_excluded_sitesЗапрещённые площадки кампанииADestructive
Площадки РСЯ и приложения, на которых кампания не показывается (до 1000). Режим mode обязателен: replace заменяет список целиком (прежние площадки теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Текущий список есть в get_campaign. Чтобы добавить площадку к существующим, нужен add: replace с одной площадкой сотрёт остальные.
Inputs: mode (required), sites (required), campaign_id (required).
set_campaign_negative_keywordsМинус-фразы кампанииADestructive
Минус-фразы на уровне кампании. Режим mode обязателен: replace заменяет список целиком (прежние фразы теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Чтобы добавить фразу к существующим, нужен add: replace с одной фразой сотрёт остальные.
Inputs: mode (required), campaign_id (required), negative_keywords (required).
set_keyword_bidsУстановить ставкиAIdempotent
Установить фиксированные ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний и включить или выключить автоставку автотаргетинга. Ставки применяются только при ручной стратегии: на автостратегии их назначает Директ, и ставка, не подходящая стратегии, не применится. Сначала get_strategy, затем get_keyword_auction — сколько стоит нужный объём трафика; ставку под объём ставит set_auto_keyword_bids.
Inputs: search_bid, keyword_ids, network_bid, ad_group_ids, +2 more.
set_priority_goalsЦели стратегииADestructive
Задать цели стратегии кампании (PriorityGoals) и их ценность в рублях — по ним автостратегия оптимизирует ставки, в том числе «максимум конверсий» со служебным GoalId 13. Режим mode обязателен: add добавляет цели или меняет ценность уже заданных, remove убирает названные, replace заменяет список целиком (пустой массив очищает). Текущий список сервер читает сам. Чтобы добавить цель к существующим, нужен add: replace с одной целью сотрёт остальные. ⚠️ Смена целей перезапускает обучение стратегии. Поддерживаются текстово-графические, динамические, смарт и единые перфоманс-кампании; ID целей — из Метрики.
Inputs: mode (required), goals (required), campaign_id (required).
set_sitelinksСоздать быстрые ссылкиB
Создать новый набор из 1–8 быстрых ссылок. Возвращает ID набора для привязки к объявлению.
Inputs: sitelinks (required).
set_strategyИзменить стратегию кампанииBIdempotent
Изменить стратегию текстово-графической кампании: ручная, максимум кликов, средняя цена клика или конверсии, оплата за конверсию. Цены — в рублях, цель Метрики — goal_id.
Inputs: campaign_id (required), search_type (required), network_type (required), goal_id, +6 more.
set_time_targetingЗадать расписание показовAIdempotent
Задать расписание показов кампании: дни, часы, почасовые коэффициенты, праздники и часовой пояс. ⚠️ Расписание заменяется целиком: часы вне переданных правил показов не получат.
Inputs: schedule (required), campaign_id (required), time_zone, holiday_end_hour, +4 more.
start_loginВход в Яндекс.Директ: ссылкаAIdempotent
Первый шаг входа из диалога, без ручного токена: возвращает ссылку на вход в Яндекс. Ссылку показать пользователю, код со страницы Яндекса передать в finish_login. Повторный вызов делает прежнюю ссылку недействительной.
Inputs: no named parameters.
update_ad_groupОбновить группуAIdempotent
Изменить группу объявлений без пересоздания: название, регионы показа (полный список, заменяет прежний) и/или UTM-разметку ссылок. Минус-фразы группы — set_ad_group_negative_keywords, наборы — link_negative_keyword_sets, автотаргетинг — update_keywords.
Inputs: ad_group_id (required), name, region_ids, tracking_params.
update_campaignОбновить кампаниюAIdempotent
Обновить кампанию: название, бюджет (руб), UTM-разметку, счётчики Метрики, модель атрибуции и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE). Разметка действует на ссылки всех объявлений кампании. Список счётчиков заменяется целиком.
Inputs: campaign_id (required), name, status, counter_ids, +3 more.
update_keywordsИзменить ключевые словаA
Изменить текст ключевых фраз, подстановочные переменные {param1}/{param2} и настройки автотаргетинга. Правка текста может привести к появлению фразы с новым ID или к её удалению как дубликата — сверьтесь с list_keywords после вызова. Автотаргетинг — фраза ---autotargeting: её ID берётся из list_keywords, категории запросов и брендов задаются autotargeting_categories / autotargeting_brand_options. Выключить автотаргетинг целиком — manage_keywords с suspend (delete Директ отбивает). Ставки меняет set_keyword_bids, статус — manage_keywords.
Inputs: keywords (required).
update_responsive_adОбновить комбинаторное объявлениеAIdempotent
Обновить комбинаторное объявление: заголовки, тексты, ссылка. Набор заголовков или текстов заменяется целиком — передайте полный, вместе с теми, что не меняются; текущие показывает list_ads. Изменённое объявление уходит на модерацию.
Inputs: ad_id (required), href, texts, titles.
update_retargeting_listsИзменить списки ретаргетингаA
Изменить название, описание и правила условий ретаргетинга. Переданные правила заменяют прежние целиком: сначала прочитайте условие через list_retargeting_lists.
Inputs: retargeting_lists (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 68 tools
Many tools target distinct resources and actions, but there is real overlap: update_campaign also handles SUSPEND/RESUME/ARCHIVE while manage_campaigns covers launch/stop/archive/unarchive/delete; manage_ads includes moderate while moderate_ads exists separately; keyword bidding is split across update_keywords, manage_keywords, set_keyword_bids, and set_auto_keyword_bids. The long descriptions usually clarify scope, but at 68 tools the boundaries require careful reading.
All names are snake_case and mostly follow verb_noun, but conventions vary: list_campaigns is plural while get_campaign is singular, create_ad_group is singular while list_ad_groups/delete_ad_groups are plural, set_sitelinks actually creates a new set, and login/auth tools use start/finish/logout/auth_status. The set is still readable, but it is not a consistently predictable pattern.
68 tools is far above the well-scoped 3-15 range and creates a very heavy selection surface for an agent. Yandex Direct is a broad domain, but this is an extreme tool count and should be split or consolidated.
Coverage is broad across campaigns, ad groups, ads, keywords, bids, strategies, targeting, negative keywords, sitelinks, vcards, images, audience/retargeting, bid adjustments, statistics, references, and authentication. Some gaps remain, such as update_ad_extensions, vcard creation that the API disallows, and limited creation support for some campaign types, but most core workflows are represented.
Maintenance
Related MCP Connectors
MCP for Yandex Direct: manage ad campaigns & analytics from Claude or ChatGPT
Review Yandex Direct reports and manage supported campaign settings in ChatGPT.
Google Ads MCP server — manage campaigns, keywords, and metrics.
Google Ads MCP: reports, search terms, negatives, budgets, campaigns. Approval on every write.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables managing Yandex Direct PPC campaigns, ad groups, ads, and keywords, plus pulling performance statistics via the Yandex Direct API v5.46641 npm10MIT
- AlicenseNot gradedqualityBmaintenanceEnables interaction with Yandex advertising and analytics APIs (Direct, Metrika, Audience, Webmaster, AdMetrica) through MCP tools, resources, and prompts for campaign management and data retrieval.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Yandex Direct advertising campaigns, ads, keywords, and reports via natural language using the Yandex Direct API v5.21MIT
- AlicenseAqualityDmaintenanceEnables AI agents to manage Yandex Direct advertising accounts via the API v5, including reports, bids, campaign management, and semantic analysis through natural language requests.4MIT