AliExpress

Búsqueda de productos en AliExpress MCP

Busca fichas públicas de productos de AliExpress por palabra clave. Indica una palabra clave de hasta 120 caracteres tras normalizarla; usa pageNum (1–20) y limit (1–100) para acotar la búsqueda. La respuesta contiene un taskId. Consulta el resultado con nexscope_aliexpress_task_result y la misma cuenta de Nexscope.

CosteAl menos 10 créditos por llamadaPrueba REST en línea

Prompts y casos de uso de Búsqueda de productos 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. Buscar productos por palabra clave

Prompt: Busca fichas de productos de AliExpress para [keyword]. Cuando termine la tarea, muestra los productos devueltos y los datos disponibles; indica si el resultado está vacío o ha fallado.

2. Revisar otra página de resultados

Prompt: Busca la página [page number] de fichas de productos de AliExpress para [keyword], con un máximo de [limit] resultados. Compara solo los registros devueltos en esta página con los de una página anterior que te proporcione.

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.

Indica una palabra clave. El número de página va de 1 a 20 y el límite de resultados, de 1 a 100. No se garantiza una cobertura completa de la búsqueda.

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/json

Autenticació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

Nombre de la herramienta MCP

nexscope_aliexpress_product_search

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_aliexpress_product_search",
    "arguments": {
      "keyword": "wireless earbuds",
      "limit": 1,
      "pageNum": 1
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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-search-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
`keyword`	`string`	obligatorio	La palabra clave normalizada debe tener como máximo 120 caracteres.
`pageNum`	`integer`	opcional	Número de página.
`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 busco productos de AliExpress por palabra clave?

Pasos sugeridos

Envía la búsqueda una sola vez, guarda el taskId y consulta nexscope_aliexpress_task_result con ese identificador. Espera a un estado final antes de resumir los registros de productos devueltos.

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

{
  "keyword": "wireless earbuds",
  "pageNum": 1,
  "limit": 1
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "taskId": "EXAMPLE_TASK_ID",
    "status": "SUCCEEDED",
    "result": {
      "items": [
        {
          "url": "https://www.aliexpress.com/item/3256811621288203.html",
          "price": null,
          "title": "2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate Monitoring, Active Noise Cancellation Headphones, Waterproof for Daily Use, For IPhone IOS Smartphone, Gaming /Sports /Fitness Earphones.",
          "images": [],
          "currency": null,
          "priceType": null,
          "productId": "3256811621288203",
          "variantId": null,
          "collectedAt": null,
          "availability": null,
          "missingFields": [
            "images",
            "collectedAt",
            "variantId",
            "availability",
            "completeSkuMatrix",
            "price",
            "currency"
          ],
          "variantAttributes": [],
          "listingHasVariations": null,
          "variantGroups": []
        }
      ],
      "discovered": [],
      "retrievedAt": "1793687830552",
      "errorRecords": 0,
      "limitReached": true,
      "variantCoverage": "NOT_REQUESTED"
    },
    "usage": {
      "billingStatus": "CHARGED",
      "chargedCredits": "10"
    },
    "error": null
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos