Ozon Performance API через MCP: 46 методов, асинхронные отчёты и барьер на восьми платных действиях

Обзор

У продавцов на Ozon часто путаются два разных API под одним названием площадки. Ozon Seller API — это продажи: товары, остатки, заказы, финансы. Ozon Performance API — это реклама: кампании, ставки, бюджеты, статистика показов. У них разные ключи (Client ID и Client Secret выпускаются в разных кабинетах — seller.ozon.ru и performance.ozon.ru), разный хост и разный токен. Ключ от одного не подойдёт к другому.

Mira подключает Performance API целиком — 46 методов в шести разделах — и отдаёт его в Claude через MCP. Ниже — что там есть, чем он отличается от привычных синхронных API и почему часть вещей стоит знать заранее.

Что доступно рекламодателю

Устройство, которое стоит знать заранее

API асинхронный — почти буквально везде

Запрос отчёта не возвращает отчёт. Он возвращает UUID. Дальше нужно опрашивать статус («ещё формируется», «готов», «ошибка») и по готовности скачивать файл отдельным запросом. Так устроены почти все отчёты — по кампаниям, по видеобаннерам, по поисковым фразам, по внешнему трафику для вендоров.

Через MCP это скрыто одним составным действием: wait_for_report принимает UUID запроса, опрашивает готовность несколько раз с паузой и, когда отчёт готов, сам его скачивает. Отдельные действия для каждого шага тоже доступны — когда нужен контроль, а не удобство.

Три единицы измерения денег в одном API

Бюджет кампании — целое число, одна миллионная доля рубля: 500 000 000 означает 500 рублей. Ставка за клик — та же шкала. А вот ставка в продвижении «Оплата за заказ» — это процент от цены товара, а не деньги вовсе. Спутать их — значит либо выставить кампании бюджет в полмиллиона раз меньше нужного, либо назначить «ставку» в рублях там, где поставщик ждёт проценты.

Общего правила у поставщика нет, и выдумывать его нельзя — это тот же урок, что был с копейками и рублями у Авито. Единица названа в описании каждого действия.

Синхронные отчёты отдают CSV — а нужен JSON

Часть отчётов не асинхронная: дневная статистика, расход по дням, статистика по медийным и товарным кампаниям приходят сразу, без UUID. Но по умолчанию — файлом CSV. У поставщика есть отдельный адрес с суффиксом /json для того же метода, который возвращает структурированные строки вместо текста. В инструменте Mira это не настройка — эти четыре метода всегда идут по адресу /json: агенту нужны данные для счёта, а не текст файла для чтения глазами.

Отказ — одна форма на всё

В отличие от некоторых площадок, где форма отказа отличается по разделам, у Ozon Performance один конверт: {"error": "текст"}. Разбирать его нужно один раз, и причина не теряется ни в одном из 46 методов.

Как это выглядит через MCP

Сколько мы потратили на рекламу на Ozon за август?

Claude запрашивает дневную статистику по расходу, получает структурированные строки вместо CSV-файла и считает сумму без единицы, перепутанной местами.

Заказать отчёт по кампании 12345 за прошлую неделю и дождаться результата

Claude заказывает отчёт, опрашивает готовность через составное действие и возвращает файл, когда тот готов — без ручного «проверьте ещё раз через минуту».

Что защищено от случайного действия

Из 46 методов 15 меняют данные, 8 из них — тратят деньги или запускают показы: активация кампании, правка бюджета, добавление и правка ставок, включение продвижения. Барьер записи выведен из той же таблицы, где описан каждый метод — разойтись им негде, и это то же устройство, что у Авито и Ozon Seller в Mira.

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

Что это даёт на практике

Продавцу. Расход и эффективность рекламы одним вопросом, без захода в кабинет продвижения — который к тому же отдельный от кабинета продаж.

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

Разработчику. Готовый клиент вместо разбора двух разных единиц измерения денег и ручного цикла опроса статуса отчёта.

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

1. Кабинет продвижения (performance.ozon.ru) → Настройки → API-ключи → создать сервисный аккаунт.
2. Скопировать Client ID и Client Secret — это отдельная пара от ключа Ozon Seller.
3. В Mira: проект → источники → Ozon Performance → вставить оба ключа.

Дальше Ozon Performance доступен и в чате Mira, и через MCP-сервер в Claude, Cursor или другом клиенте с поддержкой протокола.