MCP-возможности Яндекс Директа

Каталог содержит 44 публичные страницы — по одной для каждого зарегистрированного MCP-инструмента (tool) репозитория mcp-yandex-direct. Страницы начинаются с задачи пользователя, объясняют результат и отдельно показывают, изменит ли вызов реальные данные.

Используйте этот каталог для выбора готовой возможности. Полные схемы параметров и ответы API остаются в техническом справочнике.

Подключение

Статус подключения — Показывает, подключён ли Яндекс Директ: есть ли токен, откуда он взят и когда истекает. Ничего не отправляет в сеть и не показывает сам токен. Воздействие: только чтение.
Начать подключение — Первый шаг подключения из диалога: возвращает ссылку на страницу Яндекс OAuth, которую нужно показать пользователю. Воздействие: только чтение.
Завершить подключение — Второй шаг: обменивает код подтверждения на токен доступа и сохраняет его в файл только для владельца. Воздействие: изменяет данные.
Отключить Директ — Удаляет сохранённый токен Директа с диска; переменную окружения не трогает. Воздействие: опасная операция.

Объявления

Действие с объявлениями — Выполняет действие над объявлениями по id: moderate, suspend, resume, archive, unarchive или delete. Воздействие: опасная операция.
Создать текстовое объявление — Создаёт текстовое объявление (TextAd) в группе объявлений. Воздействие: изменяет данные.
Список объявлений — Возвращает список объявлений с необязательными фильтрами по кампании, группе, id, состоянию и статусу. Воздействие: только чтение.
Обновить текстовое объявление — Обновляет заголовок, текст или посадочную страницу текстового объявления (ads/update). Воздействие: изменяет данные.

Корректировки ставок

Добавить корректировку ставок — Добавляет корректировку ставок на кампанию или группу объявлений. Воздействие: изменяет данные.
Удалить корректировки ставок — Удаляет корректировки ставок по id (bidmodifiers/delete). Воздействие: опасная операция.
Корректировки ставок — Читает корректировки ставок (мобильные, десктоп, демография, ретаргетинг, регионы, видео) для кампаний или групп объявлений. Воздействие: только чтение.
Изменить корректировки ставок — Меняет процент существующих корректировок (bidmodifiers/set) по id корректировки. Воздействие: изменяет данные.

Расширения объявлений

Добавить уточнения — Создаёт уточнения, до 25 символов каждое. Воздействие: изменяет данные.
Создать набор быстрых ссылок — Создаёт набор быстрых ссылок (1–8 штук). Воздействие: изменяет данные.
Создать визитку — Создаёт виртуальную визитку в кампании. Воздействие: изменяет данные.
Удалить уточнения — Удаляет уточнения по id (adextensions/delete). Воздействие: опасная операция.
Удалить наборы быстрых ссылок — Удаляет наборы быстрых ссылок по id (удалить можно только наборы, не привязанные ни к одному объявлению). Воздействие: опасная операция.
Удалить визитки — Удаляет визитки по id (vcards/delete). Воздействие: опасная операция.
Уточнения — Возвращает список уточнений из библиотеки adextensions. Воздействие: только чтение.
Наборы быстрых ссылок — Читает наборы быстрых ссылок по id. Воздействие: только чтение.
Визитки — Читает виртуальные визитки по id. Воздействие: только чтение.

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

Добавить ключевые фразы — Добавляет ключевые фразы в группу объявлений, при необходимости — со ставками для поиска и сетей. Воздействие: изменяет данные.
Действие с ключевыми фразами — Выполняет действие над ключевыми фразами по id: suspend, resume или delete. Воздействие: опасная операция.
Список ключевых фраз — Возвращает список ключевых фраз с фильтром по кампании, группе объявлений или id. Воздействие: только чтение.
Задать ставки ключевых фраз — Задаёт ручные ставки на поиске и в сетях для ключевых фраз либо для всех фраз указанных групп объявлений или кампаний (keywordbids/set). Воздействие: изменяет данные.

Кампании

Действие с кампаниями — Выполняет действие над кампаниями по id: suspend, resume, archive, unarchive или delete. Воздействие: опасная операция.
Создать текстовую кампанию — Создаёт кампанию TextCampaign (текстово-графические объявления). Воздействие: изменяет данные.
Список кампаний — Возвращает список кампаний с необязательными фильтрами по id, типу, состоянию и статусу. Воздействие: только чтение.
Обновить кампанию — Обновляет название, дату окончания и/или дневной бюджет кампании (campaigns/update). Воздействие: изменяет данные.

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

Создать группу объявлений — Создаёт группу объявлений в кампании с заданными регионами показа. Воздействие: изменяет данные.
Удалить группы объявлений — Удаляет группы объявлений по id (adgroups/delete). Воздействие: опасная операция.
Список групп объявлений — Возвращает список групп объявлений. Воздействие: только чтение.
Обновить группу объявлений — Обновляет название и/или регионы показа группы объявлений (adgroups/update). Воздействие: изменяет данные.

Аккаунт

Данные аккаунта — Возвращает данные текущего аккаунта рекламодателя (логин, валюта, тип, страна) через сервис clients Яндекс Директа. Воздействие: только чтение.
Баланс аккаунта — Возвращает баланс общего счёта и финансовые поля (Amount, AmountAvailableForTransfer, Currency, Discount, AccountID) через устаревший сервис AccountManagement Live v4 — единственный API Яндекс Директа, который отдаёт баланс (в v5 финансового метода нет). Воздействие: только чтение.
Квота API — Возвращает сегодняшнюю квоту баллов API (потрачено / осталось / лимит) из заголовка Units — чтобы не упереться в дневной лимит. Воздействие: только чтение.

Медиа

Изображения объявлений — Возвращает список изображений из библиотеки изображений, ключ — хеш изображения. Воздействие: только чтение.
Видео объявлений — Читает видео из библиотеки видео по id (API требует id). Воздействие: только чтение.
Креативы — Возвращает список креативов (смарт-баннеры, HTML5) из библиотеки креативов. Воздействие: только чтение.
Загрузить изображение — Загружает изображение в библиотеку изображений (adimages/add) и возвращает его AdImageHash — этот хеш подставляется в поле AdImageHash текстово-графического объявления. Воздействие: изменяет данные.

Справочники

Справочники — Возвращает справочники Яндекс Директа (валюты, часовые пояса, константы, категории объявлений, …). Воздействие: только чтение.
Поиск регионов — Ищет id регионов для таргетинга (те самые regionIds, которые нужны create_ad_group). Воздействие: только чтение.

Статистика

Статистика — Запрашивает отчёт по эффективности через сервис Reports Яндекс Директа. Воздействие: только чтение.

Дополнительные методы API

Прямой вызов API Яндекс Директа — Универсальный запрос: вызывает напрямую любой сервис или метод API Яндекс Директа v5 (например service "bidmodifiers", method "get"). Воздействие: опасная операция.