Compras en 1688
Seguimiento logístico de 1688 MCP
Consulta los eventos de seguimiento y el progreso de entrega de un pedido de 1688.
Prompts y casos de uso de Seguimiento logístico 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. Revisar los eventos de seguimiento
Prompt: Para mi pedido de 1688 [ALI_ORDER_ID], consulta los eventos de seguimiento y preséntalos en el orden devuelto, con ubicación y hora registradas. No inventes una fecha de entrega.
2. Seguir un envío concreto
Prompt: Si el pedido de 1688 [ALI_ORDER_ID] tiene varios envíos, usa el logisticsId [LOGISTICS_ID] elegido para consultar su seguimiento. Mantén separados los eventos de otros envíos.
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_logistics_tracehttps://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-trace-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_logistics_trace",
"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 |
logisticsId | string | opcional | Seleccione un pedido logístico cuando existen múltiples envíos. |
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.logisticsId | string | opcional | Valor de Logistics id usado por esta operación de API. |
data.traceList | array | opcional | Valor de Trace list usado por esta operación de API. |
data.traceList[] | object | obligatorio | Elemento de data traceList. |
data.traceList[].location | string | opcional | Valor de Location usado por esta operación de API. |
data.traceList[].traceDescription | string | opcional | Valor de Trace description usado por esta operación de API. |
data.traceList[].traceStatus | string | opcional | Valor de Trace status usado por esta operación de API. |
data.traceList[].traceTime | string | opcional | Asia/Shanghai tiempo. |
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
Para mi pedido de 1688 [ALI_ORDER_ID], consulta los eventos de seguimiento y preséntalos en el orden devuelto, con ubicación y hora registradas. No inventes una fecha de entrega.
Explicación ilustrativa de la respuesta
traceList contiene los eventos del pedido solicitado o del logisticsId elegido. Conserva las horas y ubicaciones de origen sin inventar una estimación de llegada.
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-trace-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_logistics_trace",
"arguments": {
"aliOrderId": "3309156590237728779"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "1688-logistics-trace-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"0\",\"data\":{\"aliOrderId\":\"3309156590237728779\",\"traceList\":[]},\"msg\":null,\"time\":\"2026-10-20T00:00:00Z\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "0",
"data": {
"aliOrderId": "3309156590237728779",
"traceList": []
},
"msg": null,
"time": "2026-10-20T00:00:00Z",
"traceId": null,
"ts": "0"
},
"isError": false
}
}