AliExpress

Búsqueda orgánica de Google para AliExpress MCP

Envía un requestId UUID y una palabra clave. pageNum (1–10) y limit (1–10) acotan los resultados. La respuesta contiene un taskId; consulta nexscope_aliexpress_access_task_result con la misma cuenta. Los resultados de Google no son productos de AliExpress verificados.

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

Prompts y casos de uso de Búsqueda orgánica de Google para 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. Investigar resultados orgánicos de Google

Prompt: Busca resultados orgánicos de Google para [keyword] en la investigación de AliExpress. Enumera los enlaces y descripciones devueltos sin presentarlos como productos verificados de AliExpress.

2. Revisar otra página de Google

Prompt: Revisa la página [page number] de resultados orgánicos de Google para [keyword], limitada a [limit] resultados. Compara solo los resultados de esta página con los 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.

Proporciona un requestId UUID para un envío idempotente, una palabra clave, un número de página entre 1 y 10 y un límite entre 1 y 10. 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_google_organic_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-google-organic-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_aliexpress_google_organic_search",
    "arguments": {
      "keyword": "wireless earbuds",
      "limit": 1,
      "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-google-organic-search-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
`requestId`	`string`	obligatorio	UUID generado por el cliente. Reutilízalo al reintentar un envío de resultado incierto.
`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.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 investigo resultados orgánicos de Google relacionados con AliExpress?

Pasos sugeridos

Genera y conserva un requestId UUID, envía la palabra clave y consulta nexscope_aliexpress_access_task_result con el taskId devuelto. Trata los enlaces como resultados de Google, no como coincidencias verificadas de productos.

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": "site:aliexpress.com phone case",
  "pageNum": 1,
  "limit": 3
}

Respuesta

{
  "code": 0,
  "data": {
    "status": "SUCCEEDED",
    "result": {
      "serp": {
        "engine": "google",
        "items": [
          {
            "title": "AliExpress Business",
            "url": "https://inbusiness.aliexpress.com/",
            "snippet": "$64 OFF orders US $400+ Restocking … $10 OFF orders US $65+ CAD1114 Upcoming US $4 OFF orders US $25+. Free return Sourcing Festival. AliExpress Free ...",
            "rank": 1
          },
          {
            "title": "AliExpress – kupuj online produkty najwyższej jakości w ...",
            "url": "https://pl.aliexpress.com/",
            "snippet": "Pasja nie powinna kosztować fortuny. Na AliExpress złapiesz ponad 111 milionów cennych ofert online na modę, akcesoria, elektronikę, zabawki, narzędzia, ...",
            "rank": 2
          },
          {
            "title": "AliExpress - Compra online de Electrónica, Moda, Casa y ...",
            "url": "https://cl.aliexpress.com/",
            "snippet": "Con nuestro servicio de chino a domicilio, recibirás tu pedido de forma segura. Utiliza nuestro sistema de tracking para seguir tu bolsa de compras en todo ...",
            "rank": 3
          }
        ],
        "invalidItems": 0
      }
    }
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos