Skip to main content
Glama
yandex-direct-mcp-plus

yandex-direct-mcp-plus

by Pavelsiba

yandex-direct-mcp-plus

Ведение контекстной рекламы Яндекс.Директа из диалога с ассистентом: собрать кампанию, разобрать поисковые запросы, вычистить минус-фразы, поправить ставки и посмотреть расход — не переключаясь между разделами кабинета. Работает в любом MCP-клиенте: Claude Code, Claude Desktop, Cursor и другие.

npm License: AGPL v3 Node

  • Вход из диалога. Ассистент даёт ссылку, вы входите своим аккаунтом Яндекса и присылаете код — без регистрации приложения, заявки на доступ к API и ручного токена.

  • 68 инструментов, из них 27 только читают. Кампании и стратегии, группы, объявления и модерация, ключевые фразы и ставки, прогноз по фразам без кампании, минус-фразы и общие наборы, запрещённые площадки и IP, быстрые ссылки, уточнения, изображения, визитки, корректировки ставок, ретаргетинг, аудиторные и динамические цели, фиды, расписание показов, статистика, поисковые запросы, баланс и справочники.

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

  • ID — строками ("1915016273214320641"): 64-битные идентификаторы Директа не помещаются в число JavaScript и молча теряют точность.

  • Реклама боевая. Тестовой среды у Директа больше нет — какие инструменты тратят деньги и что удаляют необратимо, перечислено в разделе Что меняет данные.

  • Телеметрии нет. Сервер не отправляет никуда ничего, кроме запросов к API Яндекса.

Содержание

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-plus

Claude 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_* и справочники. Вызвать их безопасно всегда.

Тратят бюджет или запускают показы:

Инструмент

Чем именно

manage_campaigns

resume — включает показы остановленной кампании

manage_ads

resume и moderate — возвращает объявления в показ

moderate_ads

Отправляет объявления на модерацию, после неё начнутся показы

update_campaign

Меняет дневной бюджет

set_keyword_bids

Меняет ставки, то есть цену клика

set_auto_keyword_bids

Пересчитывает ставки под цену нужного объёма трафика — до потолка, если он задан

set_strategy

Меняет стратегию — переписывает всю экономику кампании

add_bid_adjustments

Заводит корректировку: +N% к ставке на срезе аудитории

set_bid_adjustments

Меняет коэффициент существующей корректировки

Удаляют необратимо — эти инструменты помечены аннотацией 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. Такие объекты заводятся в интерфейсе Директа, а дальше сервер с ними работает: кампании читает и правит, визитки читает и удаляет. Единую перфоманс-кампанию сервер пока только читает.

Инструменты

В таблицах — первое предложение описания, которое сервер отдаёт модели; таблицы собираются из кода, поэтому список всегда полный.

Подключение

Инструмент

Описание

start_login

Первый шаг входа из диалога, без ручного токена: возвращает ссылку на вход в Яндекс.

finish_login

Второй шаг входа: меняет код подтверждения от пользователя на токен и сохраняет его на этом компьютере.

auth_status

Откуда сервер берёт токен (переменная окружения, вход из диалога или запрос) и до когда он действует.

logout

Удаляет сохранённый вход из диалога с этого компьютера.

Кампании и стратегии

Инструмент

Описание

list_campaigns

Список рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу.

get_campaign

Детальная информация о кампании по ID: бюджет (руб), статус и пояснение к нему, даты, статистика, UTM-разметка, цели и их ценность (PriorityGoals), счётчики Метрики, модель атрибуции и прочие настройки.

create_campaign

Создать новую текстово-графическую кампанию.

update_campaign

Обновить кампанию: название, бюджет (руб), UTM-разметку, счётчики Метрики, модель атрибуции и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE).

manage_campaigns

Запустить, остановить, архивировать, разархивировать или удалить кампании.

get_strategy

Получить текущую стратегию показов текстово-графической кампании вместе с целями (PriorityGoals), счётчиками и моделью атрибуции.

set_strategy

Изменить стратегию текстово-графической кампании: ручная, максимум кликов, средняя цена клика или конверсии, оплата за конверсию.

set_priority_goals

Задать цели стратегии кампании (PriorityGoals) и их ценность в рублях — по ним автостратегия оптимизирует ставки, в том числе «максимум конверсий» со служебным GoalId 13.

get_time_targeting

