# Яндекс Аудитории: Создать lookalike-сегмент — MCP-инструмент (tool)

**MCP-инструмент (tool) для Яндекс Аудиторий:** Создаёт сегмент типа lookalike — пользователи, «похожие» по поведению в интернете на аудиторию исходного сегмента (lookalike_link).

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

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

> Я хочу создать lookalike-сегмент.

Создаёт сегмент типа lookalike — пользователи, «похожие» по поведению в интернете на аудиторию исходного сегмента (lookalike_link).

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

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

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

- `name` — **обязательно**. Название сегмента.
- `lookalike_link` — **обязательно**. Идентификатор исходного сегмента, на который будут «похожи» пользователи.
- `lookalike_value` — **обязательно**. Степень «похожести»: 1 (точнее, уже) .. 5 (шире охват).
- `maintain_device_distribution` — **необязательно**. Сохранять распределение по типам устройств исходного сегмента (по умолчанию true).
- `maintain_geo_distribution` — **необязательно**. Сохранять распределение по городам исходного сегмента (по умолчанию true).

## Что вернёт

Ответ — {"segment": {...}}; сегмент обрабатывается асинхронно, статус смотрите через list_segments.

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

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

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

> Создать lookalike-сегмент в Яндекс Аудиториях. Если не хватает обязательных идентификаторов, сначала уточни их.

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

lookalike_value — степень похожести от 1 (максимальная точность, меньший охват) до 5 (максимальный охват). maintain_device_distribution / maintain_geo_distribution (по умолчанию true) сохраняют распределение по типам устройств и городам исходного сегмента. Квота: 10/мин, 100/час, 500/сутки.

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

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

- [Сохранить загруженный сегмент](./confirm-segment.md) — `confirm_segment`
- [Создать сегмент на основе пикселя](./create-pixel-segment.md) — `create_pixel_segment`
- [Удалить сегмент](./delete-segment.md) — `delete_segment`
- [Список сегментов](./list-segments.md) — `list_segments`

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

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