Inteligencia de Ozon SR

API de búsqueda de tiendas de Ozon MCP

Analizar los productos de una tienda de Ozon por tienda ID. Los resultados se devuelven como datos JSON estructurados. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.

CosteRecent Avg. 32 · Range 25–32 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de búsqueda de tiendas 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. Analizar los productos de una tienda de Ozon por tienda ID

Prompt: Analizar los productos de una tienda de Ozon por tienda ID para [record ID]. Mostrar los resultados disponibles e identificar claramente la información que falta. Recuperar página 1 con hasta 20 resultados y preguntar antes de continuar a otra página.

2. Continuar los resultados dentro de un límite de página

Prompt: Analizar los productos de una tienda de Ozon por tienda ID para [record ID]. Inicio [my selected page] y solicitar no más de 20 resultados. Pregunte antes de solicitar otra página y no describa una página como conjunto de datos completo.

3. Priorizar los resultados para la revisión

Prompt: Analizar los productos de una tienda de Ozon por tienda ID para [record ID]. 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. Recuperar página 1 con hasta 20 resultados y preguntar antes de continuar a otra página. Rancho por ventas, precio, calificación de revisión, tiempo de subida en orden ascendente o descendente.

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/json

Autenticació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

Nombre de la herramienta MCP

nexscope_ozon_shop_search

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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-shop-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_shop_search",
    "arguments": {
      "id": 1581151,
      "page": {
        "page": 1,
        "pageSize": 10
      }
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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
`id`	`integer`	obligatorio	Tienda (vendedor) ID, i.e., el sellerId devuelto por otro Nexscope Herramientas del Ozon; valores negativos son vendedores autooperados de la plataforma del Ozon (e.g., -2 Ozon Express, -4 Ozon Fresh), valores positivos son vendedores externos Ejemplo: 1581151
`page`	`object`	obligatorio	Clasificación: {page, pageSize, orders[]} Ejemplo: { "page": 1, "pageSize": 10 }
`page.page`	`integer`	opcional	Número de página, a partir de 1, predeterminado 1 Ejemplo: 1
`page.pageSize`	`integer`	opcional	Artículos por página, predeterminado 20, máximo 20 (excediendo devoluciones errcode 1002) Ejemplo: 1
`page.orders`	`array`	opcional	Ordenar reglas, elementos {field, direction}; la dirección toma DESC (descendente) / ASC (ascendente). Campos comunes: ventas, precio, reviewRating, upTime Ejemplo: []
`uId`	`string`	opcional	Usuario ID (max 1000) Ejemplo: example-id
`memberId`	`string`	opcional	Miembro ID (un identificador miembro único; un usuario puede pertenecer a múltiples equipos; los datos se atribuyen a memberId, max 1000) Ejemplo: example-id

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"` indica éxito; devuelto cuando tenga éxito.
`errcode`	`integer`	opcional	Código de error `200` indica el éxito; sólo este campo puede ser devuelto cuando hay un error de negocio.
`msg`	`string`	opcional	Mensaje; El éxito `ok`.
`errmsg`	`string`	opcional	Mensaje de error; éxito `ok`, error de negocio es una descripción de la razón.
`total`	`integer`	opcional	El número de registros devueltos en esta página es igual al número de datos en la página actual, no al número total de artículos en la tienda.
`totalSales`	`integer`	opcional	El volumen total de ventas de la tienda en los últimos 30 días.
`totalRevenue`	`integer`	opcional	Ventas totales en rublos.
`dailySales`	`integer`	opcional	El volumen promedio de ventas diarias de la tienda.
`rating`	`number`	opcional	Nota de la tienda, 0-5.
`productCount`	`integer`	opcional	El número total de productos en la tienda, toda la tienda, no el número de artículos en la página actual.
`fulfillment`	`object`	opcional	La distribución de los métodos de entrega de la tienda, la clave es `FBO` / `FBS`, y el valor es el número de productos correspondientes; es diferente de la matriz de entrega de nivel de producto.
`data`	`array`	opcional	La lista de productos de la tienda, los campos de elementos se muestran en la tabla siguiente.
`products`	`array`	opcional	La lista de productos de la tienda es totalmente consistente con el contenido de `data`.
`hasNextPage`	`boolean`	opcional	¿Hay una página siguiente?
`columns`	`array`	opcional	Definición de columna, elementos que contienen `field`, `title`, `cellType`, `sortable`, `filterable`.
`type`	`string`	opcional	Tipo de pantalla de respuesta, como `productWorkbenches`.
`costTime`	`integer`	opcional	La interfaz consume tiempo en milisegundos.
`costToken`	`integer`	opcional	El número de fichas consumidas.
`productId`	`integer`	opcional	Producto unificado ID, mapeado desde `sku`.
`sku`	`integer`	opcional	Producto SKU.
`rating`	`number`	opcional	Anotación unificada, mapeado desde `reviewRating`.
`reviewRating`	`number`	opcional	Evaluaciones de productos.
`weight`	`number`	opcional	Peso del producto, unidad g.
`sales`	`integer`	opcional	Venta de productos en los últimos 30 días.
`monthlySalesUnits`	`integer`	opcional	Ventas mensuales unificadas, mapeadas desde `sales`.
`upTime`	`integer`	opcional	Tiempo de estante de producto, milisegundos tiempos.
`price`	`number`	opcional	Precio de productos básicos en rublos.
`currency`	`string`	opcional	Moneda fija `₽`.
`imageUrl`	`string`	opcional	Unificar la imagen principal URL.
`fulfillment`	`array`	opcional	Método de envío de productos, como `["FBO"]`, puede contener múltiples valores.
`sellerType`	`integer`	opcional	Tipo de vendedor: `0` local, `1` transfronterizo.
`returnCancellationRate`	`number`	opcional	Tasa de cancelación de la devolución del producto, porcentaje; puede faltar para los vendedores autooperados en la plataforma Ozon.
`sourceType`	`string`	opcional	Fuente de datos fijada `ozon`.

Preguntas y respuestas de ejemplo

Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.

Tu pregunta

Analizar los productos de una tienda de Ozon por tienda ID. Registro de uso ID 2574278.

Respuesta de ejemplo

En la muestra publicada, su precio reportado es 1947. Su calificación notificada es 4.7. Sus unidades de ventas mensuales notificadas son 160. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes mostrados.

Sobre esta muestra: Extracto de la documentación publicada, no de una consulta en vivo. Las listas muestran como máximo dos registros y algunos textos largos pueden estar abreviados. Si faltan unidades, fechas o datos sobre la cobertura, el extracto no permite determinarlos ni representa el conjunto de datos completo. Los campos opcionales con conflictos de cadena-versus-número en la documentación fuente se omiten de esto MCP extracto; la muestra original permanece inalterada en la evidencia fuente.

Ver los datos de ejemplo publicados (JSON)

Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.

Ejemplo de datos

Ejemplo de solicitud y respuesta

Parámetros de solicitud

{
  "id": 2574278,
  "page": {
    "page": 1,
    "pageSize": 20,
    "orders": [
      {
        "field": "sales",
        "direction": "DESC"
      }
    ]
  }
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": [
      {
        "productId": "5315093530",
        "rating": 4.7,
        "weight": 530,
        "reviewRating": 4.7,
        "sales": 160,
        "upTime": "1785618000000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 24.7,
        "sourceType": "ozon",
        "price": 1947,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "5315093530",
        "sellerType": 0,
        "monthlySalesUnits": 160
      },
      {
        "productId": 2011308439,
        "rating": 4.8,
        "weight": 375,
        "reviewRating": 4.8,
        "sales": 137,
        "upTime": "1744059600000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 18.7,
        "sourceType": "ozon",
        "price": 1535,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": 2011308439,
        "sellerType": 0,
        "monthlySalesUnits": 137
      },
      {
        "productId": "5315408758",
        "rating": 4.4,
        "weight": 340,
        "reviewRating": 4.4,
        "sales": 78,
        "upTime": "1785618000000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 19.7,
        "sourceType": "ozon",
        "price": 1350,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-0/wc300/14422246380.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "5315408758",
        "sellerType": 0,
        "monthlySalesUnits": 78
      },
      {
        "productId": "3142595615",
        "rating": 4.9,
        "weight": 400,
        "reviewRating": 4.9,
        "sales": 3,
        "upTime": "1763758800000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 33.4,
        "sourceType": "ozon",
        "price": 1482,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-j/wc300/9078178987.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "3142595615",
        "sellerType": 0,
        "monthlySalesUnits": 3
      },
      {
        "productId": "3142595707",
        "rating": 4.9,
        "weight": 400,
        "reviewRating": 4.9,
        "sales": 1,
        "upTime": "1763758800000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 0,
        "sourceType": "ozon",
        "price": 1332,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-h/wc300/9078182873.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "3142595707",
        "sellerType": 0,
        "monthlySalesUnits": 1
      }
    ],
    "hasNextPage": false,
    "columns": [
      {
        "filterable": true,
        "cellType": "number",
        "field": "sku",
        "sortable": true,
        "title": "商品SKU"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "商品价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sales",
        "sortable": true,
        "title": "商品近30天销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "returnCancellationRate",
        "sortable": true,
        "title": "商品退货取消率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewRating",
        "sortable": true,
        "title": "商品评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sellerType",
        "sortable": true,
        "title": "商品卖家类型，0本土，1跨境"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "fulfillment",
        "sortable": true,
        "title": "商品配送方式"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "weight",
        "sortable": true,
        "title": "商品重量，单位g"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "upTime",
        "sortable": true,
        "title": "商品上架时间，毫秒时间戳"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "productId",
        "sortable": true,
        "title": "统一商品ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productPageUrl",
        "sortable": true,
        "title": "统一商品页URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "统一主图URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brand",
        "sortable": true,
        "title": "统一品牌"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "rating",
        "sortable": true,
        "title": "统一评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "monthlySalesUnits",
        "sortable": true,
        "title": "统一月销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "monthlySalesRevenue",
        "sortable": true,
        "title": "统一月销售额"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "数据源"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "currency",
        "sortable": true,
        "title": "币种"
      }
    ],
    "dailySales": 13,
    "rating": 4.8,
    "totalSales": 379,
    "type": "productWorkbenches",
    "productCount": 5,
    "products": [
      {
        "productId": "5315093530",
        "rating": 4.7,
        "weight": 530,
        "reviewRating": 4.7,
        "sales": 160,
        "upTime": "1785618000000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 24.7,
        "sourceType": "ozon",
        "price": 1947,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-b/wc300/13354954211.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "5315093530",
        "sellerType": 0,
        "monthlySalesUnits": 160
      },
      {
        "productId": 2011308439,
        "rating": 4.8,
        "weight": 375,
        "reviewRating": 4.8,
        "sales": 137,
        "upTime": "1744059600000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 18.7,
        "sourceType": "ozon",
        "price": 1535,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-o/wc300/7450884744.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": 2011308439,
        "sellerType": 0,
        "monthlySalesUnits": 137
      },
      {
        "productId": "5315408758",
        "rating": 4.4,
        "weight": 340,
        "reviewRating": 4.4,
        "sales": 78,
        "upTime": "1785618000000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 19.7,
        "sourceType": "ozon",
        "price": 1350,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-0/wc300/14422246380.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "5315408758",
        "sellerType": 0,
        "monthlySalesUnits": 78
      },
      {
        "productId": "3142595615",
        "rating": 4.9,
        "weight": 400,
        "reviewRating": 4.9,
        "sales": 3,
        "upTime": "1763758800000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 33.4,
        "sourceType": "ozon",
        "price": 1482,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-j/wc300/9078178987.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "3142595615",
        "sellerType": 0,
        "monthlySalesUnits": 3
      },
      {
        "productId": "3142595707",
        "rating": 4.9,
        "weight": 400,
        "reviewRating": 4.9,
        "sales": 1,
        "upTime": "1763758800000",
        "sourceTool": "Seerfar-Ozon-查店铺",
        "returnCancellationRate": 0,
        "sourceType": "ozon",
        "price": 1332,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-h/wc300/9078182873.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBO"
        ],
        "sku": "3142595707",
        "sellerType": 0,
        "monthlySalesUnits": 1
      }
    ],
    "total": 5,
    "costTime": 2498,
    "totalRevenue": 533893,
    "fulfillment": {
      "FBO": 5
    }
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos