Abastecimiento en 1688

API de productos más vendidos de 1688 MCP

Consulta las listas de productos más vendidos de 1688 para investigar proveedores y artículos al por mayor. Accede mediante API REST o MCP con tu clave de API de Nexscope. Si indicas palabras clave, deben estar en chino. Los ID de producto se tratan como cadenas. Los precios y las estimaciones de ventas corresponden al período estadístico solicitado.

CosteRecent Avg. 19 · Range 10–19 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de productos más vendidos de 1688

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. Comprueba 1688 Bestsellers

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Encontrar Bestsellers por Producto ID

Prompt: Verificar 1688 Bestsellers utilizando [product IDs]. Mantener los resultados devueltos atados a esa entrada y no inferir partidos que no fueron devueltos.

3. Encontrar Bestsellers por Enlace de Producto

Prompt: Verificar 1688 Bestsellers utilizando [product link]. Mantener los resultados devueltos atados a esa entrada y no inferir partidos que no fueron devueltos.

4. Revise un período específico de presentación de informes

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. 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: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. 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: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. 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. Para esta selección, elija el recuento de pedidos, unidades vendidas, cantidad estimada de ventas, tiempo de inclusión, precio al por mayor o precio de envío.

7. Encontrar coincidencias por años de fideicomiso

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen trustpass years range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

8. Encontrar coincidencias por precio mayorista

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen wholesale price range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

9. Encontrar coincidencias por precio de la gota

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen dropship price range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

10. Encontrar coincidencias por cuenta de orden

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen order count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

11. Encontrar coincidencias por unidades vendidas

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen units sold range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

12. Buscar coincidencias por importe de ventas

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen sales amount range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

13. Encontrar coincidencias por orden Cantidad

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen order quantity range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

14. Encontrar coincidencias por hora de lista

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Limitación de los resultados [my chosen listing time range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

15. Elija los partidos de palabras clave exactas o más amplias

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Búsqueda [my keyword] utilizando [exact matching or broader matching]. Según mi objetivo de investigación. Resumir sólo los registros devueltos.

16. Encontrar ofertas Con las etiquetas correctas del producto

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]estrechar la búsqueda [my selected product tags], tales como las clasificaciones documentadas de nuevos productos o fuentes. Resumir sólo los registros devueltos.

17. Encontrar fábricas o tiendas de comercio

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Concéntrate en [factories, trading stores or either], según mi preferencia de abastecimiento. Resumir sólo los registros devueltos.

18. Elija un miembro del proveedor

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Encontrar ofertas de [my selected supplier membership groups]. Informe sólo lo que los registros seleccionados soportan. Para esta selección, elija Super Factory, Power Seller o TrustPass miembro sólo.

19. Encontrar más rápido despachado

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Encontrar ofertas que se reúnen [my required dispatch time]. Informe sólo lo que los registros seleccionados soportan. Para esta selección, elija 24 horas, 48 horas o 72 horas.

20. Buscar servicios de dropshipping

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Encontrar ofertas con [my required dropshipping services]. Informe sólo lo que los registros seleccionados soportan. Para esta selección, elija una sola pieza con envío gratuito o adquiera ahora, pague más tarde.

21. Buscar servicios de proveedores

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Encontrar ofertas con [my required supplier services]. Informe sólo lo que los registros seleccionados soportan. Para esta selección, elija Safe Buy o Deep Verification Report.

22. Buscar Protecciones del comprador del proveedor

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Encontrar ofertas con [my required buyer protections]. Informe sólo lo que los registros seleccionados soportan.

23. Encontrar etiquetas de envío compatibles

Prompt: Consulta 1688 Bestsellers para [search phrase translated into Simplified Chinese]. Encontrar ofertas de apoyo [my required marketplace shipping-label service]. Informe sólo lo que los registros seleccionados soportan. Para esta selección, elija Taobao, Douyin, Pinduoduo, Xiaohongshu o Kuaishou.

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.

