AliExpress

Lectura de páginas de AliExpress MCP

Envía un requestId UUID junto con una palabra clave y pageNum opcional (1–20), o con una URL pública compatible de AliExpress. No combines url con keyword ni pageNum. La respuesta contiene un taskId; consulta nexscope_aliexpress_access_task_result para ver el resultado. La lectura no garantiza la extracción de productos dinámicos.

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

Prompts y casos de uso de Lectura de páginas 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. Leer una página de búsqueda por palabra clave

Prompt: Lee la página pública de búsqueda de AliExpress para [keyword] en la página [page number]. Resume solo el texto realmente devuelto por la tarea completada.

2. Leer una página pública compatible

Prompt: Lee la página compatible de AliExpress en [page URL]. Informa sobre el texto visible o el resultado del acceso sin suponer que se han extraído datos dinámicos de productos.

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 un requestId UUID y, alternativamente, una palabra clave con un número de página opcional entre 1 y 20, o una URL compatible. No combines ambas formas de entrada. Consulta esta tarea con nexscope_aliexpress_access_task_result.

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_page_read

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-page-read-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_aliexpress_page_read",
    "arguments": {
      "keyword": "wireless earbuds",
      "pageNum": 1,
      "requestId": "11111111-1111-4111-8111-111111111111"
    }
  }
}

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_access_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-page-read-result-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_aliexpress_access_task_result",
    "arguments": {
      "taskId": "TASK_ID_FROM_THE_SUBMISSION_RESULT"
    }
  }
}

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`keyword`	`string`	opcional	La palabra clave normalizada debe tener como máximo 120 caracteres. Longitud mínima: 1 Longitud máxima: 240
`pageNum`	`integer`	opcional	Número de página. Predeterminado: 1 Mínimo: 1 Máximo: 20
`requestId`	`string`	obligatorio	UUID generado por el cliente. Reutilízalo al reintentar un envío de resultado incierto. Formato: uuid
`url`	`string`	opcional	URL compatible de detalle de producto o navegación de categoría de AliExpress. Formato: uri Longitud máxima: 2048

Opción 1 de una alternativa — requiere keyword

Opción 2 de una alternativa — requiere url

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.chargedCredits`	`integer`	opcional	Valor de Charged credits usado por esta operación de API.
`data.usage.nexscopeBillingState`	`string`	opcional	Valor de Nexscope billing state usado por esta operación de API.
`data.usage.observedBytes`	`integer`	opcional	Valor de Observed bytes usado por esta operación de API.
`data.usage.supplierChargeState`	`string`	opcional	Valor de Supplier charge state 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 leo una página de AliExpress?

Pasos sugeridos

Elige la navegación por palabra clave o una URL compatible, genera un requestId UUID y envía la tarea una sola vez. Consulta nexscope_aliexpress_access_task_result con el taskId y comunica solo el texto o el estado de acceso 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

{
  "requestId": "d55c91b1-7352-4e24-84cc-d7c248ce48e8",
  "keyword": "phone case",
  "pageNum": 1
}

Respuesta

{
  "code": 0,
  "data": {
    "status": "SUCCEEDED",
    "result": {
      "page": {
        "title": "",
        "finalUrl": "https://www.aliexpress.com/w/wholesale.html?SearchText=phone+case&page=1",
        "productLinks": [],
        "outcome": "READ",
        "stopReason": "DOCUMENT_READ",
        "observedBytes": 0,
        "text": "Help\nCustomer Service\nDisputes & Reports\nReport IPR infringement\nBuyer Protection\nApp\n?\nShip to\nLanguage\nCurrency\nSave\nCart\nWish List\nAccount\n\nWelcome to AliExpress!\n\nWelcome back\n\nSign Out\n\nJoin Sign in\n\n?\nMy Orders\nMessage Center\nWish List\nMy Favorite Stores\nMy Coupons",
        "requestedUrl": "https://www.aliexpress.com/w/wholesale.html?SearchText=phone+case&page=1"
      }
    }
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos