Inteligencia de Ozon MP
API de productos por marca de Ozon MCP
Listar productos bajo una marca Ozon con ventas, ingresos, precio, puntuación, stock, volumen de negocios y métricas de ingresos perdidos para marca. Disponible REST API o MCP.
Prompts y casos de uso de API de productos por marca de Ozon
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Productos de revisión vendidos bajo una marca Ozon
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Investigación en una moneda seleccionada
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Presentar los valores monetarios disponibles [my selected currency], utilizando [my supplied conversion rate] sólo si la herramienta requiere uno. No compare las cantidades en diferentes monedas.
3. Investigación en una moneda seleccionada para esta búsqueda
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Presentar los valores monetarios disponibles [my selected currency], utilizando [my supplied conversion rate] sólo si la herramienta requiere uno. No compare las cantidades en diferentes monedas.
4. Revise un período específico de presentación de informes
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales.
5. Continuar los resultados dentro de un límite de página
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Inicio [my selected page] y retorno [my requested page size] dentro de los límites documentados. Pregunte antes de solicitar otra página y no describa una página como conjunto de datos completo.
6. Priorizar los resultados para la revisión
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Prioridad [my chosen ranking metric] dentro [my chosen order]. Mantenga la clasificación limitada a los filtros seleccionados y el período de presentación de informes.
7. Incluir listas llenas de vendedores
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Incluye listados llenos de vendedores en la investigación. Informe sólo lo que los registros seleccionados soportan.
8. Buscar productos Reunir todos los filtros numéricos
Prompt: Productos de revisión vendidos bajo una marca Ozon para [brand name]. Mantener productos que satisfagan todos [my numeric conditions]: una medida puede estar por encima, por lo menos, por debajo, por lo menos igual, diferente de, o entre [my selected bounds]. Para una condición entre, suministre los límites inferiores y superiores. Las medidas respaldadas incluyen ventas, precio final, calificación, comentarios, balance de acciones, ingresos, días en stock, días de facturación, lucro perdido y posición de categoría.
Qué debes proporcionar
Sustituye las entradas entre corchetes por tus propios valores. Usa únicamente los mercados, períodos y formatos de entrada documentados.
Las estimaciones y clasificaciones devueltas corresponden a los datos y al período seleccionados. Un valor ausente no equivale a cero y una página de resultados no representa todo el mercado.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_ozon_brand_productshttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "ozon-brand-products-1",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_brand_products",
"arguments": {
"brandName": "COMMO",
"currencyRate": 1,
"endDate": "2026-01-31",
"includeFbs": false,
"page": 1,
"pageSize": 100,
"startDate": "2026-01-01"
}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
brandName | string | obligatorio | Nombre de la marca Ozon (ruso o latín) Ejemplo: COMMO |
startDate | string | opcional | Fecha de inicio de las estadísticas, YYYY-MM-DD; último es ayer Ejemplo: 2026-01-01 |
endDate | string | opcional | Fecha final de las estadísticas, YYYY-MM-DD; último es ayer Ejemplo: 2026-01-01 |
page | integer | opcional | Número de página, a partir de 1 Ejemplo: 1 |
pageSize | integer | opcional | Filas por página, 1-100, por defecto 100 Ejemplo: 100 |
sortField | string | opcional | Nombre de la columnasnake_case), e.g., ventas, ingresos, final_price, balance, calificación |
sortDirection | string | opcional | asc ascendente / desc descendente |
currency | string | opcional | Código de moneda para las cantidades de resultado, predeterminado RUB, e.g., USD / EUR / CNY Ejemplo: RUB |
currencyRate | integer | opcional | Tipo de cambio personalizado (para moneda no predeterminada) Ejemplo: 1 |
includeFbs | boolean | opcional | Ya sea para incluir FBS datos Ejemplo: false |
filters | array | opcional | Condiciones numéricas combinadas con AND Ejemplo: [] |
filters[].field | string | opcional | Snake-case numeric column name, such as sales, final_price, puntuación, comentarios, balance, revenue, days_in_stock, turnover_days, lost_profit o category_position Ejemplo: sales |
filters[].op | string | opcional | GTE, LTE, GT, LT, EQ, NOT_EQ o BETWEEN Ejemplo: GTE |
filters[].value | number | opcional | Valor primario; límite inferior BETWEEN Ejemplo: 1 |
filters[].value2 | number | opcional | Límite superior requerido para BETWEEN Ejemplo: 2 |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Código de devolución, `"200"` éxito |
msg | string | opcional | Mensaje; éxito `ok` |
total | integer | opcional | El número total de golpes bajo la marca |
products | array | opcional | Lista de productos |
columns | array | opcional | Definición de columna |
costTime | integer | opcional | Tiempo de interfase (milliseconds) |
costToken | integer | opcional | Cantidad de Token consumida |
type | string | opcional | tipo de respuesta |
productId | integer | opcional | SKU ID |
title | string | opcional | Nombre del producto (ruso) |
brand | string | opcional | marca |
brandId | integer | opcional | Marca ID |
sellerName | string | opcional | Nombre del vendedor |
sellerId | integer | opcional | Vendedor ID |
category | string | opcional | Carril de categoría (ruso, ruso) `/` separados) |
nicheName | string | opcional | Track path (ruso) |
nicheId | integer | opcional | Pista ID |
country | string | opcional | País de venta, Ozon Hengwei `RU` |
firstDate | string | opcional | Fecha de lanzamiento (`yyyy-MM-dd`) |
imageUrl | string | opcional | Imagen principal URL |
productPageUrl | string | opcional | Página de producto URL |
price | number | opcional | Precio de venta actual |
oldPrice | number | opcional | Precio original antes del descuento |
ozonCardPrice | number | opcional | Ozon Card Price |
currency | string | opcional | Símbolo de moneda (`₽` / `$` / `€`) |
rating | number | opcional | Valoración, 0-5 |
reviewCount | integer | opcional | Número de comentarios |
balance | integer | opcional | Inventario actual |
balanceFbs | integer | opcional | FBS inventario (número de artículos enviados por el vendedor) |
frozenStocks | integer | opcional | inventario lento |
warehousesCount | integer | opcional | Número de FBO posiciones |
isFbs | boolean | opcional | Ya sea para enviar por FBS |
salesPerDay | number | opcional | Volumen promedio de ventas diarias (pieces/day) |
monthlySalesUnits | integer | opcional | Volumen de ventas durante el período estadístico |
monthlySalesRevenue | number | opcional | Ventas durante el período estadístico |
lostProfit | number | opcional | Las ventas perdidas (causadas por acciones, etc.) |
daysInSite | integer | opcional | Número de días en venta (período estadístico, incluidos días fuera de existencia) |
daysInStock | integer | opcional | días en stock |
turnoverDays | number | opcional | Días de giro (los más pequeños, más rápidos) |
position | integer | opcional | Clasificación dentro de la dimensión actual de la consulta (este punto final es marca) |
categoryPosition | integer | opcional | Ranking dentro de la categoría |
revenueSharePercent | number | opcional | La relación de ventas de este SKU en la dimensión actual de la consulta, 0-100 |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Revise productos vendidos bajo una marca Ozon. Use nombre de marca COMMO.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra el título: Ejemplo producto; producto id: 10; precio: 19.99. Estas cifras describen sólo el registro mostrado. A partir de este ejemplo, no se pueden calcular las medidas que faltan.
Sobre esta muestra: Ejemplo ilustrativo con registros ficticios; no procede de una llamada real. Los identificadores, precios y recuentos son datos de demostración.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "ozon-brand-products-example",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_brand_products",
"arguments": {
"brandName": "COMMO",
"currencyRate": 1,
"endDate": "2026-01-31",
"includeFbs": false,
"page": 1,
"pageSize": 100,
"startDate": "2026-01-01"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "ozon-brand-products-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"Example product\",\"productId\":10,\"sellerId\":10,\"price\":19.99}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"title": "Example product",
"productId": 10,
"sellerId": 10,
"price": 19.99
}
]
}
},
"isError": false
}
}