Nexscope

API de selección de productos de Mercado Libre

Investiga productos, vendedores y palabras clave de Mercado Libre en cinco mercados. Invoca la API mediante REST o MCP desde 10 créditos por llamada.

Coste10 créditos / llamada
Probar en línea
POST · https://api.nexscope.ai/mercado/productSelectionMCP · nexscope_mercado_product_selection

Qué hace esta API

Investigar productos, vendedores y palabras clave del Mercado Libre en cinco mercados.

Casos de uso de API de selección de productos de Mercado Libre

Buscar productos que coincidan con un resumen de abastecimiento

Para encontrar productos que coincidan con un informe de abastecimiento, un analista de mercado presenta `toolName` y `arguments` a Mercado Selección de Productos. El errcode devuelto, errmsg, toolName ayudar a identificar productos que coincidan con los criterios de búsqueda solicitados.

Comparar una lista de búsqueda de productos

Un analista de mercado utiliza Mercado Selección de productos con `toolName` y `arguments` para comparar una lista de búsqueda de productos. El código de error devuelto, errmsg, toolName ayudar a comparar candidatos antes de solicitar detalles individuales del producto.

Reunir a los candidatos para una revisión del mercado

Para este flujo de trabajo, un analista de mercado llama a Mercado Selección de Productos con `toolName` y `arguments` Para obtener los candidatos a una revisión del mercado, el resultado ayuda a elegir productos para un proveedor o un competidor.

Preguntas frecuentes sobre API de selección de productos de Mercado Libre

¿Qué hace la selección de productos Mercado? API ¿Volver?

Investigación de productos, vendedores y palabras clave del Mercado Libre en cinco mercados. `errcode`, `errmsg`, `toolName`, `rawResponse`, `contentText`, `textParsedAsJson`. Corresponde a los parámetros proporcionados `toolName`, `arguments`. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene la Selección de Productos Mercado API ¿costo?

El coste documentado actualmente es 10 créditos / llamada. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo a la selección de productos Mercado API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /mercado/productSelection con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_mercado_product_selection. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditosConecta esta API con MCP (en inglés)

Prueba esta API
Endpoint
https://api.nexscope.ai/mercado/productSelection
Método MCP
nexscope_mercado_product_selection

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/mercado/productSelection

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/mercado/productSelection' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "arguments": {
    "searchText": "Auriculares",
    "siteId": "MLM"
  },
  "toolName": "categorySearch"
}'

Ejemplo de código

{
  "arguments": {
    "searchText": "Auriculares",
    "siteId": "MLM"
  },
  "toolName": "categorySearch"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

CódigoDescripción
200Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.
Todas las categorías/ Investigación de productos de Mercado Libre
POSThttps://api.nexscope.ai/mercado/productSelection

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/mercado/productSelection
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
toolNamestringobligatorio
Uno de los nombres de 24 herramientas múltiples Meike, ver la tabla a continuación.
argumentsobjectobligatorio
El parámetro objeto de la herramienta correspondiente debe ser un JSON objeto y no puede ser un array, cadena o número; el motor eliminará `uId`, `uid`, `memberId` y recortar valores vacíos.

Respuesta de ejemplo

Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.

No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.

Campos de respuesta

Referencia de campos de respuesta (14 campos)

NombreTipoObligatorioDescripción
codestringopcional
Nexscope estado de la capa de encapsulación; `"200"` sobre el éxito. Puede ser omitido en caso de error de negocio.
msgstringopcional
Mensaje de capa de encapsulación; `"ok"` sobre el éxito.
errcodeintegeropcional
Código de estado de la pasarela; si tiene éxito, es `200`, si hay un error de negocio, no es`200`.
errmsgstringopcional
Error de pasarela o mensaje de estado.
typestringopcional
Actualmente, por lo general `rawMcpToolResult`.
toolNamestringopcional
El nombre de la herramienta realmente llamado.
chargedbooleanopcional
¿Hay una tarifa para esta herramienta?
datastring/object/arrayopcional
Datos comerciales descompilados del MCP contenido de texto; la mayoría de las herramientas devuelven una cadena.
rawResponseobjectopcional
MCP `tools/call` Resultado en bruto; la puerta de enlace actual normalmente devuelve un objeto vacío.
contentTextstringopcional
MCP contenido del texto El texto original empalmado.
textParsedAsJsonbooleanopcional
Si `contentText` se analiza con éxito en JSON; también puede ser `true` cuando el texto está envuelto en un JSON cadena.
totalintegeropcional
Devuelto cuando el número de registros puede ser inferido por el motor; omitido cuando no puede ser inferido, y `null` no se devuelve.
costTokenintegeropcional
El coste token de esta llamada; la herramienta gratuita es `0`, y la herramienta pagada es actualmente `16000`.
costTimeintegeropcional
El motor toma tiempo en milisegundos.

Respuestas

CódigoDescripción
200Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Fuente de datos, vigencia y limitaciones

La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy
POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_mercado_product_selection",
    "arguments": {
      "arguments": {
        "searchText": "Auriculares",
        "siteId": "MLM"
      },
      "toolName": "categorySearch"
    }
  }
}

