Перейти к содержимому

MCP-сервер Яндекс Аудиторий для Claude, ChatGPT и Codex

Яндекс Аудитории через ИИ: база клиентов, похожие аудитории и геосегменты

Подключите Аудитории к своему ИИ через LidFly: он загрузит базу клиентов, соберёт похожую аудиторию, сегмент из Метрики или геосегмент вокруг ваших точек и подключит его к кампании в Директе. Каждый шаг — после вашего подтверждения.

  • Без привязки карты
  • В Яндекс уходят только хеши контактов
  • AppMetrica — тем же подключением

Обновлено

Claude · подключён LidFly MCPПример · данные условные

Загрузи базу клиентов из clients.csv, сделай похожую аудиторию и подключи её к кампании «Ретаргетинг» в Директе. Сначала покажи отчёт проверки файла.

  • audience_request_file_upload — приватная ссылка для загрузки CSV
  • audience_create_segment_from_file — проверка без отправки
  • audience_create_lookalike — похожая аудитория на сегмент
Строк в файле
4 820
телефоны и e-mail
Подошло
4 512
после очистки
Отброшено
308
дубли и пустые
Статус
обработка
обычно несколько часов

Дальше по шагам:

  1. 1Создать сегмент «Клиенты 2026» из файлаСегмент
  2. 2Похожая аудитория на этот сегментLook-alike
  3. 3Условие ретаргетинга в ДиректеДирект
  4. 4Добавить условие в группу «Ретаргетинг»Директ

Создавай, всё верно.

СозданоСегмент и похожая аудитория отправлены в Яндекс; к рекламе подключатся, когда статус станет «готов».

Обзор

Что ИИ делает с Яндекс Аудиториями

Три задачи, ради которых подключают Аудитории. Каждая ниже — с готовым запросом.

База клиентов

Загрузить базу клиентов в Яндекс Аудитории

ИИ получает одноразовую приватную ссылку и загружает по ней ваш CSV. Сначала он запускает проверку без отправки и показывает отчёт: сколько строк подошло, сколько отброшено и почему. Сегмент создаётся только после вашего подтверждения, исходный файл удаляется сразу после отправки.

  • Приватная ссылка для загрузки CSVaudience_request_file_upload
  • Сегмент из файла с проверкой без отправкиaudience_create_segment_from_file
  • Дозагрузка и замена данных сегментаaudience_update_segment_data
  • Список сегментов, статус и готовность для Директаaudience_get_segments

Требования к файлу

CSV в UTF-8 или Windows-1251 до 10 МБ, колонки phone и/или email (подойдут «Телефон» и «Почта»), минимум 100 записей после очистки. Остальные колонки в Яндекс не отправляются, XLSX не принимается.

Готовый запрос — вставьте в Claude, ChatGPT или Codex

Загрузи базу клиентов из файла ~/Downloads/clients.csv в Яндекс Аудитории. Сначала покажи отчёт проверки: сколько строк подошло и почему остальные отброшены. Сегмент создавай только после моего подтверждения.

Сегменты для Директа шаг за шагом — «Яндекс Аудитории: сегменты для Директа через ИИ»

Сегменты

Похожие аудитории, сегменты Метрики и ретаргетинг в Директе

На основе сегмента ИИ соберёт похожую аудиторию (Look-alike), создаст сегмент из тех, кто выполнил цель Метрики, или из пользователей приложения AppMetrica. Готовый сегмент он подключит к кампании: создаст условие ретаргетинга в Директе и добавит его в группу.

  • Похожая аудитория на сегментaudience_create_lookalike
  • Сегмент из цели или сегмента Метрикиaudience_create_metrika_segment
  • Сегмент из пользователей AppMetricaaudience_create_appmetrica_segment
  • Доступ к сегменту другому логинуaudience_grant_segment_access

Готовый запрос — вставьте в Claude, ChatGPT или Codex

Сделай похожую аудиторию на сегмент «Покупатели 2026» и сегмент из тех, кто выполнил цель «Заявка» в Метрике за 90 дней. Когда сегменты будут готовы, подключи их к группе «Ретаргетинг» в Директе — каждое действие после моего подтверждения.

Ретаргетинг без лишних показов — «Ретаргетинг в Директе и VK»

Геосегменты

Геосегменты: реклама людям рядом с вашими точками

ИИ соберёт геосегмент вокруг ваших адресов: кто живёт или работает рядом, регулярно бывает в месте, находится там сейчас или посещал его нужное число раз за период. В одном сегменте — до 1000 точек; точки должны быть внутри региона показа кампании.

