Datos públicos del mercado de Amazon

API de búsqueda por imagen de Amazon MCP

Encontrar productos de Amazon visualmente similares de una imagen URL en ocho mercados, con enriquecimiento opcional de datos-venta. Llámalo REST API o MCP.

CosteRecent 32 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de búsqueda por imagen de Amazon

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. Encontrar productos de una imagen

Prompt: Encontrar productos de Amazon visualmente similares en [MARKETPLACE] usando mi imagen pública [IMAGE_URL]. Mantenga el formato de resultado del proveedor original y describa sólo los productos devueltos.

2. Verificar los partidos de imagen transfronteriza

Prompt: Encontrar productos de Amazon visualmente similares en [MARKETPLACE] usando mi imagen pública [IMAGE_URL]. País de destino [DESTINATION_COUNTRY] sin un código postal de entrega local. No utilice el mercado de la India para esta solicitud transfronteriza.

3. Compruebe los resultados para un área de entrega

Prompt: Encontrar productos de Amazon visualmente similares en [MARKETPLACE] usando mi imagen pública [IMAGE_URL]. Uso del código postal de entrega [POSTAL_CODE] dentro del mercado seleccionado y preservar el contexto de entrega en el resumen.

4. Comparar coincidencias de imagen con datos de producto

Prompt: Buscar productos de Amazon que coincidan [IMAGE_URL] dentro [MARKETPLACE]. [INCLUDE_OR_SKIP] el rango de ventas opcional, ventas mensuales, FBA datos de tarifas y dimensiones; mantener los valores no disponibles explícitamente.

5. Mantener la orden original de relevancia

Prompt: Encontrar productos de Amazon visualmente similares en [MARKETPLACE] usando mi imagen pública [IMAGE_URL]. Mantener el orden de relevancia predeterminado y describir sólo los resultados devueltos.

6. Priorizar las coincidencias por precio

Prompt: Encontrar productos de Amazon visualmente similares en [MARKETPLACE] usando mi imagen pública [IMAGE_URL]. Establece [RANKING_PRIORITY] como criterio principal y elige el precio más bajo primero o más alto precio primero.

7. Priorizar los partidos por clasificaciones o cuentas de revisión

Prompt: Encontrar productos de Amazon visualmente similares en [MARKETPLACE] usando mi imagen pública [IMAGE_URL]. Establece [RANKING_PRIORITY] como criterio principal y elige la puntuación más baja primero, la puntuación más alta primero, pocos comentarios primero o la mayoría de los comentarios primero.

8. Seleccionar coincidencias de imagen clasificadas

Prompt: Encontrar productos de Amazon visualmente similares [PUBLIC_IMAGE_URL] dentro [MARKETPLACE]. Regresar una lista corta clasificada con enriquecimiento de productos y las cavernas fuente. Aparecer [ONE_TO_100_MATCHES] fósforos, y tratar la similitud visual como un plomo de investigación en lugar de prueba del mismo producto.

Qué debes proporcionar

Sustituye los marcadores entre corchetes por tus propios datos de investigación. Indica expresamente las estimaciones de la fuente, los períodos de los informes y la información que falte.

Elija el resultado del proveedor original o una lista corta clasificada. La lista corta clasificada incluye enriquecimiento y acepta de uno a 100 partidos; dejando el tamaño de usos no especificados 20. Los datos de los productos perdidos siguen sin estar disponibles.

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_amazon_search_by_image

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": "amazon-search-by-image-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_search_by_image",
    "arguments": {
      "aggregateByKeepaData": false,
      "amazonDomain": "amazon.com",
      "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
    }
  }
}

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.

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`imageUrl`	`string`	obligatorio	Imagen válida y accesible al público URL (máximo 1.000 caracteres) Ejemplo: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg
`amazonDomain`	`string`	obligatorio	Mercado de Amazon. Dominios respaldados: Estados Unidos (Estados Unidos)amazon.com), Reino Unido (amazon.co.ukAlemaniaamazon.de), Francia (amazon.fr), Italia (amazon.it), España (amazon.es), Japón (amazon.co.jp), y India (amazon.in). Default: amazon.com Ejemplo: amazon.com
`sort`	`string`	opcional	Ordenar por precio, puntuación o cuenta de puntuación. Valores: default, price-asc-rank, price-desc-rank, rating-asc-rank, rating-desc-rank, ratings-asc-rank, and ratings-desc-rank
`deliveryZip`	`string`	opcional	Entrega de código postal o ciudad dentro del mercado seleccionado. Si se omite, se utiliza el defecto del mercado. Máximo 1.000 caracteres. Defaults: United States=10001, United Kingdom=EC1A 1BB, Alemania=10115, Francia=75001, Italia=00100, España=28001, Japón=100-0001, e India=110034
`countryOrAreaCode`	`string`	opcional	Código de país o región de destino para la entrega transfronteriza, como CN, JP, KR, TW, HK, MO, SG, TH, VN, PHo MY. No proporcionar esto junto con deliveryZip. Amazon India no apoya la configuración de destino transfronterizo. Máximo 1.000 caracteres
`aggregateByKeepaData`	`boolean`	opcional	Ya sea para enriquecer resultados con Nexscope datos tales como rango de ventas, ventas mensuales, FBA honorarios y dimensiones Ejemplo: false
`responseFormat`	`string`	opcional	raw (default) devuelve el resultado del proveedor; coincide con el enriquecimiento de fuerzas y devuelve los partidos clasificados. Ejemplo: raw
`topN`	`integer`	opcional	Combinaciones máximas en modo de partidos, sujetadas a 1-100; predeterminado 20. Ejemplo: 20

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`caveats`	`array`	opcional	Valor de Caveats usado por esta operación de API.
`caveats[]`	`string`	obligatorio	Elemento de caveats.
`matches`	`array`	opcional	Coincidencias visuales con enriquecimiento opcional del proveedor.
`matches[]`	`object`	obligatorio	Elemento de matches.
`matches[].asin`	`string`	opcional	Valor de Asin usado por esta operación de API.
`matches[].estimatedMonthlySales`	`integer`	opcional	Valor de Estimated monthly sales usado por esta operación de API.
`matches[].imageUrl`	`string`	opcional	Valor de Image url usado por esta operación de API.
`matches[].price`	`number`	opcional	Valor de Price usado por esta operación de API.
`matches[].rank`	`integer`	opcional	Valor de Rank usado por esta operación de API.
`matches[].rating`	`number`	opcional	Valor de Rating usado por esta operación de API.
`matches[].title`	`string`	opcional	Valor de Title usado por esta operación de API.
`query`	`object`	opcional	Consulta de búsqueda de imagen normalizada en modo de fósforos.

Campos documentados adicionales

