AliExpress
Variantes por categoría de AliExpress MCP
Envía una URL de categoría compatible. limit (1–100; valor predeterminado: 20) acota los grupos de productos, pero un producto puede generar varias filas de variantes. La respuesta contiene un taskId. Consulta nexscope_aliexpress_task_result para revisar los resultados observados.
Prompts y casos de uso de Variantes por categoría 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 variantes observadas en una categoría
Prompt: Recopila las variantes observadas desde [AliExpress category URL], limitando el descubrimiento a [limit] grupos de productos. Agrupa las filas de variantes devueltas por producto cuando el resultado lo permita e indica la información de variantes que falte.
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 categoría compatible. El límite acota los grupos de productos, no las filas de variantes; el proveedor puede devolver resultados incompletos o fallidos.
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_category_variantshttps://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-category-variants-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_variants",
"arguments": {
"limit": 1,
"url": "https://www.aliexpress.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en"
}
}
}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-category-variants-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 navegación de una categoría de AliExpress compatible. |
limit | integer | opcional | Número máximo de resultados. |
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 variantes observadas de una categoría?
Pasos sugeridos
Envía la URL de categoría y el límite opcional de grupos; después consulta nexscope_aliexpress_task_result con el taskId. Describe únicamente las filas de variantes presentes en el resultado.
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.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en",
"limit": 1
}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": [
{
"type": "Color",
"options": [
{
"id": "14-366",
"name": "4Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-29",
"name": "2Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-193",
"name": "6Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg_220x220q75.jpg_.avif"
}
]
}
]
},
{
"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-193",
"availability": "in_stock",
"listingHasVariations": true,
"variantAttributes": [
{
"name": "Color",
"value": "6Pcs"
}
],
"priceType": null,
"variantGroups": [
{
"type": "Color",
"options": [
{
"id": "14-366",
"name": "4Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-29",
"name": "2Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-193",
"name": "6Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg_220x220q75.jpg_.avif"
}
]
}
]
},
{
"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-29",
"availability": "in_stock",
"listingHasVariations": true,
"variantAttributes": [
{
"name": "Color",
"value": "2Pcs"
}
],
"priceType": null,
"variantGroups": [
{
"type": "Color",
"options": [
{
"id": "14-366",
"name": "4Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-29",
"name": "2Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-193",
"name": "6Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg_220x220q75.jpg_.avif"
}
]
}
]
}
],
"discovered": [],
"variantCoverage": "ALL_REQUESTED_UNVERIFIED",
"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-category-variants-example",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_variants",
"arguments": {
"limit": 1,
"url": "https://www.aliexpress.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en"
}
}
}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.