Кого выбратьКак попросить ИИ
Живут рядом«Те, кто живёт в радиусе 1 км от салона»
Работают рядом«Люди, которые работают рядом с офисом»
Регулярно бывают«Те, кто регулярно бывает в этом ТЦ»
Бывали у конкурентов«Были у конкурентов 2 раза за 30 дней»
  • Геосегмент по точкам и радиусуaudience_create_geo_segment
  • Переименование и удаление сегментаaudience_rename_segment

Готовый запрос — вставьте в Claude, ChatGPT или Codex

Собери геосегмент людей, которые живут или работают в радиусе 1 км от трёх наших магазинов: Казань, ул. Баумана 15; пр. Победы 46; ул. Чистопольская 20. Покажи настройки сегмента до создания.

Как выбрать группы аудитории — «Сегментация аудитории для рекламы»

Подключение

Как подключить Яндекс Аудитории к Claude, ChatGPT или Codex

Три шага, около трёх минут. Аудитории входят в MCP-пакет LidFly: 990 ₽ за 30 дней. Первые 7 дней — бесплатно, без карты и автосписаний.

  1. Зарегистрируйтесь в LidFly

    Email и код из письма — без пароля и без карты. После входа кабинет сразу откроет карточку «Аудитории и AppMetrica» с кнопкой подключения.

    Создать аккаунт
  2. Подключите Аудитории через вход в Яндекс

    Нажмите «Подключить» в карточке «Аудитории и AppMetrica» и войдите под логином, на котором работает Директ: сегмент должен быть на том же логине, что и кампания. Яндекс спросит одно разрешение сразу на Аудитории и AppMetrica.

  3. Добавьте LidFly в свой ИИ

    Выберите клиент. Ключ копировать не нужно: вход по email через OAuth.

    Адрес MCP-сервераhttps://lidfly.ru/mcp/v3

    Рекомендуем

    Подключите LidFly к Codex за несколько минут

    Скачайте установщик, подготовьте плагин и сделайте первый запрос по одной пошаговой инструкции. API-ключи копировать не нужно.

    Открыть инструкцию для Codex

    Два способа авторизации

    Вход по email через OAuth

    Агент подключается к адресу сервера и просит войти по email. Ключ копировать не нужно.

    API-ключ в заголовке

    Если клиент позволяет задавать заголовок. Ключ — в кабинете: Настройки → API-ключ → «Скопировать ключ».

    Authorization: Bearer <account_key>

    Для одного подключения выберите один способ: статический Authorization может перекрыть OAuth-токен. Не публикуйте ключ и не отправляйте его в чат.

    Инструкции для Claude, ChatGPT, Codex, Cursor и других клиентов: быстрый старт.

    Проверка

    Напишите ИИ «Покажи мои сегменты в Яндекс Аудиториях» — он вернёт сегменты со статусом и готовностью для Директа.

Безопасность

Почему базе клиентов ничего не грозит

Контакты клиентов — персональные данные, а удалённый сегмент ломает ретаргетинг, поэтому действия проходят одни и те же проверки.

  • Только хеши контактов

    В Яндекс уходят хеши телефонов и e-mail. Исходный файл хранится приватно не больше часа и удаляется после создания сегмента.

  • Проверка без отправки

    Сначала ИИ показывает отчёт по файлу, сегмент создаётся только после вашего подтверждения.

  • Защита ретаргетинга

    Перед удалением сегмента или отзывом доступа ИИ проверяет условия ретаргетинга в Директе, где он используется.

  • Лимиты Яндекса заранее

    Создание и изменение сегментов ограничено: 10 в минуту, 100 в час и 500 в сутки на логин. LidFly проверяет лимиты до запроса.

Справочник

Все 13 инструментов MCP Яндекс Аудиторий

2 чтения ИИ вызывает через call_tool, 11 действий — через call_write_tool после вашего подтверждения. Список виден целиком; поиск и фильтр только сужают его.

Сегменты 3

audience_get_segments

Яндекс Аудитории (audience.yandex.ru): все сегменты подключённого логина — список своих и выданных другими логинами сегментов.

Чтение
audience_rename_segment

Яндекс Аудитории: переименовать сегмент.

Действие
audience_delete_segment

Яндекс Аудитории: удалить сегмент.

Действие

Создание сегментов 7

audience_create_lookalike

Яндекс Аудитории: создать сегмент похожих пользователей (Look-alike) на основе своего сегмента — например, похожих на покупателей из базы клиентов.

Действие
audience_create_metrika_segment