Ejemplo de datos

Parámetros de solicitud

{
  "toolName": "itemSearch",
  "arguments": {
    "siteId": "MLB",
    "title": "bengalas vstrom",
    "pageNo": 1,
    "pageSize": 50
  }
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": "=== 搜索结果概览 ===\n总记录数:4\n当前页码:1\n每页条数:50\n查询耗时:18 ms\n\n--- 商品 1 ---\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\n商品ID:MLB4332260689\n商品状态:closed\n商品售价:3499.99 BRL\n原价:3499.99\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-11-27T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuki-vstrom-1000-2015-a-2021-_JM\n物流方式:me2\n健康分:0.00\n7天销量:1\n7天销售额:3499.99\n30天销量:1\n30天销售额:3499.99\n总访问量:34\n平均转化率:2.94%\n90天销量:1\n90天销售额:3499.99\n库存:0\n店铺名称:CONCEITOMOTOPARTS01\n店铺类型:LOCAL\n评分:0.0 星\n评价数:0\n\n--- 商品 2 ---\n商品名称:Par Bengalas Suzuki V-strom 1000 Vstrom Ano 14-17\n商品ID:MLB6100216566\n商品状态:paused\n商品售价:4488.9 BRL\n原价:4488.9\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-12-26T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-6100216566-par-bengalas-suzuki-v-strom-1000-vstrom-ano-14-17-_JM\n物流方式:me2\n健康分:0.00\n7天销量:1\n7天销售额:4488.9\n30天销量:1\n30天销售额:4488.9\n总访问量:9\n平均转化率:11.11%\n90天销量:1\n90天销售额:4488.9\n库存:0\n店铺名称:RAFA MOTOPEÇASS\n店铺注册时间:2014-07-30T19:58:06\n店铺类型:LOCAL\n评分:0.0 星\n评价数:0\n\n--- 商品 3 ---\n商品名称:Bengalas Suzuki Vstrom 1000 2008\n商品中文名称: 2008款铃木V-Strom 1000摩托车\n商品ID:MLB3959869539\n商品状态:closed\n商品售价:1500.0 BRL\n原价:1500.0\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-01-24T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-3959869539-bengalas-suzuki-vstrom-1000-2008-_JM\n物流方式:me2\n健康分:-100.00\n7天销量:0\n7天销售额:0.0\n30天销量:0\n30天销售额:0.0\n90天销量:1\n90天销售额:1500.0\n库存:0\n店铺名称:PLANETAMOTOSBRASIL\n店铺注册时间:2015-07-24T10:44:36\n店铺类型:LOCAL\n\n--- 商品 4 ---\n商品名称:Bengalas Suzuki Vstrom 1000 2018\n商品中文名称: 2018款铃木V-Strom 1000摩托车\n商品ID:MLB4002858897\n商品状态:closed\n商品售价:2999.0 BRL\n原价:2999.0\n总销量:1\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\n上架时间:2025-03-14T00:00:00\n商品链接:https://produto.mercadolivre.com.br/MLB-4002858897-bengalas-suzuki-vstrom-1000-2018-_JM\n物流方式:me2\n健康分:-100.00\n7天销量:0\n7天销售额:0.0\n30天销量:0\n30天销售额:0.0\n90天销量:1\n90天销售额:2999.0\n库存:0\n店铺名称:OHANNASMOTOPARTS\n店铺注册时间:2009-12-22T21:51:20\n店铺类型:LOCAL\n\n",
    "rawResponse": {},
    "contentText": "\"=== 搜索结果概览 ===\\n总记录数:4\\n当前页码:1\\n每页条数:50\\n查询耗时:18 ms\\n\\n--- 商品 1 ---\\n商品名称:Par Bengalas C/abs Suzuki Vstrom 1000 2015 A 2021\\n商品ID:MLB4332260689\\n商品状态:closed\\n商品售价:3499.99 BRL\\n原价:3499.99\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-11-27T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-4332260689-par-bengalas-cabs-suzuki-vstrom-1000-2015-a-2021-_JM\\n物流方式:me2\\n健康分:0.00\\n7天销量:1\\n7天销售额:3499.99\\n30天销量:1\\n30天销售额:3499.99\\n总访问量:34\\n平均转化率:2.94%\\n90天销量:1\\n90天销售额:3499.99\\n库存:0\\n店铺名称:CONCEITOMOTOPARTS01\\n店铺类型:LOCAL\\n评分:0.0 星\\n评价数:0\\n\\n--- 商品 2 ---\\n商品名称:Par Bengalas Suzuki V-strom 1000 Vstrom Ano 14-17\\n商品ID:MLB6100216566\\n商品状态:paused\\n商品售价:4488.9 BRL\\n原价:4488.9\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-12-26T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-6100216566-par-bengalas-suzuki-v-strom-1000-vstrom-ano-14-17-_JM\\n物流方式:me2\\n健康分:0.00\\n7天销量:1\\n7天销售额:4488.9\\n30天销量:1\\n30天销售额:4488.9\\n总访问量:9\\n平均转化率:11.11%\\n90天销量:1\\n90天销售额:4488.9\\n库存:0\\n店铺名称:RAFA MOTOPEÇASS\\n店铺注册时间:2014-07-30T19:58:06\\n店铺类型:LOCAL\\n评分:0.0 星\\n评价数:0\\n\\n--- 商品 3 ---\\n商品名称:Bengalas Suzuki Vstrom 1000 2008\\n商品中文名称: 2008款铃木V-Strom 1000摩托车\\n商品ID:MLB3959869539\\n商品状态:closed\\n商品售价:1500.0 BRL\\n原价:1500.0\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-01-24T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-3959869539-bengalas-suzuki-vstrom-1000-2008-_JM\\n物流方式:me2\\n健康分:-100.00\\n7天销量:0\\n7天销售额:0.0\\n30天销量:0\\n30天销售额:0.0\\n90天销量:1\\n90天销售额:1500.0\\n库存:0\\n店铺名称:PLANETAMOTOSBRASIL\\n店铺注册时间:2015-07-24T10:44:36\\n店铺类型:LOCAL\\n\\n--- 商品 4 ---\\n商品名称:Bengalas Suzuki Vstrom 1000 2018\\n商品中文名称: 2018款铃木V-Strom 1000摩托车\\n商品ID:MLB4002858897\\n商品状态:closed\\n商品售价:2999.0 BRL\\n原价:2999.0\\n总销量:1\\n类目ID:MLB243149 类目路径:Bengalas > Chassis > Peças de Motos e Quadriciclos > Acessórios para Veículos\\n上架时间:2025-03-14T00:00:00\\n商品链接:https://produto.mercadolivre.com.br/MLB-4002858897-bengalas-suzuki-vstrom-1000-2018-_JM\\n物流方式:me2\\n健康分:-100.00\\n7天销量:0\\n7天销售额:0.0\\n30天销量:0\\n30天销售额:0.0\\n90天销量:1\\n90天销售额:2999.0\\n库存:0\\n店铺名称:OHANNASMOTOPARTS\\n店铺注册时间:2009-12-22T21:51:20\\n店铺类型:LOCAL\\n\\n\"",
    "type": "rawMcpToolResult",
    "costTime": 685,
    "charged": true,
    "textParsedAsJson": true,
    "toolName": "itemSearch"
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

10 créditos / llamadaRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint
/mercado/productSelection
Método de MCP
nexscope_mercado_product_selection
cURL
curl -X POST \
  https://api.nexscope.ai/mercado/productSelection \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "arguments": { "searchText": "Auriculares", "siteId": "MLM" }, "toolName": "categorySearch" }'
Respuesta
Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.