Nombre	Tipo	Obligatorio	Descripción
`total`	`integer`	opcional	Número total de filas. Ejemplo: null
`totalCount`	`integer`	opcional	Cantidad total. Ejemplo: null
`perPage`	`integer`	opcional	Cantidad por página. Ejemplo: null
`currentPage`	`integer`	opcional	Número de página actual. Ejemplo: null
`type`	`string`	opcional	Rendering estilo. Ejemplo: null
`sourceType`	`string`	opcional	Tipo fuente. Ejemplo: null
`columns`	`array`	opcional	Columnas rendidas. Ejemplo: null
`costToken`	`integer`	opcional	Consume Token. Ejemplo: null
`products`	`array`	opcional	Lista de productos. Ejemplo: null
`asin`	`string`	opcional	ASIN。 Ejemplo: null
`title`	`string`	opcional	Título del producto. Ejemplo: null
`imageUrl`	`string`	opcional	Imagen URL, es decir, la dirección de solicitud. Ejemplo: null
`asinUrl`	`string`	opcional	Amazon ASIN detalles URL. Ejemplo: null
`price`	`number`	opcional	El precio actual, en la moneda correspondiente. Ejemplo: null
`oldPrice`	`number`	opcional	Precio fijo. Ejemplo: null
`currency`	`string`	opcional	Moneda. Ejemplo: null
`rating`	`number`	opcional	Valoración actual, rango 0.0-5.0. Ejemplo: null
`ratings`	`integer`	opcional	Número de valoraciones. Ejemplo: null
`brand`	`string`	opcional	Brand. Ejemplo: null
`sourceType`	`string`	opcional	Tipo fuente. Ejemplo: null
`salesRank`	`integer`	opcional	Ranking de ventasKP). Ejemplo: null
`salesRank30`	`integer`	opcional	Clasificación promedio de ventas (KPEn los últimos 30 días. Ejemplo: null
`salesRank90`	`integer`	opcional	Clasificación promedio de ventas (KPEn los últimos 90 días. Ejemplo: null
`salesRank180`	`integer`	opcional	Clasificación promedio de ventas (KPEn los últimos 180 días. Ejemplo: null
`monthlySalesUnits`	`integer`	opcional	Volumen de ventas mensualesKP). Ejemplo: null
`monthlySalesRevenue`	`number`	opcional	Ventas mensuales. Ejemplo: null
`reviewCount`	`integer`	opcional	Número de comentarios (KP). Ejemplo: null
`fbaFees`	`number`	opcional	FBA tasa de entrega, la unidad es la moneda correspondiente. Ejemplo: null
`profit`	`number`	opcional	Porcentaje de ganancia, por ejemplo 25,5 significa 25,5%. Ejemplo: null
`referralFeePercentage`	`number`	opcional	Porcentaje de honorarios de referencia. Ejemplo: null
`fulfillment`	`string`	opcional	Método de entrega: `AMZ`, `FBA`, `FBM`. Ejemplo: null
`primePrice`	`number`	opcional	Prime Price. Ejemplo: null
`buyBoxSellerId`	`string`	opcional	Comprar botón vendedor ID. Ejemplo: null
`sellerNum`	`integer`	opcional	Número de vendedores. Ejemplo: null
`variationNum`	`integer`	opcional	Número de variantes. Ejemplo: null
`parentAsin`	`string`	opcional	Parent ASIN. Ejemplo: null
`availableDate`	`string`	opcional	Tiempo de estante, en el formato de `yyyy-MM-dd HH:mm:ss`. Ejemplo: null
`lastUpdate`	`string`	opcional	Última actualización, en el formato de `yyyy-MM-dd HH:mm:ss`. Ejemplo: null
`manufacturer`	`string`	opcional	fabricante. Ejemplo: null
`model`	`string`	opcional	modelo. Ejemplo: null
`color`	`string`	opcional	color. Ejemplo: null
`material`	`string`	opcional	Material de producto. Ejemplo: null
`weight`	`string`	opcional	Peso en gramos. Ejemplo: null
`dimension`	`string`	opcional	tamaño. Ejemplo: null
`itemLength`	`integer`	opcional	Longitud del producto en milímetros; 0 o -1 si no está disponible. Ejemplo: null
`itemWidth`	`integer`	opcional	Ancho de producto en milímetros; 0 o -1 si no está disponible. Ejemplo: null
`itemHeight`	`integer`	opcional	Altura del producto en milímetros; 0 o -1 si no está disponible. Ejemplo: null
`packageLength`	`integer`	opcional	Longitud del paquete en milímetros. Ejemplo: null
`packageWidth`	`integer`	opcional	Ancho de paquete en milímetros. Ejemplo: null
`packageHeight`	`integer`	opcional	Altura del paquete en milímetros. Ejemplo: null
`packageWeight`	`string`	opcional	Empaquetar peso en gramos. Ejemplo: null
`packageDimensions`	`string`	opcional	Tamaño de embalaje. Ejemplo: null
`packageQuantity`	`integer`	opcional	Número de artículos en el paquete; 0 o -1 si no está disponible. Ejemplo: null
`dimensionsType`	`string`	opcional	Tipo de tamaño. Ejemplo: null
`categoryTree`	`string`	opcional	Árbol de categoría. Ejemplo: null
`categoryTreeId`	`string`	opcional	Categoría árbol ID. Ejemplo: null
`rootCategory`	`integer`	opcional	Categoría de raíces ID. Ejemplo: null
`isAdultProduct`	`boolean`	opcional	Ya sea un producto adulto. Ejemplo: null
`isHazmat`	`boolean`	opcional	Ya sea mercancías peligrosas. Ejemplo: null
`urlSlug`	`string`	opcional	URL Slug. Ejemplo: null
`productImageUrls`	`array`	opcional	Lista de imágenes de producto. Ejemplo: null

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Encontrar Amazon US productos que parecen similares al producto en mi imagen.

Explicación ilustrativa de la respuesta

El resultado ilustrativo contiene “Example visualmente similar product”, ASIN B000000001, precio a USD 19.99. La similitud visual por sí sola no establece que es el mismo modelo o marca.

Sobre esta muestra: Ejemplo meramente ilustrativo: los nombres, identificadores y cifras son ficticios y no se hizo una llamada real. Tus resultados dependen de tu cuenta, las entradas y los datos disponibles.

No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.

Ver el formato de solicitud y respuesta MCP

Ejemplos

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

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": "amazon-search-by-image-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_search_by_image",
    "arguments": {
      "aggregateByKeepaData": false,
      "amazonDomain": "amazon.com",
      "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "amazon-search-by-image-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"products\":[{\"asin\":\"B000000001\",\"title\":\"Example visually similar product\",\"price\":19.99,\"currency\":\"USD\"}]}}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "msg": null,
      "data": {
        "total": 1,
        "products": [
          {
            "asin": "B000000001",
            "title": "Example visually similar product",
            "price": 19.99,
            "currency": "USD"
          }
        ]
      }
    },
    "isError": false
  }
}