Las búsquedas por palabra clave requieren chino simplificado. Traduce la frase de búsqueda antes de llamar a la herramienta y conserva los ID de producto como cadenas.

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_1688_product_billboard

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": "1688-product-billboard-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_1688_product_billboard",
    "arguments": {
      "date": "2026-07-01",
      "keyWord": "手机壳",
      "pageIndex": 1,
      "pageSize": 20,
      "pageType": 3,
      "searchType": 1
    }
  }
}

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
`keyWord`	`string`	opcional	Palabras clave de búsqueda de productos (debe escribirse en chino simplificado; traducirlo antes de llamarlo API). Máximo 50 caracteres Ejemplo: 手机壳
`date`	`string`	opcional	Tiempo de consulta. Gráfico semanal: pasar la fecha del domingo de esa semana, e.g2025-06-15 (hasta 90 días); Tabla mensual: pasar el primer día del mes, e.g2025-06-01 (hasta un año) Ejemplo: 2026-07-01
`pageType`	`integer`	opcional	Tipo de cartel: 2 = semanal, 3 = mensual. Default 3 Ejemplo: 3
`pageIndex`	`integer`	opcional	Número de página (a partir de 1), predeterminado 1 Ejemplo: 1
`pageSize`	`integer`	opcional	Número de resultados por página (10-100), predeterminado 20 Ejemplo: 20
`sortField`	`string`	opcional	Campo de clasificación, por defecto orderCount. Opciones: orderCount (conteo mayor), saleCount (Unidades vendidas), saleVolume (número estimado de ventas), offerCreateTime (hora de la lista), precio (precio mayor), consignPrice (precio por goteo)
`sortType`	`string`	opcional	Ordenar: desc (descendente), asc (ascending), desc predeterminado
`searchType`	`integer`	opcional	Tipo de búsqueda de palabras clave del producto: 1 = partido borroso, 3 = partido exacto. Predeterminado 1 Ejemplo: 1
`offerType`	`integer`	opcional	Etiquetas del producto: 0 = no limit, 2 = nuevo producto, 3 = 1688 Seleccione, 4 = transfronterizo, 5 = soporte de personalización, 6 = punto culminante de la tienda. Default 0 Ejemplo: 0
`companyType`	`integer`	opcional	Tipo de empresa: 0 = sin límite, 1 = almacén, 2 = fábrica Ejemplo: 0
`shiLiType`	`string`	opcional	Tipo de membresía del vendedor (multi-select), separado por coma. Opciones: superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass miembro únicamente)
`beginTpYear`	`integer`	opcional	Comienzo TrustPass años Ejemplo: 1
`endTpYear`	`integer`	opcional	Final TrustPass años Ejemplo: 1
`beginPrice`	`number`	opcional	Precio al por mayor (start) Ejemplo: 1
`endPrice`	`number`	opcional	Precio al por mayor (fin) Ejemplo: 1
`beginConsignPrice`	`number`	opcional	Precio de desembarque (comienzo) Ejemplo: 1
`endConsignPrice`	`number`	opcional	Tasa de deserción (final) Ejemplo: 1
`beginOrderCount`	`integer`	opcional	Conteo de pedidos (inicio) Ejemplo: 1
`endOrderCount`	`integer`	opcional	Conteo de pedidos (final) Ejemplo: 1
`beginSaleCount`	`integer`	opcional	Unidades vendidas Ejemplo: 1
`endSaleCount`	`integer`	opcional	Unidades vendidas (final) Ejemplo: 1
`beginSaleVolume`	`number`	opcional	Cantidad de venta (inicio) Ejemplo: 1
`endSaleVolume`	`number`	opcional	Cantidad de venta (final) Ejemplo: 1
`beginStartQuantity`	`integer`	opcional	Cantidad mínima de pedido (inicio) Ejemplo: 1
`endStartQuantity`	`integer`	opcional	Cantidad mínima (final) Ejemplo: 1
`beginOfferCreateTime`	`string`	opcional	Tiempo de lista (start), formato: YYYY-MM-DD
`endOfferCreateTime`	`string`	opcional	Tiempo de lista (fin), formato: YYYY-MM-DD
`sendTime`	`string`	opcional	Plazo de entrega (multi-select), separado por coma. Opciones: 24 (24 horas), 48 (48 horas), 72 (72 horas)
`proxyRights`	`string`	opcional	Derechos de deserción (multi-select), separados por coma. Opciones: 4360897 (una sola pieza gota con envío gratuito), 449154 (pregunta ahora, pagar más tarde)
`shopService`	`string`	opcional	Servicios de venta (multi-select), separados por coma. Opciones: 4057409 (Safe Buy), 888777 (Deep Verification Report)
`buyerProtections`	`string`	opcional	Protecciones del comprador, separadas por coma: envío gratuito, devolución gratuita de 7 días o seguro de envío
`faceToFaceSupport`	`string`	opcional	Waybill support (multi-select), comma-separated. Opciones: 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)
`productIds`	`string`	opcional	Producto IDs, separado por coma chino para múltiples, max 20
`goodsUrl`	`string`	opcional	Enlace de producto URL Ejemplo: https://example.com/image.jpg

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	opcional	Nexscope transport/business código sobre; 0 significa que la solicitud fue procesada. Inspeccione datos para los resultados de la operación.
`cost`	`string`	opcional	Tiempo de procesamiento en milisegundos, no créditos.
`data`	`object`	opcional	Valor de Data usado por esta operación de API.
`data.columns`	`array`	opcional	Definición de columna
`data.columns[]`	`any`	obligatorio	Definición de columna
`data.products`	`array`	opcional	Valor de Products usado por esta operación de API.
`data.products[]`	`object`	obligatorio	Elemento de data products.
`data.products[].asin`	`string`	opcional	Tema
`data.products[].asinUrl`	`string`	opcional	Dirección de enlace de productos
`data.products[].availableDate`	`string`	opcional	Tiempo de estante de producto, en el formato de `yyyy-MM-dd HH:mm:ss`
`data.products[].company`	`string`	opcional	Nombre de la tienda
`data.products[].consignPrice`	`number`	opcional	Precio en nombre de otros
`data.products[].currency`	`string`	opcional	Moneda
`data.products[].dataType`	`string`	opcional	Tipo de datos: `weeklyData` datos semanales, `monthlyData` Datos mensuales
`data.products[].deliveryTime`	`string`	opcional	Tiempo de envío
`data.products[].estimatedSalesAmount`	`integer`	opcional	Ventas estimadas, retorno de valores correspondientes según el período estadístico
`data.products[].imageUrl`	`string`	opcional	Dirección de imagen
`data.products[].levelName`	`string`	opcional	Nombre de categoría
`data.products[].offerId`	`string`	opcional	Producto ID
`data.products[].price`	`number`	opcional	precio mayor
`data.products[].quantityBegin`	`integer`	opcional	Tamaño mínimo del lote
`data.products[].quantityPrices`	`string`	opcional	rango de precios
`data.products[].salesOrderCount`	`integer`	opcional	El número de ventas, devuelve el valor correspondiente según el período estadístico
`data.products[].salesQuantity`	`integer`	opcional	El número de piezas vendidas, devuelve el valor correspondiente según el período estadístico
`data.products[].shopId`	`string`	opcional	Store ID
`data.products[].shopUrl`	`string`	opcional	Dirección de enlace de la tienda
`data.products[].sourceType`	`string`	opcional	Plataforma fuente (1688)
`data.products[].title`	`string`	opcional	Título del producto
`data.products[].unit`	`string`	opcional	unidad
`data.total`	`integer`	opcional	Número de registros
`data.type`	`string`	opcional	estilo de renderización
`msg`	`string \| null`	opcional	Mensaje de respuesta seguro.
`time`	`string`	opcional	Tiempo de respuesta del servidor.
`traceId`	`string \| null`	opcional	Solicito identificador.
`ts`	`string`	opcional	Timetamp del servidor.

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