Яндекс Аудитории: создать сегмент из объекта Яндекс Метрики — посетителей, достигших цели, из сегмента Метрики или всех посетителей счётчика.

Действие
audience_create_appmetrica_segment

Яндекс Аудитории: создать сегмент из пользователей приложения AppMetrica — всех пользователей приложения или сохранённого сегмента AppMetrica.

Действие
audience_create_geo_segment

Яндекс Аудитории: создать геосегмент по окружностям вокруг точек — например, людей, которые живут или работают рядом с салоном.

Действие
audience_request_file_upload

Подготовка загрузки базы клиентов.

Действие
audience_create_segment_from_file

Яндекс Аудитории, шаг 2: создать сегмент из загруженного CSV с базой клиентов.

Действие
audience_update_segment_data

Яндекс Аудитории: изменить данные сегмента, созданного из файла.

Действие

Доступы 3

audience_get_segment_grants

Яндекс Аудитории: кому выдан доступ к сегменту (логины и уровень доступа).

Чтение
audience_grant_segment_access

Яндекс Аудитории: выдать другому логину Яндекса доступ к сегменту.

Действие
audience_revoke_segment_access

Яндекс Аудитории: отозвать у логина доступ к сегменту.

Действие
Технические подробности для ИИ-клиентов
  • Подключение относится к аккаунту LidFly, а не к Проекту. При нескольких логинах ИИ передаёт audience_connection_id — это не тот же connection_id, что у Директа.
  • Загрузка: одноразовая ссылка действует 5 минут, файл загружается командой curl -T. Телефоны приводятся к виду 79991234567, e-mail — к нижнему регистру; дубли и строки без контактов убираются. Уже захешированные данные — колонки phone_SHA256 и email_SHA256.
  • Менять данные можно только у сегмента из файла и только после его обработки. Большую базу можно дозагрузить частями в тот же сегмент.
  • Для рекламы ИИ использует инструменты Директа add_retargeting_list и add_audience_targets.
  • Если на логине больше 1000 геосегментов и в Директе используется меньше 5% из них, Яндекс запрещает создавать новые.
  • Загружая базу клиентов, вы подтверждаете, что у вас есть согласие клиентов на использование их контактов для рекламы.

Ограничения

Чего пока нет

Честный список, чтобы вы не тратили время на проверку того, что сейчас не работает.

Базы с ID мобильных устройств
Через LidFly такие сегменты не создаются. Для пользователей приложения используйте сегмент из AppMetrica.
Сегменты по пикселю
Создать нельзя, но готовые сегменты по пикселю ИИ видит в списке.
Мгновенная готовность
Яндекс обрабатывает сегмент обычно несколько часов; пока статус не «готов», Директ его не видит.
Файлы XLSX
Принимается только CSV: сохраните таблицу как «CSV UTF-8».

Блог

Примеры и разборы в блоге LidFly

Длинные сценарии с готовыми запросами и разбором результата.

Все статьи блога

Вопросы

Частые вопросы

Как загрузить базу клиентов в Яндекс Директ?

Через Яндекс Аудитории: ИИ загрузит CSV с телефонами и e-mail, покажет отчёт проверки и после подтверждения создаст сегмент, а затем подключит его к кампании в Директе.

Что такое похожие аудитории (Look-alike)?

Это люди, похожие на ваших клиентов по поведению. ИИ соберёт такую аудиторию на основе сегмента из файла, Метрики или AppMetrica.

Безопасно ли загружать базу клиентов?

В Яндекс уходят только хеши контактов, исходный файл удаляется после отправки. Согласие клиентов на рекламу остаётся вашей ответственностью.

Через сколько сегмент можно использовать в рекламе?

Обычно через несколько часов: пока Яндекс обрабатывает сегмент, Директ его не видит. ИИ проверит статус и подключит сегмент, когда он будет готов.

Нужно ли отдельно подключать AppMetrica?

Нет. Одно подключение карточки «Аудитории и AppMetrica» открывает оба сервиса.

Сколько стоит?

Аудитории входят в MCP-пакет — 990 ₽ за 30 дней. Первые 7 дней бесплатно, без карты.

Яндекс Аудитории + ваш ИИ

Покажите рекламу своим клиентам

Начните с проверки базы клиентов без отправки — посмотрите, сколько контактов подойдёт. Дальше ИИ соберёт похожую аудиторию и подключит её к Директу.

Без карты и автосписаний · после пробного периода 990 ₽ за 30 дней · продлевать необязательно

Страница помогла?

Обновлено

7 дней бесплатнобез карты и автосписаний

Начать