Yandex Audience MCP Server

Yandex Audience MCP

MCP-сервер для Яндекс Аудиторий: управляйте сегментами, пикселями и похожими аудиториями — из Claude, Cursor, Codex и других AI-клиентов на естественном языке.

Ассистент сам загрузит CRM-базу и сохранит её сегментом, построит lookalike нужной точности, создаст пиксель и сегмент «видевших баннер», раздаст доступы коллегам — то, что в вебе Аудиторий приходится делать вручную по нескольким экранам.

Быстрый старт

1. Получите OAuth-токен Яндекса с правами на Аудитории.

2. Добавьте сервер — например, в Claude Code (другие клиенты):

   claude mcp add yandex-audience \
     -e YANDEX_AUDIENCE_TOKEN=ваш_токен \
     -- npx -y mcp-yandex-audience
   

3. Спросите ассистента: «Покажи мои сегменты в Аудиториях и их статусы»

Что умеет

• Сегменты — list_segments (все типы со статусами), rename_segment, delete_segment.
• Сегменты из файлов — upload_segment_file (device id / MAC / SHA256-хеши) и upload_segment_csv_file (CRM-данные: email, телефоны) + confirm_segment — двухфазное создание «загрузил → сохранил с именем и типом».
• Lookalike — create_lookalike_segment: похожие аудитории со степенью точности 1..5.
• Пиксели — list_pixels (с охватами за 7/30/90 дней), create_pixel, update_pixel, delete_pixel и create_pixel_segment — сегменты из видевших баннер (период, частота, UTM).
• Доступы — list_segment_grants, add_segment_grant, delete_segment_grant: выдача и отзыв прав edit/view на сегмент по логину.
• Универсальный raw_request — прямой вызов любого пути API (пересчёт сегмента, восстановление пикселя, аккаунты-представители и т.д.).
• Устойчивость — ретраи на 429 с бэкоффом (на 5xx — только для чтения), таймаут запроса.

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

Попросите ассистента на русском — например:

• «Покажи мои сегменты в Аудиториях и их статусы»
• «Загрузи файл clients.csv как сегмент "Клиенты 2026" с CRM-данными»
• «Создай lookalike на сегмент "Покупатели" со степенью похожести 2»
• «Создай пиксель "Промо октябрь" и сегмент всех, кто видел его за 30 дней»
• «Выдай логину team-lead доступ на просмотр сегмента 12345»

Доступ к API

Сервер работает через API Яндекс Аудиторий (хост api-audience.yandex.ru, авторизация OAuth-токеном в заголовке Authorization: OAuth <token>). Токен привязан к аккаунту Яндекса — сервер видит те же сегменты и пиксели, что и владелец токена в вебе Аудиторий (включая доверенные сегменты).

Установка

claude mcp add yandex-audience \
  -e YANDEX_AUDIENCE_TOKEN=ваш_токен \
  -- npx -y mcp-yandex-audience

claude_desktop_config.json — macOS ~/Library/Application Support/Claude/, Windows %APPDATA%\Claude\

{
  "mcpServers": {
    "yandex-audience": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-audience"],
      "env": { "YANDEX_AUDIENCE_TOKEN": "ваш_токен" }
    }
  }
}

~/.cursor/mcp.json (или .cursor/mcp.json в проекте)

{
  "mcpServers": {
    "yandex-audience": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-audience"],
      "env": { "YANDEX_AUDIENCE_TOKEN": "ваш_токен" }
    }
  }
}

.vscode/mcp.json — ключ servers (не mcpServers)

{
  "servers": {
    "yandex-audience": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-audience"],
      "env": { "YANDEX_AUDIENCE_TOKEN": "ваш_токен" }
    }
  }
}

Получение доступа

1. Зарегистрируйте приложение на oauth.yandex.ru/client/new и отметьте права Яндекс Аудиторий:
   • «создание сегментов, изменение параметров настройки своих и доверенных сегментов»;
   • «чтение параметров настройки своих и доверенных сегментов».
2. Получите OAuth-токен для этого приложения — проще всего отладочный токен из руководства по OAuth.
3. Запишите токен в YANDEX_AUDIENCE_TOKEN.

⚠️ Токен хранится открытым текстом в конфиге клиента — относитесь как к паролю.

Настройка

Требования

• Node.js 20+ (запускается через npx, отдельная установка не нужна).
• Аккаунт Яндекс Аудиторий и OAuth-токен — см. Получение доступа.

Ограничения

• Это write-API. Инструменты создают, изменяют и удаляют сегменты/пиксели; удаление сегмента необратимо. Инструменты размечены MCP-аннотациями (read-only / write / destructive) — клиенты могут запрашивать подтверждение.
• Квоты API: не более 30 запросов/сек с IP, 5000 запросов/сутки на логин; создание/изменение сегментов — 10/мин, 100/час, 500/сутки. Ошибочные запросы тоже расходуют квоту; при превышении API возвращает 429.
• Файлы сегментов: до 1 ГБ, минимум 100 записей (обходится check_size=false при сохранении), хеши — только SHA256 (MD5 не принимается с 01.01.2025).

Документация

• Все инструменты — полный список с описанием.
• Разработка — сборка, тесты, smoke-проверка.
• Публикация — релиз и листинг в каталогах MCP.

Смотрите также

• Ask Ads — чат-аналитик и «Сторож» рекламных кабинетов от авторов этого сервера: алерты о сливах бюджета и поломках трекинга — в Telegram.
• askads/claude-plugins — маркетплейс плагинов Claude: серверы Ask Ads ставятся одной командой, токены спрашиваются при включении.

Поддержка

Вопросы, идеи и доработки — пишите в Telegram: @gistrec.

Лицензия

MIT — см. LICENSE.