Compras en 1688
Información logística de 1688 MCP
Consulta los envíos y números de seguimiento de un pedido de 1688.
Prompts y casos de uso de Información logística 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. Consultar los envíos de un pedido
Prompt: Consulta la información de envío de mi pedido de 1688 [ALI_ORDER_ID]. Enumera los logisticsOrders y sus números de seguimiento devueltos, sin inventar una fecha de entrega.
Qué debes proporcionar
Sustituye los valores entre corchetes por tus propios identificadores y datos. Usa solo una autorización de tienda de 1688 propia, ACTIVE y vigente.
Comprueba el estado y el mensaje de negocio devueltos. Un HTTP correcto o un código de transporte correcto no demuestran que el pedido o la escritura se hayan completado.
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_data_alibaba1688_logisticshttps://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": "1688-logistics-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_logistics",
"arguments": {
"aliOrderId": "3309156590237728779"
}
}
}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 |
|---|---|---|---|
aliOrderId | string | obligatorio | Identificador entero positivo exacto. Envíalo como cadena JSON. Ejemplo: 3309156590237728779 |
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.aliOrderId | string | opcional | Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$ |
data.logisticsOrders | array | opcional | Valor de Logistics orders usado por esta operación de API. |
data.logisticsOrders[] | object | obligatorio | Elemento de data logisticsOrders. |
data.logisticsOrders[].logisticsBillNo | string | opcional | Valor de Logistics bill no usado por esta operación de API. |
data.logisticsOrders[].logisticsCompanyName | string | opcional | Valor de Logistics company name usado por esta operación de API. |
data.logisticsOrders[].logisticsId | string | opcional | Valor de Logistics id usado por esta operación de API. |
data.logisticsOrders[].status | string | opcional | Valor de Status usado por esta operación de API. |
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. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Consulta la información de envío de mi pedido de 1688 [ALI_ORDER_ID]. Enumera los logisticsOrders y sus números de seguimiento devueltos, sin inventar una fecha de entrega.
Explicación ilustrativa de la respuesta
La respuesta contiene los pedidos logísticos y números de seguimiento del aliOrderId solicitado. Usa únicamente la información de envío devuelta.
Sobre esta muestra: Es un ejemplo ilustrativo de la documentación, no una respuesta en directo de tu cuenta. Comprueba los campos y el estado realmente devueltos.
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": "1688-logistics-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_logistics",
"arguments": {
"aliOrderId": "3309156590237728779"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "1688-logistics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"0\",\"data\":{\"aliOrderId\":\"3309156590237728779\",\"logisticsOrders\":[]},\"msg\":null,\"time\":\"2026-10-20T00:00:00Z\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "0",
"data": {
"aliOrderId": "3309156590237728779",
"logisticsOrders": []
},
"msg": null,
"time": "2026-10-20T00:00:00Z",
"traceId": null,
"ts": "0"
},
"isError": false
}
}