Что агент делает в Яндекс Аудиториях
Только отдельный сервер под Аудитории умеет загружать CRM-файлы, собирать похожие аудитории и раздавать доступы к сегментам. Другие серверы работают с Аудиториями как с частью рекламного стека Яндекса, вместе с Директом и Метрикой.
- Показывает сегменты и пиксели с их охватами. Это умеет MCP для Яндекс Аудиторий, в котором 20 инструментов для сегментов, пикселей и доступов, а подключение аккаунта проходит прямо в чате.
- Загружает CRM-файл с email, телефонами или хешированными идентификаторами. Загрузка и подтверждение параметров идут двумя вызовами, и обработка стартует после второго.
- Собирает похожую или пиксельную аудиторию для рекламной кампании, а охват готового сегмента сразу виден в ответе агента без захода в интерфейс Аудиторий.
- Выдает и отзывает доступ.
- Создает гео-сегменты для Директа. Это часть Штурмана, где каждое изменение проходит через план и подтверждающую фразу.
- Читает сегменты вместе с кампаниями Директа, счетчиками Метрики и Wordstat. Многопользовательский сервер с админ-панелью в Яндексе ничего не меняет.
Как получить OAuth-токен Аудиторий
API Аудиторий принимает OAuth-токен в заголовке Authorization каждого запроса. Адрес API — api-audience.yandex.ru. Версия указывается в пути, например /v1/management/segments.
Токен выдает Яндекс OAuth. Для этого на oauth.yandex.ru создают приложение. Документация называет два права для выбора. Первое разрешает создавать сегменты и менять настройки своих и доверенных сегментов, второе разрешает их читать. Для отладки у Яндекса есть отдельный отладочный токен.
Агенту для отчетов разумно завести отдельное приложение с одним правом на чтение. Сервер a1 проводит OAuth с PKCE прямо в диалоге, хранит токен локально с правами только владельца и обновляет его сам.
Сервер ставится одной командой npx skillfoxx add mcp/a1-yandeks-auditorii-mcp.
Квоты API Яндекс Аудиторий
Лимитов два. Один IP ограничен 30 запросами в секунду. Один логин ограничен 5000 запросами в сутки, а чтение и запись считаются отдельно. При превышении API отвечает 429 Too Many Requests. Суточная квота сбрасывается в полночь по Москве.
На создание и изменение сегментов действует свой потолок. Это 10 запросов в минуту, 100 в час и 500 в сутки. Ошибочные запросы тоже учитываются. Если на логине 1000 гео-сегментов и больше, а в Директе или Дисплее работает меньше 5% из них, создавать новые гео-сегменты API не даст.
Сегмент из файла принимает от 100 записей и до 1 ГБ. Сервер a1 не повторяет запись автоматически при сбое. Каждую повторную загрузку агент делает заново, и она расходует тот же лимит в 100 запросов на создание и изменение сегментов в час.
Сервер под задачу
Сервера от самого Яндекса для Аудиторий в каталоге нет. Все серверы работают без VPN. Первую загрузку через агента безопаснее сделать на тестовом сегменте из 100 строк: это минимальный объем, который принимает API.
- Для работы с сегментами и доступами нужен сервер a1 с широким доступом.
- Гео-сегменты под кампании Директа удобнее делать в Штурмане. Доступ тоже широкий.
- Для чтения отчетов команды подойдет сервер mlenkov с расширенным доступом. Он хранит OAuth-токены нескольких пользователей в общей базе, зашифрованными через Fernet.
- Для рекламы и аналитики есть отдельные страницы Яндекс Директ и Яндекс Метрика.
Риски и персональные данные
Удаление сегмента необратимо. Пиксель восстанавливается только отдельным методом API через raw_request, а этот инструмент открывает агенту и остальные методы.
CRM-файл с email и телефонами содержит персональные данные клиентов. API принимает и хешированные идентификаторы, так в файле меньше открытых данных.
Штурман пишет в боевой аккаунт Директа. Тестовой среды у Директа больше нет с июля 2026 года, поэтому любое изменение тратит реальные деньги.