Временной таргетинг кампании: часовой пояс, часы показов по дням недели, почасовые коэффициенты и настройка праздников.

set_time_targeting

Задать расписание показов кампании: дни, часы, почасовые коэффициенты, праздники и часовой пояс.

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

Инструмент

Описание

list_ad_groups

Группы объявлений выбранных кампаний: названия, регионы, статусы.

create_ad_group

Создать группу объявлений в кампании с таргетингом по регионам (см. get_regions).

update_ad_group

Изменить группу объявлений без пересоздания: название, регионы показа (полный список, заменяет прежний) и/или UTM-разметку ссылок.

delete_ad_groups

Удалить группы объявлений по их ID.

Объявления

Инструмент

Описание

list_ads

Объявления: все заголовки и тексты, ссылки, статусы, тип и подтип объявления, привязанные сайтлинки, изображения и видео.

create_responsive_ad

Создать комбинаторное объявление: от 1 до 7 заголовков (≤56 символов), от 1 до 3 текстов (≤81) и ссылка; варианты показа Директ собирает из них сам.

update_responsive_ad

Обновить комбинаторное объявление: заголовки, тексты, ссылка.

manage_ads

Действие над объявлениями: suspend/resume/archive/unarchive/moderate/delete.

moderate_ads

Отправить выбранные объявления на модерацию.

Ключевые фразы и ставки

Инструмент

Описание

list_keywords

Ключевые фразы в группах объявлений: фразы, ставки (руб), статусы.

add_keywords

Добавить ключевые фразы в группу объявлений.

update_keywords

Изменить текст ключевых фраз, подстановочные переменные {param1}/{param2} и настройки автотаргетинга.

manage_keywords

Действие над ключевыми фразами: suspend/resume/delete.

set_keyword_bids

Установить фиксированные ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний и включить или выключить автоставку автотаргетинга.

set_auto_keyword_bids

Назначить ставки по правилу вместо суммы: на поиске — под желаемый объём трафика (5–100%), в сетях — под долю аудитории, с надбавкой в процентах и потолком в рублях.

get_keyword_auction

Сколько стоит трафик по фразам: текущие ставки и торги на поиске и в сетях.

get_keyword_forecast

Прогноз трафика и цены клика по списку фраз без кампании — для подбора семантики.

Минус-фразы

Инструмент

Описание

get_campaign_negative_keywords

Получить текущие минус-фразы кампаний по их ID.

set_campaign_negative_keywords

Минус-фразы на уровне кампании.

set_ad_group_negative_keywords

Минус-фразы на уровне группы объявлений.

list_negative_keyword_shared_sets

Получить общие наборы минус-фраз аккаунта.

manage_negative_keyword_shared_sets

Создать, изменить или удалить общие наборы минус-фраз аккаунта.

link_negative_keyword_sets

Заменить привязки общих наборов минус-фраз у кампаний и/или групп объявлений.

Запреты показа

Инструмент

Описание

set_campaign_excluded_sites

Площадки РСЯ и приложения, на которых кампания не показывается (до 1000).

set_campaign_blocked_ips

IP-адреса, которым кампания не показывается (до 25, одиночные публичные IPv4).

Ассеты объявления

Инструмент

Описание

list_sitelinks

Получить все или выбранные наборы быстрых ссылок.

set_sitelinks

Создать новый набор из 1–8 быстрых ссылок.

delete_sitelinks

Удалить наборы быстрых ссылок по ID.

list_ad_extensions

Получить уточнения (callouts) с их статусами и текстом.

add_ad_extensions

Создать уточнения (callouts), каждый текст до 25 символов.

delete_ad_extensions

Удалить уточнения по ID.

manage_ad_images

Загрузить, получить или удалить изображения объявлений (AdImages).

list_vcards

Получить виртуальные визитки по ID или найти их через объявления выбранных кампаний.

delete_vcards

Удалить визитки по ID; удаление необратимо.

Таргетинг и корректировки

Инструмент

Описание

list_audience_targets

Получить условия нацеливания на аудиторию по ID кампании, группы, ретаргетинга или интереса.

set_audience_targets

Добавить, остановить, возобновить, удалить аудиторные цели или изменить их ставки.

list_dynamic_targets

Получить условия нацеливания динамических текстовых объявлений.

manage_dynamic_targets

Создать, изменить ставки, остановить, возобновить или удалить динамические цели.

list_retargeting_lists

Получить условия ретаргетинга и подбора аудитории с правилами и областью применения.

