# Яндекс Директ: Создать текстовое объявление — MCP-инструмент (tool)

**MCP-инструмент (tool) для Яндекс Директа:** Создаёт текстовое объявление (TextAd) в группе объявлений.

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

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

> Я хочу создать текстовое объявление.

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

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

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

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

- `adGroupId` — **обязательно**. Id родительской группы объявлений.
- `title` — **обязательно**. Заголовок (Title 1), до 56 символов.
- `title2` — **необязательно**. Второй заголовок (Title 2), до 30 символов.
- `text` — **обязательно**. Текст объявления, до 81 символа.
- `href` — **обязательно**. URL посадочной страницы (обязателен для TextAdAdd).
- `mobile` — **необязательно**. Мобильное ли это объявление. Поле в API устарело (значение принудительно NO), но остаётся обязательным.

## Что вернёт

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

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

Инструмент изменяет реальные данные Яндекс Директа так, как описано выше. Автоматического отката сервер не обещает.

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

> Создать текстовое объявление в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их.

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

Новые объявления создаются черновиками. TextAdAdd требует хотя бы одно из Href/TurboPageId/VCardId/BusinessId — этот инструмент передаёт посадочную страницу через href (обязателен); объявление с BusinessId вместо ссылки создаётся через raw_request.

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

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

- [Действие с объявлениями](./ad-action.md) — `ad_action`
- [Список объявлений](./list-ads.md) — `list_ads`
- [Обновить текстовое объявление](./update-text-ad.md) — `update_text_ad`

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

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