AliExpress
Descubrimiento de productos por categoría en AliExpress MCP
Envía una URL de categoría compatible y, si quieres, usa limit (1–100; valor predeterminado: 20) para acotar los grupos de productos. La respuesta contiene un taskId. Consulta nexscope_aliexpress_task_result con la misma cuenta para ver los resultados de la tarea. La recopilación puede ser incompleta o fallar.
Prompts y casos de uso de Descubrimiento de productos por categoría en 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. Descubrir productos en una categoría
Prompt: Descubre productos desde [AliExpress category URL], con un máximo de [limit] grupos de productos. Enumera solo los productos devueltos por la tarea completada.
2. Comparar resultados observados de categorías
Prompt: Ejecuta el descubrimiento por separado para [first category URL] y [second category URL]. Compara únicamente los registros de productos devueltos; no trates ninguno de los resultados como un inventario completo de la categoría.
Qué debes proporcionar
Conecta Nexscope MCP y consulta el precio vigente antes de enviar cada tarea. Guarda los ID devueltos y consulta los resultados 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 navegación por categorías compatible. El límite opcional va de 1 a 100; el análisis del proveedor puede fallar o devolver observaciones incompletas.
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_productshttps://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-products-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_products",
"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-products-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 descubro productos de una categoría de AliExpress?
Pasos sugeridos
Envía la URL de categoría una sola vez, guarda el taskId y consulta nexscope_aliexpress_task_result. Trata los registros devueltos como observaciones, no como el inventario completo de la categoría.
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": [],
"discovered": [
{
"url": "https://www.aliexpress.us/item/1005008144724922.html",
"allVariations": null
}
],
"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-category-products-example",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_products",
"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.