Encontrar 1688 productos en una lista de bestseller semanal o mensual especificada. Uso del producto IDs 921378745459.

Respuesta de ejemplo

En la muestra publicada, su asin reportado es 921378745459. Su precio comunicado es 27. Su cantidad notificada de ventas es de 1095. 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.

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

{
  "productIds": "921378745459",
  "pageType": 3,
  "date": "2026-03-01"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 1,
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "dataType",
        "sortable": true,
        "title": "数据类型: weeklyData: 周数据; monthlyData: 月数据"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "offerId",
        "sortable": true,
        "title": "商品id"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "asin",
        "sortable": true,
        "title": "商品编号"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopId",
        "sortable": true,
        "title": "店铺id"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "图片地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "availableDate",
        "sortable": true,
        "title": "商品上架时间，格式为 yyyy-MM-dd HH:mm:ss"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "quantityPrices",
        "sortable": true,
        "title": "价格区间"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品标题"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "批发价"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "deliveryTime",
        "sortable": true,
        "title": "发货时间"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "company",
        "sortable": true,
        "title": "店铺名称"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesQuantity",
        "sortable": true,
        "title": "销售件数（按统计周期返回对应的值）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesOrderCount",
        "sortable": true,
        "title": "销售笔数（按统计周期返回对应的值）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "estimatedSalesAmount",
        "sortable": true,
        "title": "预估销售额（按统计周期返回对应的值）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "consignPrice",
        "sortable": true,
        "title": "代发价"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "unit",
        "sortable": true,
        "title": "单位"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "quantityBegin",
        "sortable": true,
        "title": "起批量"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "levelName",
        "sortable": true,
        "title": "类目层级名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopUrl",
        "sortable": true,
        "title": "店铺链接地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "asinUrl",
        "sortable": true,
        "title": "商品链接地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "1688"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "currency",
        "sortable": true,
        "title": "币种"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      }
    ],
    "type": "productWorkbenches",
    "products": [
      {
        "salesOrderCount": 730,
        "deliveryTime": "48",
        "dataType": "monthlyData",
        "quantityBegin": 1,
        "availableDate": "2025-05-08 14:29:00",
        "levelName": "服饰配件、饰品>腰带/腰链/腰封>腰带",
        "title": "头层牛皮针扣皮带男款 复古百搭牛仔裤带 简约休闲真皮腰带男士",
        "shopUrl": "https://shop2950j93562603.1688.com",
        "asinUrl": "https://detail.1688.com/offer/921378745459.html",
        "estimatedSalesAmount": 30160,
        "consignPrice": 29,
        "unit": "条",
        "sourceTool": "店雷达-1688选品库",
        "sourceType": "1688",
        "price": 27,
        "salesQuantity": 1095,
        "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01gFfkRz2DrFmBYU9Xs_!!2206775498662-0-cib.jpg",
        "offerId": "921378745459",
        "asin": "921378745459",
        "company": "广州花都区壹友皮具厂",
        "currency": "¥",
        "shopId": "b2b-2206775498662258ae",
        "quantityPrices": "[{\"quantity\":\"1~499\",\"value\":\"29.00\"},{\"quantity\":\"500~999\",\"value\":\"28.00\"},{\"quantity\":\"≥1000\",\"value\":\"27.00\"}]"
      }
    ]
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos