Admitad через MCP: отчёты партнёрской программы без выгрузки в Excel

Обзор

Admitad — партнёрская сеть (affiliate network): рекламодатель платит публикаторам (блогерам, купонным сайтам, тематическим порталам) за целевые действия — заказ, лид, установку — а не за клики или показы. Между двумя сторонами стоит сама сеть: она считает действия, отклоняет фрод, начисляет вознаграждение и переводит деньги.

Со стороны рекламодателя это выглядит как отдельная статья маркетингового бюджета, которая живёт своей жизнью в личном кабинете — рядом с Директом и рекламными кабинетами маркетплейсов, но в собственном интерфейсе, со своими терминами (webmaster вместо публикатора в старых полях ответа, group вместо категории площадок) и без единого места, где эти цифры можно свести с остальной рекламой.

Advertiser API решает именно это — отдаёт отчёты рекламодателя программно, а не только через выгрузку CSV из кабинета.

API рекламодателя целиком: 13 действий, все на чтение

Документация Admitad недоступна на живом адресе программно — developers.admitad.com перенаправляет на developers.mitgo.com (компания сменила бренд), а тот отвечает капчей Cloudflare на любой запрос без браузера. Снимок контракта поэтому снят с последней сохранившейся копии в Wayback Machine и сверяется тестом с таблицей вызовов в обе стороны — ни одного параметра, которого нет в документации, ни одной операции без записи в таблице.

Ключевая особенность видна сразу, если сравнить это с любым другим рекламным API в MCP-сервере Mira: у Admitad нет ни одного пишущего метода. Рекламодатель не создаёт кампании и не меняет ставки через advertiser API — вся эта механика (тарифы, условия начисления, модерация публикаторов) живёт в кабинете и решениях сети, а не в вызове API. Отчёт — это всё, что отдаёт сторона рекламодателя. Барьера записи, который есть у других коннекторов Mira (Директ, VK Реклама, Ozon Performance), у Admitad поэтому нет вовсе — не потому что его забыли завести, а потому что выводить его не из чего: ни одно действие таблицы не помечено как меняющее данные.

Доступ: пара ключей и обязательный scope

Токен выпускается по OAuth2 client_credentials — так же, как у Авито и Ozon Performance в Mira: рекламодатель регистрирует приложение в кабинете, получает пару client_id/client_secret без ожидания одобрения, а токен по этой паре выпускает backend сам. Секрет не покидает Go-сервис ни при каком вызове — до модели в чате он не доезжает.

Отличие от Авито — в одном параметре. Документация Admitad помечает scope обязательным полем при выдаче токена (три права: отчёты, площадки, данные программы), тогда как у Авито и Ozon Performance выдача его не спрашивает вовсе. Mira запрашивает все три права сразу — источник один на всю партнёрскую программу, и заставлять владельца проекта решать, какого из трёх отчётов он лишится, было бы решением без причины: остаток прав ничего не стоит и ничего не открывает для записи, потому что писать через этот API некуда.

Программа — не одна на аккаунт

У Admitad номер партнёрской программы (c_id) — часть адреса почти каждого метода, а не поле формы подключения. У одного рекламодателя программ может быть несколько (разные бренды, разные сайты), и какая из них нужна прямо сейчас — решает конкретный вопрос, а не настройка источника навсегда. Поэтому в Mira c_id называется в самом вызове, а действие без номера — campaigns_info — отдаёт список всех программ пользователя разом именно затем, чтобы этот номер можно было узнать, не заходя в кабинет.

Что это даёт в чате

Подключённый Admitad доступен и в чате Mira, и через MCP-сервер в Claude, Cursor или другом клиенте, который умеет MCP:

• «Сколько мы заплатили публикаторам через Admitad за прошлый месяц и кто принёс больше всего заказов?»
• «Покажи офлайн-заказы по программе за неделю — сколько подтверждено, а сколько отклонено?»
• «Какие площадки дают конверсию выше средней и стоит ли поднять им ставку?»

Все три — чтение, и работают сразу после подключения: разрешения на запись здесь просить не у чего.

Как подключить

1. В кабинете рекламодателя (account.admitad.com/ru/advertiser/): «Мои приложения» → зарегистрировать приложение → «Получить ключи». Одобрения ждать не нужно.
2. В Mira: проект → источники → Admitad → client_id и client_secret.
3. Номер программы называть не нужно при подключении — назовите его в первом вопросе, а если не помните — спросите «какие у меня есть программы в Admitad».