Яндекс Директ: Загрузить изображение — MCP-инструмент (tool)
MCP-инструмент (tool) для Яндекс Директа: Загружает изображение в библиотеку изображений (adimages/add) и возвращает его AdImageHash — этот хеш подставляется в поле AdImageHash текстово-графического объявления.
Техническое имя: upload_ad_image
Какую задачу решает
Я хочу загрузить изображение.
Загружает изображение в библиотеку изображений (adimages/add) и возвращает его AdImageHash — этот хеш подставляется в поле AdImageHash текстово-графического объявления.
Когда использовать
Используйте эту возможность, когда нужен результат «Загрузить изображение» без ручной работы в интерфейсе Яндекс Директа. Операция выполняется только по вызову из AI-приложения.
Что нужно передать
name— обязательно. Название изображения в библиотеке.url— необязательно. Публичный URL изображения; сервер скачает его и закодирует в base64. Нужно передать это поле или imageData.imageData— необязательно. Байты изображения в base64 (префикс data:-URL отбрасывается). Нужно передать это поле или url.
Что вернёт
Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.
Что изменится в Яндекс Директе
Инструмент изменяет реальные данные Яндекс Директа так, как описано выше. Автоматического отката сервер не обещает.
Пример запроса
Загрузить изображение в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их.
Возможные ошибки и ограничения
Изображение передаётся публичным URL (сервер сам скачает и закодирует) или в base64 через imageData. Яндекс принимает JPG/PNG/GIF до 10 МБ; текстово-графическому объявлению нужна горизонтальная картинка (минимум 1080×607).
Доступ также зависит от прав токена, квот и ограничений исходного API.
Связанные MCP-инструменты
- Изображения объявлений —
get_ad_images - Видео объявлений —
get_ad_videos - Креативы —
get_creatives
Технические сведения
- Воздействие: изменяет данные
- Группа: Медиа
- Источник описания: регистрация
upload_ad_imageвsrc/tools/media.ts - Полный технический справочник
- Все MCP-возможности