Investigación de Amazon ST
API de búsqueda de productos del mercado de Amazon MCP
Filtrar productos Amazon utilizando datos de mercado y instantáneas mensuales. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de búsqueda de productos del mercado 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. Buscar productos similares
Prompt: Encontrar productos similares a ASIN [ASIN] en Amazon US. Mostrar los detalles del producto devueltos y las estimaciones de ventas no disponibles de la bandera.
2. Examine una categoría
Prompt: Buscar productos en Amazon US categoría [category ID]. Mostrar los detalles del producto devueltos y las estimaciones de ventas no disponibles de la bandera.
3. Investigación de una marca
Prompt: Encontrar productos de [brand] en Amazon US. Mostrar los detalles del producto devueltos y las estimaciones de ventas no disponibles de la bandera.
4. Investigación a Vendedor por Nombre
Prompt: Buscar productos vendidos por [store name] en Amazon US. Mostrar los detalles del producto devueltos y las estimaciones de ventas no disponibles de la bandera.
5. Investigación a Vendedor por ID
Prompt: Encontrar productos de vendedor [seller ID] en Amazon US. Mostrar los detalles del producto devueltos y las estimaciones de ventas no disponibles de la bandera.
6. Buscar productos de un ABA Palabra clave
Prompt: Encontrar Amazon US productos asociados con la palabra clave de Brand Analytics [keyword]. Mostrar los detalles del producto devueltos y las estimaciones de ventas no disponibles de la bandera.
7. Buscar Títulos y Atributos
Prompt: Encontrar Amazon US productos con [keywords] en su título o atributos. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
8. Filtro por precio
Prompt: Encontrar Amazon US productos precio entre $10 y $20. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
9. Filtro por ventas mensuales
Prompt: Encontrar Amazon US productos con 100 a 1.000 unidades de ventas mensuales. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
10. Buscar productos de temporada
Prompt: Encontrar Amazon US productos que alcanzan el pico en octubre, noviembre o diciembre. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
11. Buscar productos nuevos
Prompt: Encontrar Amazon US productos enumerados entre el 1 de enero y el 30 de junio de 2026. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
12. Filtro por valoración
Prompt: Encontrar Amazon US productos clasificados entre cuatro y cinco estrellas. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
13. Filtro por Cuenta de Revisión
Prompt: Encontrar Amazon US productos con 10 a 500 opiniones. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
14. Filtro por Categoría Rank
Prompt: Encontrar Amazon US productos con categoría principal de 500 a 5.000 y subcategoría de 1 a 100. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
15. Filtro por relleno
Prompt: Encontrar Amazon US productos cumplidos por Amazon, por comerciantes, o bien, según [my fulfillment preference]. Mostrar los detalles del producto devueltos y las estimaciones de ventas no disponibles de la bandera.
16. Filtro por Cuenta de Variación
Prompt: Encontrar Amazon US productos con 1 a 50 variaciones. Mostrar los detalles de producto devueltos y las estimaciones de ventas no disponibles de la bandera.
17. Combine filtros de productos
Prompt: Encontrar Amazon US productos a un precio de 20 dólares o menos con al menos 500 unidades de ventas mensuales. Aplicar ambas condiciones juntos y mostrar los productos de juego.
18. Revise una instantánea histórica
Prompt: Mostrar productos en Amazon US categoría [category ID] para noviembre de 2024. Mantenga el mes de instantánea visible para poder distinguir las figuras históricas de los datos actuales.
19. Leer otra página de resultados
Prompt: Continuar la misma Amazonía US búsqueda de productos en la página [page number]. Mantener mis filtros sin cambios. Mostrar esta página por separado de los resultados anteriores.
Qué debes proporcionar
Proporcionar un mercado y la categoría, marca, vendedor, ASIN, ABA valores de palabras clave o filtro para su búsqueda.
Los mercados apoyados son los US, UKAlemania, Francia, India, Canadá, Japón, España, Italia, México, UAE, Australia, Brasil y Arabia Saudita.
Las instantáneas históricas comienzan en enero de 2024. Australia, Brasil e India no apoyan el retrospectivo histórico; fuera del US, UK y Alemania, el lookback se limita a los 100 productos más altos.
A similar-ASIN búsqueda encuentra productos relacionados, no sólo la entrada ASIN. Valores de ventas de -1 significa que una estimación no está disponible.
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/jsonAutenticació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
nexscope_amazon_market_product_searchhttps://api.nexscope.ai/mcptools/callInicializa 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-market-product-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_market_product_search",
"arguments": {
"marketplace": "us",
"page": 1,
"queryMode": 1,
"queryType": 1,
"queryValue": "B072MQ5BRX"
}
}
}MCP 2025-11-25 · Streamable HTTPLa 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 |
|---|---|---|---|
marketplace | string | obligatorio | Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa Ejemplo: us |
queryMode | integer | opcional | Modo de consulta. 1: consulta de condiciones únicas (por defecto); 2: consulta combinada multicondición (AND relación) Ejemplo: 1 |
queryType | integer | opcional | Tipo de consulta (1-16), sólo eficaz cuando queryMode=1. Ver la descripción completa de los tipos de consulta SKILL.md Ejemplo: 1 |
queryValue | string | opcional | Valor de las condiciones de consulta, el formato varía según queryMode y queryType. Ver la descripción del formato para cada queryType dentro SKILL.md Ejemplo: phone case |
page | integer | opcional | Número de página, predeterminado 1. Max 100 productos por página Ejemplo: 1 |
queryMonth | string | opcional | Mirador histórico mes, formato yyyy-MM. Cuando no se especifica, consulta datos en tiempo real Ejemplo: 2026-01 |
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 | Código de respuesta, `200` indica éxito. |
msg | string | opcional | Responde al mensaje. |
total | integer | opcional | Número total de resultados. |
page | integer | opcional | Número de página actual. |
pageCount | integer | opcional | Número total de páginas, hasta 200 páginas. |
costTime | integer | opcional | Tiempo tomado, unidad ms. |
costToken | integer | opcional | El número de fichas consumidas. |
requestConsumed | integer | opcional | El número de solicitudes consumidas. |
type | string | opcional | Rendering estilo. |
columns | array | opcional | Render la columna. |
products | array | opcional | Lista de productos; campos de elementos se muestran en la tabla siguiente. |
asin | string | opcional | ASIN。 |
title | string | opcional | Título del producto. |
brand | string | opcional | Brand. |
asinUrl | string | opcional | Amazon Lista página de detalles URL. |
imageUrl | string | opcional | Imagen principal URL. |
productImageUrls | array | opcional | Toda la imagen del producto URLs. |
parentAsin | string | opcional | Parent ASIN; `null` si no hay hijo. |
variationNum | integer | opcional | Número de variantes. |
weight | string | opcional | Peso, unidad g. |
size | array | opcional | Dimensiones del embalaje/envase exterior `[longest side, second longest side, shortest side]`, unidad cm. |
price | number | opcional | Precio actual, antes de los cupones, en moneda local. |
oldPrice | number | opcional | Precio acelerado en moneda local. |
salesPrice | number | opcional | Precio tras deducir cupones, en moneda local. |
coupon | integer | opcional | Política de cupón; valor no negativo es la cantidad de descuento, el valor negativo es el porcentaje de descuento. |
fbaFees | number | opcional | FBA tarifas en moneda local. |
fbaDetail | array | opcional | FBA Detalles. |
platformFee | number | opcional | Comisión de Plataforma, en moneda local. |
profitAmount | number | opcional | Profit, calculado como precio recibido - FBA comisión, en moneda local. |
profitRate | number | opcional | margen de ganancia, por ejemplo `25.83` significa 25.83%. |
monthlySalesUnits | integer | opcional | Lista de ventas mensuales en los últimos 30 días; `-1` indica que no se puede estimar. |
monthlySalesRevenue | number | opcional | Estimación de las ventas mensuales en moneda local; `-1` los medios no pueden ser estimados. |
listingSalesVolumeOfDaily | integer | opcional | Lista de volumen de ventas diario; `-1` significa que no puede ser estimado. |
listingSalesOfDaily | number | opcional | Lista de ventas diarias, en moneda local; `-1` significa que no puede ser estimado. |
salesRank | integer | opcional | BSR clasificación de categoría. Cuanto menor sea el valor, mejor será el ranking. |
category | array | opcional | Categoría `[category name, NodeId]`. |
bsrCategory | array | opcional | Lista de clasificación de categorías pequeñas, los elementos incluyen `nodeId`, `name`, `rank`, `date` (`yyyyMMdd`). |
rating | number | opcional | Valoración actual, rango 0.0-5.0. |
ratings | integer | opcional | Número de valoraciones. |
availableDate | string | opcional | Tiempo de estante, formato `yyyy-MM-dd`. |
onlineDays | integer | opcional | Número de días en estante. |
buyboxSeller | string | opcional | Nombre del vendedor de la caja. |
buyBoxSellerId | string | opcional | vendedor de caja ID. |
buyboxSellerAddress | string | opcional | El código de dos dígitos del vendedor de Buybox country/region; cuando Amazon es autooperado, es `null`. |
isFBA | boolean | opcional | Do Buybox vendedores uso FBA. |
sellerNum | integer | opcional | Número de vendedores. |
aPlus | boolean | opcional | A+ o no. |
hasVideo | boolean | opcional | Hay un video. |
hasBrandStore | boolean | opcional | ¿Hay una tienda de marcas? |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Encontrar productos similares a ASIN B072MQ5BRX en Amazon US.
Explicación ilustrativa de la respuesta
El resultado ilustrativo contiene un producto similar, “Example phone case”, con 300 unidades de ventas mensuales y una puntuación de 4.5. Búsqueda de producto similar no recupera solamente la entrada ASIN.
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-market-product-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_market_product_search",
"arguments": {
"marketplace": "us",
"page": 1,
"queryMode": 1,
"queryType": 1,
"queryValue": "B072MQ5BRX"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-market-product-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"page\":1,\"products\":[{\"asin\":\"B000000001\",\"title\":\"Example phone case\",\"monthlySalesUnits\":300,\"rating\":4.5}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"page": 1,
"products": [
{
"asin": "B000000001",
"title": "Example phone case",
"monthlySalesUnits": 300,
"rating": 4.5
}
]
}
},
"isError": false
}
}