Inteligencia de Ozon SR

API de búsqueda de categorías de Ozon MCP

Analyze products in an Ozon category by category ID. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.

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

Prompts y casos de uso de API de búsqueda de categorías 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 productos de una categoría de Ozon por su ID

Prompt: Analyze products in an Ozon category by category ID para [category 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. Revise un período específico de presentación de informes

Prompt: Analyze products in an Ozon category by category ID para [category ID]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales. Recuperar página 1 con hasta 20 resultados y preguntar antes de continuar a otra página.

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

Prompt: Analyze products in an Ozon category by category ID para [category 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.

4. Priorizar los resultados para la revisión

Prompt: Analyze products in an Ozon category by category ID para [category 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, ingresos, calificación de revisión en orden ascendente o descendente.

5. Elija un método Fulfillment

Prompt: Analyze products in an Ozon category by category ID para [category ID]. Uso [my preferred supported fulfillment methods] estrechar la investigación y mantener los tipos de cumplimiento distinguibles. Resumir sólo los registros devueltos. Recuperar página 1 con hasta 20 resultados y preguntar antes de continuar a otra página. Para esta selección, elija FBO, FBS, RFBS, FBP o OZON.

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_category_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-category-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_category_search",
    "arguments": {
      "categoryId": "15621042_17028650_97011",
      "date": "2026-01",
      "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
`categoryId`	`string`	obligatorio	Ozon ID, obtenido de la documentación de la categoría Ozon u otro Nexscope Herramientas de Ozon. Format like 15621032 15621049 115951147 (multi-level categories joined by ) Ejemplo: 15621042_17028650_97011
`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} (ambos necesarios); la dirección toma DESC (descendente) / ASC (ascendiendo). Campos comunes: ventas, precio, ingresos, reviewRating Ejemplo: []
`date`	`string`	opcional	Query historical month, format yyyy-MM (e.g., 2026-02); predeterminados a durar 30 días si se omite Ejemplo: 2026-01
`fulfillment`	`string`	opcional	Filtro de método de relleno, opciones fijas: FBO, FBS, RFBS, FBP, OZON; consultas todas si se omite. Nota: cuerda única, no un array
`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.
`id`	`string`	opcional	La categoría ID para ser eco.
`total`	`integer`	opcional	El número de registros devueltos en esta página es igual al número de `data` items on the current page, not the total number of products in the category.
`totalSales`	`integer`	opcional	El volumen total de ventas de la categoría dentro del intervalo estadístico.
`totalRevenue`	`number`	opcional	Total de ventas de categoría en rublos.
`avgPrice`	`number`	opcional	Precio medio de los productos en la categoría, en rublos.
`rating`	`number`	opcional	Calificación promedio de productos de la categoría.
`seasonalityAmplitude`	`string`	opcional	Fuerza estacional, como `STRONG_SEASONALITY`.
`seasonalityCoef`	`string`	opcional	Fases estacionales como `OFF_SEASON`.
`startDate`	`string`	opcional	Fecha de inicio de las estadísticas.
`endDate`	`string`	opcional	Fecha final de las estadísticas.
`sellerType`	`object`	opcional	La distribución de los métodos de entrega, no del vendedor local/cross-border tipo; la clave es el método de entrega y el valor es el número de productos.
`categoryInfo`	`object`	opcional	Categoría meta información, la estructura se muestra en `categoryInfo` cuadro a continuación.
`data`	`array`	opcional	Lista de productos de la categoría, los campos de elementos se muestran en la tabla de objetos del producto a continuación.
`products`	`array`	opcional	Lista de productos de la categoría, el contenido es exactamente igual que `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 responsable.
`costTime`	`integer`	opcional	La interfaz consume tiempo en milisegundos.
`costToken`	`integer`	opcional	El número de fichas consumidas.
`sku`	`integer`	opcional	Producto SKU.
`productId`	`integer`	opcional	Producto unificado ID, mapeado desde `sku`.
`title`	`string`	opcional	Título del producto.
`price`	`number`	opcional	Precio de productos básicos en rublos.
`currency`	`string`	opcional	Moneda fija `₽`.
`sales`	`integer`	opcional	Venta de productos.
`monthlySalesUnits`	`integer`	opcional	Ventas mensuales unificadas, mapeadas desde `sales`.
`revenue`	`number`	opcional	Volumen de venta de mercancías en rublos.
`monthlySalesRevenue`	`number`	opcional	Ventas mensuales unificadas, mapeadas desde `revenue`.
`reviewRating`	`number`	opcional	Evaluaciones de productos.
`rating`	`number`	opcional	Anotación unificada, mapeado desde `reviewRating`.
`reviewCount`	`integer`	opcional	Número de comentarios.
`brandName`	`string`	opcional	Nombre de marca.
`brand`	`string`	opcional	Marca unificada, mapeada desde `brandName`.
`sellerName`	`string`	opcional	Nombre del vendedor.
`fulfillment`	`array`	opcional	Método de envío de productos, como `["FBO"]`, puede contener múltiples valores.
`imageUrl`	`string`	opcional	Enlace de imagen de producto.
`productUrl`	`string`	opcional	Enlace de producto.
`productPageUrl`	`string`	opcional	Página de producto unificada URL, mapeado desde `productUrl`.
`categoryInfo`	`object`	opcional	Información de atribución de categoría de producto, la estructura se muestra en la `categoryInfo` cuadro a continuación.
`sourceType`	`string`	opcional	Fuente de datos fijada `ozon`.
`cnTitlePath`	`string`	opcional	Camino de la categoría china.
`enTitlePath`	`string`	opcional	Camino de la categoría de inglés.
`titlePath`	`string`	opcional	Ruso (frontend) ruta de categoría.
`fullCategoryId`	`array`	opcional	Array of category IDs a todos los niveles.
`category`	`object`	opcional	El objeto de categoría inferior contiene campos como título, nivel, ventas transfronterizas, padre, estado de desactivación y ID.

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

Analyze products in an Ozon category by category ID. Categoría de uso ID 17027486_17039635_97613.

Respuesta de ejemplo

En la muestra publicada, el primer registro mostrado es “Aромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый”. El valor indicado de el precio es 367. Su calificación notificada es 4.7. 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

{
  "categoryId": "17027486_17039635_97613",
  "page": {
    "page": 1,
    "pageSize": 1
  }
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": [
      {
        "brandName": "",
        "productId": "3614108738",
        "sellerName": "LV Cat",
        "rating": 4.7,
        "title": "Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый",
        "reviewRating": 4.7,
        "sales": 13668,
        "categoryInfo": {
          "cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
          "enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
          "category": {
            "cnTitle": "超声波香气扩散器",
            "enTitle": "Ultrasonic Aromatherapy Diffuser",
            "level": 3,
            "crossBorderSellable": true,
            "pid": "17027486_17039635",
            "disabled": false,
            "id": "17027486_17039635_97613",
            "title": "Аромадиффузор ультразвуковой"
          },
          "titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
          "fullCategoryId": [
            "17027486",
            "17027486_17039635",
            "17027486_17039635_97613"
          ]
        },
        "productPageUrl": "https://www.ozon.ru/product/3614108738",
        "revenue": 5388025,
        "monthlySalesRevenue": 5388025,
        "sourceTool": "Seerfar-Ozon-查类目",
        "reviewCount": 6252,
        "sourceType": "ozon",
        "price": 367,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-w/wc300/14977975784.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBP"
        ],
        "sku": "3614108738",
        "productUrl": "https://www.ozon.ru/product/3614108738",
        "brand": "",
        "monthlySalesUnits": 13668
      }
    ],
    "endDate": "2026-09-26",
    "hasNextPage": true,
    "columns": [
      {
        "filterable": true,
        "cellType": "number",
        "field": "sku",
        "sortable": true,
        "title": "商品SKU"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品标题"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productUrl",
        "sortable": true,
        "title": "商品链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "商品图片链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brandName",
        "sortable": true,
        "title": "品牌名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sellerName",
        "sortable": true,
        "title": "卖家名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "fulfillment",
        "sortable": true,
        "title": "配送方式"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "价格，单位卢布"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sales",
        "sortable": true,
        "title": "销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "revenue",
        "sortable": true,
        "title": "销售额"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewCount",
        "sortable": true,
        "title": "评论数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewRating",
        "sortable": true,
        "title": "评分"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "categoryInfo",
        "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": "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": "币种"
      }
    ],
    "avgPrice": 748,
    "rating": 4.8,
    "totalSales": 50330,
    "type": "productWorkbenches",
    "categoryInfo": {
      "cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
      "enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
      "category": {
        "cnTitle": "超声波香气扩散器",
        "enTitle": "Ultrasonic Aromatherapy Diffuser",
        "level": 3,
        "crossBorderSellable": true,
        "pid": "17027486_17039635",
        "disabled": false,
        "id": "17027486_17039635_97613",
        "title": "Аромадиффузор ультразвуковой"
      },
      "titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
      "fullCategoryId": [
        "17027486",
        "17027486_17039635",
        "17027486_17039635_97613"
      ]
    },
    "products": [
      {
        "brandName": "",
        "productId": "3614108738",
        "sellerName": "LV Cat",
        "rating": 4.7,
        "title": "Аромадиффузор ультразвуковой 01a028a855d579ba98c98526d7f2285e, белый",
        "reviewRating": 4.7,
        "sales": 13668,
        "categoryInfo": {
          "cnTitlePath": "家用电器 > 空调设备 > 超声波香气扩散器",
          "enTitlePath": "Home Appliances > Climatic Equipment > Ultrasonic Aromatherapy Diffuser",
          "category": {
            "cnTitle": "超声波香气扩散器",
            "enTitle": "Ultrasonic Aromatherapy Diffuser",
            "level": 3,
            "crossBorderSellable": true,
            "pid": "17027486_17039635",
            "disabled": false,
            "id": "17027486_17039635_97613",
            "title": "Аромадиффузор ультразвуковой"
          },
          "titlePath": "Бытовая техника > Климатическая техника > Аромадиффузор ультразвуковой",
          "fullCategoryId": [
            "17027486",
            "17027486_17039635",
            "17027486_17039635_97613"
          ]
        },
        "productPageUrl": "https://www.ozon.ru/product/3614108738",
        "revenue": 5388025,
        "monthlySalesRevenue": 5388025,
        "sourceTool": "Seerfar-Ozon-查类目",
        "reviewCount": 6252,
        "sourceType": "ozon",
        "price": 367,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-w/wc300/14977975784.jpg",
        "currency": "₽",
        "fulfillment": [
          "FBP"
        ],
        "sku": "3614108738",
        "productUrl": "https://www.ozon.ru/product/3614108738",
        "brand": "",
        "monthlySalesUnits": 13668
      }
    ],
    "total": 1,
    "seasonalityAmplitude": "STRONG_SEASONALITY",
    "costTime": 1496,
    "id": "17027486_17039635_97613",
    "totalRevenue": 56323772,
    "sellerType": {
      "FBO": 167,
      "RFBS": 771,
      "FBP": 120,
      "FBS": 221
    },
    "startDate": "2026-08-27",
    "seasonalityCoef": "TRANSITION_PERIOD"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos