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

Яндекс Аудитории: Загрузить файл сегмента (device id / MAC / хеши) — MCP-инструмент (tool)

MCP-инструмент (tool) для Яндекс Аудиторий: Создаёт сегмент из TSV/TXT-файла с данными: идентификаторы устройств (IDFA/GAID), MAC-адреса или SHA256-хеши, по одной записи в строке; минимум 100 записей, до 1 ГБ, UTF-8.

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

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

Я хочу загрузить файл сегмента (device id / MAC / хеши).

Создаёт сегмент из TSV/TXT-файла с данными: идентификаторы устройств (IDFA/GAID), MAC-адреса или SHA256-хеши, по одной записи в строке; минимум 100 записей, до 1 ГБ, UTF-8.

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

Используйте эту возможность, когда нужен результат «Загрузить файл сегмента (device id / MAC / хеши)» без ручной работы в интерфейсе Яндекс Аудиторий. Операция выполняется только по вызову из AI-приложения.

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

  • file_path — необязательно. Путь к локальному файлу с данными. Укажите либо file_path, либо content (ровно одно).
  • content — необязательно. Содержимое файла строкой (для небольших сегментов). Укажите либо content, либо file_path (ровно одно).
  • file_name — необязательно. Имя файла для загрузки. По умолчанию — имя из file_path или стандартное имя.

Что вернёт

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

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

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

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

Загрузить файл сегмента (device id / MAC / хеши) в Яндекс Аудиториях. Если не хватает обязательных идентификаторов, сначала уточни их.

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

Это первый шаг двухфазного создания: в ответе сегмент со статусом uploaded и его id — затем сегмент нужно сохранить инструментом confirm_segment (имя, тип содержимого, хеширование). Источник данных: file_path (путь к локальному файлу) или content (содержимое строкой) — ровно одно из двух. Квота на создание сегментов: 10/мин, 100/час, 500/сутки.

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

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

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