Resumen
Ozon Performance API para la cuenta publicitaria del vendedor: campañas de pago por clic, de pago por pedido y de banners, sus productos y pujas, pujas de la competencia y límites de puja, estadísticas diarias y de gasto y los informes detallados de campaña. Detén campañas y cambia pujas. Un client ID y un client secret de una cuenta de servicio.
Configuración guiada
Conecta Ozon Performance a Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Ozon Performance con la configuración guiada y añade tu URL MCP a Claude. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Prueba a pedir
Prompts de ejemplo para Ozon Performance (Ads)
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Ozon Performance (Ads), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Ozon Performance (Ads) + Claude
Ozon Performance API para la cuenta publicitaria del vendedor: campañas de pago por clic, de pago por pedido y de banners, sus productos y pujas, pujas de la competencia y límites de puja, estadísticas diarias y de gasto y los informes detallados de campaña. Detén campañas y cambia pujas. Un client ID y un client secret de una cuenta de servicio.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET
Paso 1 — Obtener credenciales
La configuración lleva unos 3 minutos. Necesitas una cuenta de vendedor de Ozon con su cuenta publicitaria (Ozon Performance), donde creas una cuenta de servicio y una clave para ella.
- En el portal de vendedores de Ozon abre Settings → API keys → Performance API (seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi).
- Si todavía no hay una cuenta de servicio, crea una con Create new account. Haz clic en el nombre de la cuenta de servicio y luego en Add new key.
- Copia el client ID en
OZON_PERFORMANCE_CLIENT_ID: termina en@advertising.performance.ozon.ru, así que pégalo completo. Copia el client secret, que aparece junto al client ID al añadir la clave, enOZON_PERFORMANCE_CLIENT_SECRET. Si has perdido el secret, añade una clave nueva. - Instala el conector y comprueba la conexión con
ozon_performance_list_campaigns(sin argumentos): lista tus campañas con los ids que usan todas las demás herramientas.
Separado del conector Ozon Seller: este conector cubre solo la cuenta publicitaria y tiene sus propias credenciales, así que aquí no se usa la clave de la Seller API. Para pedidos, productos, stock y precios usa el conector Ozon Seller.
Cloud y self-hosted funcionan igual: pegas los mismos dos valores y no hay ninguna Redirect URL que configurar.
Los tokens se renuevan solos: el conector cambia el client ID y el secret en POST /api/client/token (grant type client_credentials) por un bearer token que dura 30 minutos, y pide uno nuevo antes de que caduque o tras un 401. Un 401 en el paso del token significa que el client ID o el secret son incorrectos o que la clave se eliminó: vuelve a copiar ambos o añade una clave nueva a la cuenta de servicio. Un 403 significa que la cuenta de servicio no tiene acceso a ese método o a esa campaña.
Tipos de campaña: SKU es pago por clic (Оплата за клик), SEARCH_PROMO es pago por pedido (Оплата за заказ), y además están BANNER y VIDEO_BANNER. Los productos de una campaña por clic y sus pujas salen de ozon_performance_list_campaign_products; los productos en promoción de pago por pedido, de ozon_performance_list_cpo_products.
Estadísticas rápidas: ozon_performance_get_daily_statistics, ozon_performance_get_expense_statistics y ozon_performance_get_cpc_campaign_statistics responden al momento con filas JSON. Sin fechas cubren los últimos 7 días. Las fechas son días (2026-10-01), que Ozon agrupa en hora de Moscú. ozon_performance_get_cpc_campaign_statistics no cuenta para los límites de informes.
Los informes detallados son asíncronos: ozon_performance_request_campaign_report pide un informe por producto de hasta 10 campañas para un máximo de 62 días, agrupado por día, semana o mes, y devuelve un UUID. La IA consulta ozon_performance_get_report_status cada pocos segundos hasta que state es OK (o ERROR) y luego descarga el informe con ozon_performance_download_report: texto CSV (separado por punto y coma, con nombres de columna en ruso) para una campaña, un archivo ZIP con un CSV por campaña para varias. Solo se genera un informe a la vez por cuenta, y como máximo 2000 al día; ozon_performance_list_api_reports encuentra los informes pedidos antes. ozon_performance_request_search_phrases_report funciona igual para las frases de búsqueda de la promoción en los primeros puestos, un método que Ozon marca como en pruebas.
Importes e ids: los presupuestos de campaña están en millonésimas de rublo (1000000 = 1 rublo); los límites de puja de ozon_performance_get_bid_limits están en rublos; las pujas de pago por pedido son un porcentaje del precio del producto. Los ids son cadenas numéricas.
Cambiar pujas: ozon_performance_update_campaign_bids cambia las pujas de productos que ya están en una campaña por clic, y Ozon sustituye las palabras de exclusión y las pujas por frase de la campaña por lo que se envía. ozon_performance_add_campaign_products añade como máximo 500 productos por campaña; en una campaña con estrategia automática, solo productos de su categoría de piloto automático. Una puja por clic solo se aplica con la estrategia de coste medio por clic y se indica en la misma unidad que las pujas actuales que lee el conector; sin ella, Ozon fija la puja competitiva.
Límites de solicitudes: como máximo 100.000 solicitudes al día por cuenta, más límites en los cambios de campaña (por ejemplo 500 cambios de presupuesto o de estrategia por campaña al día) y en los informes. Ante un 429, espera y vuelve a intentarlo más tarde.
Qué lee: tus campañas con tipo, estado, tipo de pago, ubicación, estrategia, fechas y presupuestos; los SKU o banners que promociona una campaña; los productos de una campaña por clic con su puja por clic, la cuota objetivo de coste publicitario o el rango de posiciones en la búsqueda; las pujas de otros vendedores para los mismos SKU, y las pujas mínimas y máximas por herramienta de promoción, ubicación y categoría; los productos en promoción de pago por pedido con precio, puja, índice de visibilidad y visualizaciones; visualizaciones, clics, gasto, pedidos y valor de los pedidos por campaña y día, el gasto dividido entre la cuenta de prepago y los bonos, los totales del periodo de las campañas por clic y los informes detallados por producto y de frases de búsqueda.
Desactivadas al instalar: ozon_performance_activate_campaign y ozon_performance_remove_campaign_products. La primera inicia una campaña, que entonces muestra anuncios y gasta su presupuesto; la segunda quita productos de una campaña por clic, y sus pujas se pierden. Activa en la página del conector solo las que necesites; la IA te pide confirmación antes de cada cambio. ozon_performance_deactivate_campaign, ozon_performance_add_campaign_products y ozon_performance_update_campaign_bids están activadas: detienen una campaña, añaden productos a una campaña por clic y cambian sus pujas, y con ello lo que gasta, siempre después de que la IA te haya mostrado exactamente qué va a cambiar.
No incluido: crear y copiar campañas, presupuestos y estrategias, cambios de pujas de pago por pedido, estadísticas de banners y vídeo, informes de atribución de pedidos y analítica de tráfico externo.
Paso 2 — Instalar el adapter
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
Paso 3 — Añadir el conector en Claude
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
Ozon Performance (Ads), y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| Tool | What it does |
|---|---|
ozon_performance_list_campaigns | List the advertising campaigns of the Ozon seller account: id, title, state (CAMPAIGN_STATE_RUNNING, _STOPPED, _PLANNED, _INACTIVE… |
ozon_performance_list_campaign_objects | List the promoted objects of a pay-per-click, banner or video banner campaign: the SKUs (or banner ids) it advertises |
ozon_performance_list_campaign_products | List the products of a pay-per-click campaign with their bids: SKU, title, bid per click (average click cost strategy), target ad cost… |
ozon_performance_get_competitive_bids | Get the competitive bids for up to 200 products of a pay-per-click campaign: the bid other sellers place, per SKU |
ozon_performance_get_bid_limits | Get the minimum and maximum bids in rubles for each promotion tool (pay per click, pay per order) and placement, and the minimum bid of the… |
ozon_performance_list_cpo_products | List the products in pay-per-order promotion (Оплата за заказ, selected products): SKU, seller article, title, price, bid as a percent of… |
ozon_performance_get_daily_statistics | Get daily statistics per campaign as JSON rows: campaign id and title, date, views, clicks, spend in rubles, orders and order value |
ozon_performance_get_expense_statistics | Get campaign spend per day as JSON rows: campaign id, date, title, total spend, spend from the prepaid account and spend paid with bonuses |
ozon_performance_get_cpc_campaign_statistics | Get the totals of pay-per-click campaigns for a period as JSON: per campaign its title, object type, status, budget, views, clicks, spend… |
ozon_performance_request_campaign_report | Order a detailed statistics report for up to 10 campaigns over at most 62 days, per product and grouped by day, week or month |
ozon_performance_request_search_phrases_report | Order a report of the search phrases that showed the products of pay-per-click campaigns placed in top promotion (Ozon marks this method as… |
ozon_performance_get_report_status | Get the status of an ordered report by its UUID: state NOT_STARTED, IN_PROGRESS, ERROR (with error) or OK (with link), the report kind and… |
ozon_performance_download_report | Download a finished report by its UUID once ozon_performance_get_report_status shows state OK |
ozon_performance_list_api_reports | List the reports ordered through the API by this service account: UUID, state, kind, campaigns, request period and link |
ozon_performance_add_campaign_products | Add products to a pay-per-click campaign (at most 500 products per campaign), each with an optional bid |
ozon_performance_update_campaign_bids | Change the bids of products already in a pay-per-click campaign |
ozon_performance_remove_campaign_products | Remove products from a pay-per-click campaign; their bids are lost |
ozon_performance_deactivate_campaign | Stop a running campaign (Выключить кампанию): it stops showing and spending until activated again |
ozon_performance_activate_campaign | Start a campaign (Активировать кампанию): it starts showing ads and spending the budget |
Ejemplos de prompts
- "¿Qué campañas publicitarias de Ozon tengo activas ahora mismo y cuál es su presupuesto diario?"
- "¿Cuánto gastó cada campaña al día la semana pasada y cuánto de eso se pagó con bonos?"
- "Compara las pujas actuales de mi campaña de pago por clic con las pujas de la competencia para los mismos SKU."
- "Pide un informe detallado por producto de mis campañas por clic de octubre, agrupado por semana, y resúmelo."
- "¿Qué productos en promoción de pago por pedido tienen la puja más alta en porcentaje del precio y cuántas visualizaciones tuvieron esta semana?"
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
- Página del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?