add_retargeting_list

Создать условие ретаргетинга из целей Метрики, сегментов или интересов.

update_retargeting_lists

Изменить название, описание и правила условий ретаргетинга.

delete_retargeting_lists

Удалить условия ретаргетинга и подбора аудитории по ID; удаление необратимо.

get_bid_adjustments

Получить корректировки ставок кампании или группы: устройства, пол и возраст, аудитории, регионы, платёжеспособность, размещение.

add_bid_adjustments

Создать корректировки ставок на кампаниях или группах.

set_bid_adjustments

Изменить коэффициенты существующих корректировок по их ID.

delete_bid_adjustments

Удалить корректировки по их ID.

Отчёты

Инструмент

Описание

get_statistics

Статистика за период по кампаниям, группам, объявлениям, условиям показа или аккаунту: показы, клики, расход (руб), CTR, CPC; с goals — конверсии и CPA по целям Метрики (ReportService, TSV).

get_search_queries

Отчёт по фактическим поисковым запросам для анализа и добавления минус-фраз.

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

Инструмент

Описание

get_account_balance

Баланс и финансовая информация аккаунта (Amount, Currency) через Live API v4.

list_businesses

Получить доступные профили организаций из Яндекс Бизнеса.

get_changes

Проверить изменения кампаний, групп и объявлений начиная с указанного времени, а также изменения справочников (mode=dictionaries) и текущее время сервера Директа.

list_feeds

Получить товарные фиды, их источники, статусы обработки и связанные кампании.

get_regions

Справочник кодов регионов (GeoRegions) для таргетинга.

list_time_zones

Справочник часовых поясов (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 tools
add_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Подключение к ДиректуA
Read-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Удалить уточненияC
Destructive

Удалить уточнения по ID. ⚠️ Необратимо.

Inputs: ad_extension_ids (required).

delete_ad_groupsУдалить группыA
Destructive

Удалить группы объявлений по их ID. ⚠️ Необратимо.

Inputs: ad_group_ids (required).

delete_bid_adjustmentsУдалить корректировки ставокA
Destructive

Удалить корректировки по их ID. Ставка среза возвращается к базовой; отменить удаление нельзя.

Inputs: adjustment_ids (required).

delete_retargeting_listsУдалить списки ретаргетингаA
Destructive

Удалить условия ретаргетинга и подбора аудитории по ID; удаление необратимо. Отказ по отдельному условию приходит строкой ❌ в ответе, остальные при этом удалены.

Inputs: retargeting_list_ids (required).

delete_vcardsУдалить визиткиA
Destructive

Удалить визитки по ID; удаление необратимо. Отказ по отдельной визитке приходит строкой ❌ в ответе, остальные при этом удалены.

Inputs: vcard_ids (required).

finish_loginВход в Яндекс.Директ: кодA

Второй шаг входа: меняет код подтверждения от пользователя на токен и сохраняет его на этом компьютере. Токен в ответ не попадает.

Inputs: code (required).

get_account_balanceБаланс аккаунтаB
Read-only

Баланс и финансовая информация аккаунта (Amount, Currency) через Live API v4.

Inputs: logins.

get_bid_adjustmentsКорректировки ставокA
Read-only

Получить корректировки ставок кампании или группы: устройства, пол и возраст, аудитории, регионы, платёжеспособность, размещение.

Inputs: levels (required), limit, types, offset, +3 more.

get_campaignКампания по IDA
Read-only

Детальная информация о кампании по ID: бюджет (руб), статус и пояснение к нему, даты, статистика, UTM-разметка, цели и их ценность (PriorityGoals), счётчики Метрики, модель атрибуции и прочие настройки. Реальные ID целей — PriorityGoals.Items[].GoalId; GoalId 13 в стратегии — служебное «ключевые цели», то есть оптимизация по этим PriorityGoals. Пустой ответ по ID из веб-интерфейса не значит, что номер неверный: кампании «Баннер на поиске» (MCBANNER) API не отдаёт, по ID они приходят пустыми.

Inputs: campaign_id (required).

get_campaign_negative_keywordsПолучить минус-фразы кампанийC
Read-only

Получить текущие минус-фразы кампаний по их ID.

Inputs: campaign_ids (required).

get_changesИзменения объектовB
Read-only

Проверить изменения кампаний, групп и объявлений начиная с указанного времени, а также изменения справочников (mode=dictionaries) и текущее время сервера Директа.

Inputs: mode (required), ad_ids, timestamp, field_names, +2 more.

get_keyword_auctionАукцион по фразамA
Read-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Прогноз по фразамA
Read-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Справочник регионовB
Read-only

Справочник кодов регионов (GeoRegions) для таргетинга. Фильтр по названию, 225 = Россия. with_parents=true показывает вложенность и различает одноимённые города.

Inputs: limit, search, with_parents.

get_search_queriesПоисковые запросыB
Read-only

Отчёт по фактическим поисковым запросам для анализа и добавления минус-фраз.

Inputs: date_to (required), date_from (required), campaign_ids (required), goals, +5 more.

get_statisticsСтатистикаB
Read-only

Статистика за период по кампаниям, группам, объявлениям, условиям показа или аккаунту: показы, клики, расход (руб), CTR, CPC; с goals — конверсии и CPA по целям Метрики (ReportService, TSV).

Inputs: date_to (required), date_from (required), goals, limit, +6 more.

get_strategyСтратегия кампанииA
Read-only

Получить текущую стратегию показов текстово-графической кампании вместе с целями (PriorityGoals), счётчиками и моделью атрибуции. Реальные ID целей Метрики, по которым работает кампания, — TextCampaign.PriorityGoals.Items[].GoalId (рядом их ценность Value в рублях), счётчики — CounterIds. GoalId внутри BiddingStrategy бывает служебным: 13 — «оптимизировать по ключевым целям», то есть по тем же PriorityGoals; 12 — «Вовлечённые сессии». Названий целей API Директа не отдаёт — они есть только в Метрике.

Inputs: campaign_id (required).

get_time_targetingРасписание показов кампанииB
Read-only

Временной таргетинг кампании: часовой пояс, часы показов по дням недели, почасовые коэффициенты и настройка праздников.

Inputs: campaign_id (required).

list_ad_extensionsСписок уточненийB
Read-only

Получить уточнения (callouts) с их статусами и текстом.

Inputs: limit, offset, states, statuses, +1 more.

list_ad_groupsСписок группB
Read-only

Группы объявлений выбранных кампаний: названия, регионы, статусы. По умолчанию возвращается узкий набор полей; нужны другие (NegativeKeywords, NegativeKeywordSharedSetIds, TrackingParams, ServingStatus и прочие из AdGroupFieldEnum) — перечислите их в fields.

Inputs: campaign_ids (required), limit, fields, offset.

list_adsСписок объявленийA
Read-only

Объявления: все заголовки и тексты, ссылки, статусы, тип и подтип объявления, привязанные сайтлинки, изображения и видео. Текстовые объявления Директ отдаёт комбинаторными (RESPONSIVE_AD). Причина отказа модерации приходит в StatusClarification. Отбор по ID объявлений, группам или кампаниям — хотя бы одно из трёх; сужается состоянием, статусом и типом. Без фильтра по состоянию архивные приходят наравне с активными. Список может быть неполным: объявления, тексты которых генерирует нейросеть Яндекса, через API недоступны и в выдачу не попадают, а по ответу это никак не видно. Поэтому «в группе только эти объявления» из ответа не следует — ни из пустого, ни из непустого; для полноты картины сверяйтесь с интерфейсом Директа.

Inputs: limit, types, ad_ids, offset, +4 more.

list_audience_targetsАудиторные целиC
Read-only

Получить условия нацеливания на аудиторию по ID кампании, группы, ретаргетинга или интереса.

Inputs: limit, offset, states, ad_group_ids, +4 more.

list_businessesПрофили организацийB
Read-only

Получить доступные профили организаций из Яндекс Бизнеса.

Inputs: limit, offset, business_ids.

list_campaignsСписок кампанийA
Read-only

Список рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу. Бюджеты — в рублях. По умолчанию возвращается узкий набор полей; нужны другие (Funds, TimeZone, NegativeKeywords и прочие из CampaignFieldEnum) — перечислите их в fields. Кампаний «Баннер на поиске» (MCBANNER) API не отдаёт вовсе: их нет в списке, и это граница API, а не ошибка логина или фильтра — такие кампании видны только в веб-интерфейсе.

Inputs: limit, types, fields, offset, +1 more.

list_dynamic_targetsДинамические целиC
Read-only

Получить условия нацеливания динамических текстовых объявлений.

Inputs: limit, offset, states, ad_group_ids, +2 more.

list_feedsСписок фидовB
Read-only

Получить товарные фиды, их источники, статусы обработки и связанные кампании.

Inputs: limit, offset, feed_ids.

list_keywordsСписок ключевых словA
Read-only

Ключевые фразы в группах объявлений: фразы, ставки (руб), статусы. По умолчанию возвращается узкий набор полей; нужны другие (StatisticsSearch, StatisticsNetwork, Productivity, ServingStatus и прочие из KeywordFieldEnum) — перечислите их в fields. Автотаргетинг — спецфраза ---autotargeting в той же группе; его категории запросов — с autotargeting: true.

Inputs: ad_group_ids (required), limit, fields, offset, +1 more.

list_negative_keyword_shared_setsОбщие наборы минус-фразC
Read-only

Получить общие наборы минус-фраз аккаунта.

Inputs: limit, offset, set_ids.

list_retargeting_listsСписки ретаргетингаB
Read-only

Получить условия ретаргетинга и подбора аудитории с правилами и областью применения.

Inputs: limit, types, offset, retargeting_list_ids.

list_time_zonesСправочник часовых поясовB
Read-only

Справочник часовых поясов (TimeZones) для set_time_targeting и create_campaign. Фильтр по коду или названию.

Inputs: limit, search.

list_vcardsСписок визитокA
Read-only

Получить виртуальные визитки по ID или найти их через объявления выбранных кампаний. Создавать визитки Директ через API не даёт — новая визитка заводится в интерфейсе Директа.

Inputs: limit, offset, vcard_ids, campaign_ids.

logoutВыход из ДиректаA
Destructive

Удаляет сохранённый вход из диалога с этого компьютера. Переменную YANDEX_DIRECT_TOKEN не трогает; доступ приложения отзывается в Яндекс ID.

Inputs: no named parameters.

manage_ad_imagesУправление изображениямиB
Destructive

Загрузить, получить или удалить изображения объявлений (AdImages). Для add данные передаются в base64.

Inputs: action (required), limit, images, offset, +2 more.

manage_adsУправление объявлениямиB
Destructive

Действие над объявлениями: suspend/resume/archive/unarchive/moderate/delete. ⚠️ delete необратимо.

Inputs: action (required), ad_ids (required).

manage_campaignsУправление кампаниямиA
Destructive

Запустить, остановить, архивировать, разархивировать или удалить кампании. ⚠️ delete необратимо и недоступен кампании с накопленной статистикой — такую только архивировать.

Inputs: action (required), campaign_ids (required).

manage_dynamic_targetsУправление динамическими целямиC
Destructive

Создать, изменить ставки, остановить, возобновить или удалить динамические цели.

Inputs: action (required), bids, targets, dynamic_target_ids.

manage_keywordsУправление ключевыми словамиB
Destructive

Действие над ключевыми фразами: suspend/resume/delete. ⚠️ delete необратимо.

Inputs: action (required), keyword_ids (required).

manage_negative_keyword_shared_setsУправление общими минус-фразамиC
Destructive

Создать, изменить или удалить общие наборы минус-фраз аккаунта.

Inputs: action (required), set_ids, add_sets, update_sets.

moderate_adsОтправить объявления на модерациюC
Idempotent

Отправить выбранные объявления на модерацию.

Inputs: ad_ids (required).

set_ad_group_negative_keywordsМинус-фразы группыA
Destructive

Минус-фразы на уровне группы объявлений. Режим mode обязателен: replace заменяет список целиком (прежние фразы теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Чтобы добавить фразу к существующим, нужен add: replace с одной фразой сотрёт остальные.

Inputs: mode (required), ad_group_id (required), negative_keywords (required).

set_audience_targetsУправление аудиторными целямиC
Destructive

Добавить, остановить, возобновить, удалить аудиторные цели или изменить их ставки.

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Изменить корректировки ставокB
Idempotent

Изменить коэффициенты существующих корректировок по их ID.

Inputs: adjustments (required).

set_campaign_blocked_ipsЗапрещённые IP кампанииA
Destructive

IP-адреса, которым кампания не показывается (до 25, одиночные публичные IPv4). Режим mode обязателен: replace заменяет список целиком (прежние адреса теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — add и remove читают текущий список сами. Текущий список есть в get_campaign.

Inputs: ips (required), mode (required), campaign_id (required).

set_campaign_excluded_sitesЗапрещённые площадки кампанииA
Destructive

Площадки РСЯ и приложения, на которых кампания не показывается (до 1000). Режим mode обязателен: replace заменяет список целиком (прежние площадки теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Текущий список есть в get_campaign. Чтобы добавить площадку к существующим, нужен add: replace с одной площадкой сотрёт остальные.

Inputs: mode (required), sites (required), campaign_id (required).

set_campaign_negative_keywordsМинус-фразы кампанииA
Destructive

Минус-фразы на уровне кампании. Режим mode обязателен: replace заменяет список целиком (прежние фразы теряются, пустой массив очищает), add дописывает к текущим, remove убирает названные — читать список перед этим не нужно, add и remove делают это сами. Чтобы добавить фразу к существующим, нужен add: replace с одной фразой сотрёт остальные.

Inputs: mode (required), campaign_id (required), negative_keywords (required).

set_keyword_bidsУстановить ставкиA
Idempotent

Установить фиксированные ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний и включить или выключить автоставку автотаргетинга. Ставки применяются только при ручной стратегии: на автостратегии их назначает Директ, и ставка, не подходящая стратегии, не применится. Сначала get_strategy, затем get_keyword_auction — сколько стоит нужный объём трафика; ставку под объём ставит set_auto_keyword_bids.

Inputs: search_bid, keyword_ids, network_bid, ad_group_ids, +2 more.

set_priority_goalsЦели стратегииA
Destructive

Задать цели стратегии кампании (PriorityGoals) и их ценность в рублях — по ним автостратегия оптимизирует ставки, в том числе «максимум конверсий» со служебным GoalId 13. Режим mode обязателен: add добавляет цели или меняет ценность уже заданных, remove убирает названные, replace заменяет список целиком (пустой массив очищает). Текущий список сервер читает сам. Чтобы добавить цель к существующим, нужен add: replace с одной целью сотрёт остальные. ⚠️ Смена целей перезапускает обучение стратегии. Поддерживаются текстово-графические, динамические, смарт и единые перфоманс-кампании; ID целей — из Метрики.

Inputs: mode (required), goals (required), campaign_id (required).

set_strategyИзменить стратегию кампанииB
Idempotent

Изменить стратегию текстово-графической кампании: ручная, максимум кликов, средняя цена клика или конверсии, оплата за конверсию. Цены — в рублях, цель Метрики — goal_id.

Inputs: campaign_id (required), search_type (required), network_type (required), goal_id, +6 more.

set_time_targetingЗадать расписание показовA
Idempotent

Задать расписание показов кампании: дни, часы, почасовые коэффициенты, праздники и часовой пояс. ⚠️ Расписание заменяется целиком: часы вне переданных правил показов не получат.

Inputs: schedule (required), campaign_id (required), time_zone, holiday_end_hour, +4 more.

start_loginВход в Яндекс.Директ: ссылкаA
Idempotent

Первый шаг входа из диалога, без ручного токена: возвращает ссылку на вход в Яндекс. Ссылку показать пользователю, код со страницы Яндекса передать в finish_login. Повторный вызов делает прежнюю ссылку недействительной.

Inputs: no named parameters.

update_ad_groupОбновить группуA
Idempotent

Изменить группу объявлений без пересоздания: название, регионы показа (полный список, заменяет прежний) и/или UTM-разметку ссылок. Минус-фразы группы — set_ad_group_negative_keywords, наборы — link_negative_keyword_sets, автотаргетинг — update_keywords.

Inputs: ad_group_id (required), name, region_ids, tracking_params.

update_campaignОбновить кампаниюA
Idempotent

Обновить кампанию: название, бюджет (руб), 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Обновить комбинаторное объявлениеA
Idempotent

Обновить комбинаторное объявление: заголовки, тексты, ссылка. Набор заголовков или текстов заменяется целиком — передайте полный, вместе с теми, что не меняются; текущие показывает 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

    B3.1/5.0

    Scored across 68 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables managing Yandex Direct PPC campaigns, ad groups, ads, and keywords, plus pulling performance statistics via the Yandex Direct API v5.
      46
      641 npm
      10
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to manage Yandex Direct advertising campaigns, ads, keywords, and reports via natural language using the Yandex Direct API v5.
      2
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to manage Yandex Direct advertising accounts via the API v5, including reports, bids, campaign management, and semantic analysis through natural language requests.
      4
      MIT