A1 инженерная AI-компания GitHub
Подключить MCP-сервер Яндекс Директ к AI-агенту Открытый код, MIT, npm-пакет. Инструкция по подключению к Claude, Cursor и Codex — в репозитории; вопросы по внедрению — в Telegram. Репозиторий на GitHub Telegram

Яндекс Директ: Прямой вызов API Яндекс Директа — MCP-инструмент (tool)

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

Техническое имя: raw_request

Какую задачу решает

Я хочу выполнить дополнительный запрос к API.

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

Когда использовать

Используйте эту возможность, когда нужен результат «Прямой вызов API Яндекс Директа» без ручной работы в интерфейсе Яндекс Директа. Операция выполняется только по вызову из AI-приложения.

Что нужно передать

  • service — обязательно. Путь сервиса строчными буквами, например campaigns, bidmodifiers, sitelinks, vcards, changes, keywordsresearch.
  • method — обязательно. Метод API, например get, add, update, delete, set, toggle, checkCampaigns.
  • params — необязательно. Объект params для метода — как есть.
  • confirmWrite — необязательно. Должен быть true для запуска метода записи (всё, кроме get/has/check).

Что вернёт

Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.

Что изменится в Яндекс Директе

Исходный код помечает весь вызов «Прямой вызов API Яндекс Директа» как опасный. Конкретное воздействие зависит от переданного действия и описано ниже; перед вызовом проверьте параметры и обратимость результата.

Пример запроса

Выполнить дополнительный запрос к API в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их. Сначала покажи, какие данные изменятся, и дождись подтверждения.

Возможные ошибки и ограничения

Нужен для сервисов, у которых нет отдельного инструмента. Деньги — в микроединицах (без конвертации). Методы чтения (get/has/check) выполняются свободно; любой другой метод считается записью и требует confirmWrite=true.

Доступ также зависит от прав токена, квот и ограничений исходного API.

Связанные MCP-инструменты

Связанных специализированных инструментов в этой группе нет.

Технические сведения