# Яндекс Директ: Загрузить изображение — 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.md) — `get_ad_images`
- [Видео объявлений](./get-ad-videos.md) — `get_ad_videos`
- [Креативы](./get-creatives.md) — `get_creatives`

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

- **Воздействие:** изменяет данные
- **Группа:** Медиа
- **Источник описания:** регистрация `upload_ad_image` в `src/tools/media.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)