AliExpress
Detalles de productos de AliExpress MCP
Envía la URL pública de un producto de AliExpress para recopilar sus detalles. Esta operación no acepta limit. La respuesta contiene un taskId; consulta nexscope_aliexpress_task_result con la misma cuenta para comprobar el resultado. El proveedor puede devolver una tarea vacía o fallida.
Prompts y casos de uso de Detalles de productos de AliExpress
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. Examinar una página de producto
Prompt: Recopila la página pública de AliExpress en [product URL]. Cuando termine la tarea, resume solo los campos devueltos e indica qué detalles faltan.
Qué debes proporcionar
Conecta Nexscope MCP y consulta el precio vigente antes de enviar la tarea. Guarda el ID devuelto y consulta el resultado con la misma cuenta.
La recepción de una tarea no significa que la recopilación haya terminado. Informa solo sobre los registros devueltos y conserva los estados vacío, parcial, fallido o incierto.
Proporciona una URL de AliExpress compatible que termine en /item/{id}.html. Esta herramienta no acepta limit; la recopilación del proveedor puede fallar o no devolver detalles verificados.
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_aliexpress_product_detailhttps://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": "aliexpress-product-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_product_detail",
"arguments": {
"url": "https://www.aliexpress.us/item/1005008144724922.html"
}
}
}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.
Flujo de tareas asíncronas
- 1. Crear una sola vez
Conserva el taskId devuelto.
- 2. Consultar con espera progresiva
Usa nexscope_aliexpress_task_result para consultar el taskId devuelto con esperas progresivas. Sigue el estado real de la tarea y no vuelvas a enviar la solicitud de pago.
- 3. Usar el resultado final
Detén las consultas al obtener éxito, fallo o tiempo de espera agotado.
{
"jsonrpc": "2.0",
"id": "aliexpress-product-detail-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_task_result",
"arguments": {
"taskId": "TASK_ID_FROM_THE_SUBMISSION_RESULT"
}
}
}Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
url | string | obligatorio | URL de producto de AliExpress con formato /item/{id}.html. |
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 | 0 indica que la llamada a la herramienta se completó correctamente; un valor distinto de cero indica un error de Nexscope. |
cost | integer | opcional | Valor de Cost usado por esta operación de API. |
data | object | null | opcional | Valor de Data usado por esta operación de API. |
data.error | string | null | opcional | Valor de Error usado por esta operación de API. |
data.result | any | opcional | Resultado del proveedor cuando esté disponible; null mientras esté pendiente o si no existe un resultado verificado. |
data.status | string | obligatorio | Estado actual de la tarea; una llamada correcta no significa que la recopilación haya terminado. |
data.taskId | string | obligatorio | Usa este identificador con la herramienta MCP correspondiente para consultar el resultado de la tarea de AliExpress. |
data.usage | object | obligatorio | Valor de Usage usado por esta operación de API. |
data.usage.billingStatus | string | opcional | Valor de Billing status usado por esta operación de API. |
data.usage.chargedCredits | integer | opcional | Valor de Charged credits usado por esta operación de API. |
msg | string | null | opcional | Valor de Msg usado por esta operación de API. |
time | string | opcional | Valor de Time usado por esta operación de API. |
traceId | string | null | opcional | Valor de Trace id usado por esta operación de API. |
ts | integer | opcional | Valor de Ts usado por esta operación de API. |
Guía de flujo de trabajo
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
Tu objetivo
¿Cómo examino una página de producto de AliExpress?
Pasos sugeridos
Envía una URL de producto compatible, guarda el taskId y consulta nexscope_aliexpress_task_result. Usa el estado y el resultado devueltos para describir únicamente los detalles observados.
Sobre esta muestra: Este ejemplo describe el envío y la consulta de una tarea; no es una respuesta verificada del proveedor. Una llamada de pago puede terminar sin datos, parcialmente o con un error. Comprueba el estado y el uso reales de la tarea.
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
{
"url": "https://www.aliexpress.us/item/1005008144724922.html"
}Respuesta
{
"code": 0,
"data": {
"status": "SUCCEEDED",
"result": {
"items": [
{
"url": "https://www.aliexpress.us/item/1005008144724922.html",
"productId": "1005008144724922",
"title": "2/4/6pcs Magic Light Up Finger Fingers LED Tricks Thumb Props Christmas Christmas Festival Party Novelty Funny Toys",
"images": [
"https://ae-pic-a1.aliexpress-media.com/kf/Sa439ab62453846ae80fba37076c84b51M.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S48f97daf874247d0897b88a1a40f58f0j.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sdf53f7d712f547d5b822367008e7f363I.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S31e298126e5a47288b26b28194a413b6z.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6eac4e4e1f1e4aba88943cc47ae292106.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6a36082e9be04090b865a1506bcfafacO.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A216becd3745b46509fd9ed12b2961769W.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A1c7f6838675449b9a1c0a8947e3988d7n.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A7dc6b7e4322243edbdf73237dcbbf02eH.jpg"
],
"price": null,
"currency": null,
"collectedAt": null,
"missingFields": [
"price",
"currency",
"collectedAt",
"completeSkuMatrix"
],
"variantId": "14-366",
"availability": "in_stock",
"listingHasVariations": true,
"variantAttributes": [
{
"name": "Color",
"value": "4Pcs"
}
],
"priceType": null,
"variantGroups": []
}
],
"discovered": [],
"variantCoverage": "NOT_REQUESTED",
"limitReached": true,
"errorRecords": 0
}
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
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": "aliexpress-product-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_product_detail",
"arguments": {
"url": "https://www.aliexpress.us/item/1005008144724922.html"
}
}
}Formato de respuesta MCP
Este flujo de trabajo no afirma haber obtenido un resultado de la API. No hay un ejemplo de respuesta verificado; consulta Parámetros y respuesta para ver la estructura documentada.