Ozon Performance MCP-сервер: реклама и отчёты

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Ozon Performance (Ads), вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Ozon Performance (Ads)

Ozon Performance API для рекламного кабинета продавца: кампании с оплатой за клик и за заказ и баннерные кампании, их товары и ставки, конкурентные ставки и лимиты ставок, дневная статистика и статистика расходов, подробные отчёты по кампаниям. Остановка кампаний и изменение ставок. Один client ID и client secret сервисного аккаунта.

Настройка

Настройка занимает около 3 минут. Нужен аккаунт продавца Ozon с рекламным кабинетом (Ozon Performance), в котором вы создаёте сервисный аккаунт и ключ к нему.

1. В личном кабинете продавца Ozon откройте Настройки → API-ключи → Performance API (seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi).
2. Если сервисного аккаунта ещё нет, создайте его. Нажмите на название сервисного аккаунта и добавьте новый ключ.
3. Скопируйте client ID в OZON_PERFORMANCE_CLIENT_ID: он заканчивается на @advertising.performance.ozon.ru, поэтому вставляйте его целиком. Client secret, который показывается вместе с client ID при добавлении ключа, скопируйте в OZON_PERFORMANCE_CLIENT_SECRET. Если secret потерян, добавьте новый ключ.
4. Установите коннектор и проверьте подключение через ozon_performance_list_campaigns (без аргументов): он выводит ваши кампании с id, которые нужны всем остальным инструментам.

Отдельно от коннектора Ozon Seller: этот коннектор работает только с рекламным кабинетом и использует собственные учётные данные, ключ Seller API здесь не нужен. Для заказов, товаров, остатков и цен используйте коннектор Ozon Seller.

Cloud и self-hosting работают одинаково: вы вводите те же два значения, а Redirect URL настраивать не нужно.

Токены обновляются сами: коннектор обменивает client ID и secret через POST /api/client/token (grant type client_credentials) на bearer-токен, который действует 30 минут, и получает новый до истечения срока или после ответа 401. 401 при получении токена означает, что client ID или secret неверны либо ключ удалён: скопируйте оба значения заново или добавьте сервисному аккаунту новый ключ. 403 означает, что у сервисного аккаунта нет доступа к этому методу или кампании.

Типы кампаний: SKU — оплата за клик, SEARCH_PROMO — оплата за заказ, а также BANNER и VIDEO_BANNER. Товары кампании с оплатой за клик и их ставки отдаёт ozon_performance_list_campaign_products, товары в продвижении с оплатой за заказ — ozon_performance_list_cpo_products.

Быстрая статистика: ozon_performance_get_daily_statistics, ozon_performance_get_expense_statistics и ozon_performance_get_cpc_campaign_statistics сразу отвечают строками JSON. Без дат они охватывают последние 7 дней. Даты указываются днями (2026-10-01), Ozon группирует их по московскому времени. ozon_performance_get_cpc_campaign_statistics не расходует лимиты на отчёты.

Подробные отчёты формируются асинхронно: ozon_performance_request_campaign_report заказывает отчёт по товарам максимум для 10 кампаний за период не больше 62 дней с группировкой по дням, неделям или месяцам и возвращает UUID. ИИ каждые несколько секунд проверяет ozon_performance_get_report_status, пока state не станет OK (или ERROR), а затем забирает отчёт через ozon_performance_download_report: CSV-текст (разделитель точка с запятой, названия столбцов на русском) для одной кампании, ZIP-файл с отдельным CSV на каждую кампанию для нескольких. В одном аккаунте одновременно формируется только один отчёт, и не больше 2000 в день; ozon_performance_list_api_reports находит заказанные ранее отчёты. ozon_performance_request_search_phrases_report работает так же для поисковых фраз вывода в топ; Ozon помечает этот метод как тестируемый.

Деньги и id: бюджеты кампаний указываются в миллионных долях рубля (1000000 = 1 рубль); лимиты ставок из ozon_performance_get_bid_limits — в рублях; ставки с оплатой за заказ — в процентах от цены товара. Id — строки из цифр.

Изменение ставок: ozon_performance_update_campaign_bids меняет ставки товаров, которые уже есть в кампании с оплатой за клик, и Ozon заменяет стоп-слова и ставки по фразам кампании тем, что отправлено. ozon_performance_add_campaign_products добавляет не больше 500 товаров в кампанию; в кампанию с автоматической стратегией — только товары её категории автопилота. Ставка за клик действует только при стратегии средней стоимости клика и указывается в тех же единицах, что и текущие ставки, которые читает коннектор; без неё Ozon ставит конкурентную ставку.

Лимиты запросов: не больше 100 000 запросов в день на аккаунт, плюс лимиты на изменения кампаний (например, 500 изменений бюджета или стратегии на кампанию в день) и на отчёты. При ответе 429 подождите и повторите позже.

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

Отключено при установке: ozon_performance_activate_campaign и ozon_performance_remove_campaign_products. Первый запускает кампанию, после чего она показывает рекламу и тратит бюджет; второй убирает товары из кампании с оплатой за клик, и их ставки теряются. Включайте на странице коннектора только нужные; перед каждым изменением ИИ спрашивает ваше подтверждение. ozon_performance_deactivate_campaign, ozon_performance_add_campaign_products и ozon_performance_update_campaign_bids включены: они останавливают кампанию, добавляют товары в кампанию с оплатой за клик и меняют её ставки, а значит, и расходы, всегда после того, как ИИ точно показал вам, что изменится.

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

Предварительные требования: OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите Ozon Performance (Ads) и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

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

• «Какие из моих рекламных кампаний на Ozon сейчас запущены и какой у них дневной бюджет?»
• «Сколько каждая кампания тратила в день на прошлой неделе и сколько из этого оплачено бонусами?»
• «Сравните текущие ставки в моей кампании с оплатой за клик с конкурентными ставками на те же SKU.»
• «Закажите подробный отчёт по товарам для моих кампаний с оплатой за клик за октябрь с группировкой по неделям и кратко изложите его.»
• «У каких товаров в продвижении с оплатой за заказ самая высокая ставка в процентах от цены и сколько показов у них было на этой неделе?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT