Historial de Amazon KP
API de búsqueda en la base de datos de productos de Amazon MCP
Encontrar productos de Amazon utilizando el precio detallado, ventas, tamaño y filtros de envío. Llamada vía REST API o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de búsqueda en la base de datos de productos 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 la base de datos de productos Amazon
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE].
2. Elige categorías de raíz por ID
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Use root categories [CATEGORY_IDS], sin más de 50 IDs.
3. Seleccione las categorías de raíz por nombre
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Use root categories [CATEGORY_NAMES_OR_PATHS], sin más de 50 nombres, y dejar que el servicio resuelva IDs. Dejar el correspondiente ID lista vacía.
4. Elija subcategorías incluidas ID
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Uso de subcategorías incluidas [CATEGORY_IDS], sin más de 50 IDs.
5. Elija subcategorías incluidas por nombre
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Uso de subcategorías incluidas [CATEGORY_NAMES_OR_PATHS], sin más de 50 nombres, y dejar que el servicio resuelva IDs. Dejar el correspondiente ID lista vacía.
6. Elija subcategorías excluidas ID
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Uso de subcategorías excluidas [CATEGORY_IDS], sin más de 50 IDs.
7. Elija subcategorías excluidas por nombre
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Uso de subcategorías excluidas [CATEGORY_NAMES_OR_PATHS], sin más de 50 nombres, y dejar que el servicio resuelva IDs. Dejar el correspondiente ID lista vacía.
8. Encontrar un tamaño específico del producto
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos que coincidan con cualquiera de estos tamaños: [PRODUCT_SIZES].
9. Buscar productos físicos estándar
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Limitar el tipo de producto a los productos físicos estándar.
10. Buscar productos descargables
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Limite el tipo de producto a los productos descargables.
11. Encontrar eBooks
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Limitar el tipo de producto a eBooks.
12. Buscar padre ASINs
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Limitar el tipo de producto a la variante padre ASINs.
13. Revisar varias páginas de resultados
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Recoger hasta 3 páginas para esta tarea de investigación. Solicitar 50 resultados por página. Pare antes si no hay otra página, un resultado vacío o un error. Deduplicar identificadores de coincidencia y no describir la muestra como el mercado completo.
14. Buscar productos de una marca
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos de [BRAND].
15. Buscar productos en colores seleccionados
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos que coincidan con cualquiera de estos colores: [COLORS].
16. Buscar productos por rango de ventas actual
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con rango de ventas actual entre [LOWER_LIMIT] y [UPPER_LIMIT].
17. Buscar productos por rango medio de ventas de 90 días
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con un rango promedio de ventas de 90 días entre [LOWER_LIMIT] y [UPPER_LIMIT].
18. Buscar productos por porcentaje de cambio de rango de ventas de 90 días
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con un porcentaje de cambio de rango de ventas de 90 días entre [LOWER_LIMIT] y [UPPER_LIMIT] por ciento.
19. Buscar productos por unidades vendidas / ventas mensuales
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con unidades vendidas / ventas mensuales entre [LOWER_LIMIT] y [UPPER_LIMIT].
20. Buscar productos por rango histórico mensual de ventas
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con rango histórico mensual de ventas entre [LOWER_LIMIT] y [UPPER_LIMIT]. Uso [HISTORICAL_MONTH] dentro de los últimos 36 meses.
21. Buscar productos por precio nuevo actual
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con el nuevo precio actual entre [LOWER_LIMIT] y [UPPER_LIMIT] en las unidades monetarias menores del mercado.
22. Buscar productos por precio actual de la caja de compra con envío
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con el precio actual de la caja de compra con el envío entre [LOWER_LIMIT] y [UPPER_LIMIT] en las unidades monetarias menores del mercado.
23. Buscar productos por cuenta de revisión actual
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con cuenta de revisión actual entre [LOWER_LIMIT] y [UPPER_LIMIT].
24. Encontrar productos por clasificación actual
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con la calificación actual entre [LOWER_LIMIT] y [UPPER_LIMIT].
25. Buscar productos por longitud de paquete
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con longitud de paquete entre [LOWER_LIMIT] y [UPPER_LIMIT] milímetros.
26. Buscar productos por ancho de paquete
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con ancho de paquete entre [LOWER_LIMIT] y [UPPER_LIMIT] milímetros.
27. Buscar productos por altura de paquete
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con altura de paquete entre [LOWER_LIMIT] y [UPPER_LIMIT] milímetros.
28. Buscar productos por peso de paquete
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con peso del paquete entre [LOWER_LIMIT] y [UPPER_LIMIT] gramos.
29. Encontrar productos por fechas de lanzamiento de productos
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Limitar los resultados a las fechas de lanzamiento de productos entre [START_DATE] y [END_DATE]. Conserva las fechas registradas; no supongas que corresponden al momento de la consulta.
30. Buscar productos por cuenta de variación
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con recuento de variación entre [LOWER_LIMIT] y [UPPER_LIMIT].
31. Buscar productos por cuenta nueva oferta actual
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con la nueva oferta actual contar entre [LOWER_LIMIT] y [UPPER_LIMIT].
32. Buscar productos por 90 días de descuento
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con un porcentaje de 90 días fuera de existencia entre [LOWER_LIMIT] y [UPPER_LIMIT] por ciento.
33. Buscar productos por Comprar vendedor de caja
Prompt: Buscar [KEYWORD] dentro [MARKETPLACE] y guardar productos cuyo vendedor de caja de compra es [AMAZON_OR_ANOTHER_SELLER].
34. Buscar productos por Comprar Relleno de caja
Prompt: Buscar [KEYWORD] dentro [MARKETPLACE] y mantener Buy Box ofrece que [USE_OR_DO_NOT_USE] FBA.
35. Filtros por estado peligroso
Prompt: Encontrar [HAZARDOUS_OR_NON_HAZARDOUS] productos que coincidan [KEYWORD] dentro [MARKETPLACE], utilizando el estado devuelto por la fuente.
36. Revisar las variaciones del producto
Prompt: Buscar [KEYWORD] dentro [MARKETPLACE]. [LIMIT_OR_DO_NOT_LIMIT] los resultados a una variación por producto multivariación.
37. Evaluaciones de productos de investigación
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. [FETCH_OR_SKIP] la información opcional de calificación de producto.
38. Obtener información de producto sin historia
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Volver información del producto sin datos históricos.
39. Datos históricos del producto
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Incluir la historia del producto disponible y las ventas históricas, conservando las fechas y estimaciones de la fuente.
40. Priorizar los resultados mediante la inclusión de fechas
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Establece [RANKING_PRIORITY] como criterio principal y elige la fecha del listado. Utiliza el orden [ASCENDING_OR_DESCENDING].
41. Priorizar los resultados por ventas y conversiones
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Establece [RANKING_PRIORITY] como criterio principal y elige el rango de ventas actual o unidades mensuales vendidas. Utiliza el orden [ASCENDING_OR_DESCENDING].
42. Priorizar los resultados de la retroalimentación del cliente
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Establece [RANKING_PRIORITY] como criterio principal y elige el recuento de calificación o revisión. Utiliza el orden [ASCENDING_OR_DESCENDING].
43. Priorizar los resultados por precio, ingresos y costos
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Establece [RANKING_PRIORITY] como criterio principal y elige Comprar precio de caja incluyendo el envío o precio de venta nueva. Utiliza el orden [ASCENDING_OR_DESCENDING].
44. Planteó una lista de recursos por varias prioridades
Prompt: Productos de Rank que coinciden [KEYWORD] dentro [MARKETPLACE] por unidades mensuales vendidas de la más alta a la más baja, luego por precio nuevo de la más baja a la más alta, entonces por revisión cuenta de la más baja a la más alta. Utilice estas tres prioridades en este orden.
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.
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_product_database_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-product-database-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_product_database_search",
"arguments": {
"domain": "1",
"keyword": "phone case",
"page": 1,
"perPage": 50
}
}
}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 |
|---|---|---|---|
domain | string | obligatorio | dominio de Amazon ID: 1=Estados Unidos, 2=Reino Unido, 3=Alemania, 4=Francia, 5=Japón, 6=Canadá, 8=Italia, 9=España, 10=India, 11=México Ejemplo: 1 |
keyword | string | opcional | Título palabra clave (case-insensible; espacios significan AND tokenization; envolver palabras clave que contienen espacios en citas dobles; prefijo - por exclusión; " símbolo es reemplazado por espacio; hasta 50 palabras clave, máximo 1000 caracteres) Ejemplo: phone case |
rootCategory | array | opcional | Categoría de raíces IDs (hasta 50), sólo incluyen productos en estas categorías de raíces Ejemplo: [] |
rootCategoryNames | array | opcional | Nombres de categoría (hasta 50), utilizados cuando rootCategory está vacío; el sistema busca automáticamente la categoría correspondiente IDs Ejemplo: [] |
categoriesInclude | array | opcional | Subcategoría IDs incluir sólo (hasta 50), sólo incluyen productos directamente enumerados en estas subcategorías Ejemplo: [] |
categoriesIncludeNames | array | opcional | Nombres de subcategoría para incluir (hasta 50), utilizados cuando categoriesInclude está vacío; el sistema busca automáticamente la categoría correspondiente IDs. Apoya los caminos de categoría completa (separados por : o mento) para obtener resultados más precisos Ejemplo: [] |
categoriesExclude | array | opcional | Subcategoría IDs (hasta 50) Ejemplo: [] |
categoriesExcludeNames | array | opcional | Nombres de subcategoría para excluir (hasta 50), utilizados cuando categoriesExclude está vacío; el sistema busca automáticamente la categoría correspondiente IDs. Apoya las trayectorias de categoría completa para obtener resultados más precisos Ejemplo: [] |
currentSalesGte | integer | opcional | Rango de rango de ventas actual (valor más bajo = mejor clasificación) (bajo límite) Ejemplo: 1 |
currentSalesLte | integer | opcional | Rango de rango de ventas actual (valor más bajo = mejor ranking) (por límite superior) Ejemplo: 1 |
avg90SalesGte | integer | opcional | rango promedio de ventas de 90 días (bajo límite) Ejemplo: 1 |
avg90SalesLte | integer | opcional | rango promedio de ventas de 90 días (por límite superior) Ejemplo: 1 |
deltaPercent90SalesGte | integer | opcional | Rango porcentual de cambio de rango de ventas de 90 días (bajo límite) Ejemplo: 1 |
deltaPercent90SalesLte | integer | opcional | rango de porcentaje de cambio de rango de ventas de 90 días (por límite superior) Ejemplo: 1 |
monthlySoldGte | integer | opcional | Unidades vendidas / rango mensual de ventas (bajo límite) Ejemplo: 1 |
monthlySoldLte | integer | opcional | Unidades vendidas / rango de ventas mensuales (encuadernado superior) Ejemplo: 1 |
srAvgGte | integer | opcional | Rango histórico de rango de ventas (integer positivo, valor inferior = mejor clasificación, utilizado para el mes especificado por srAvgMonth. Ejemplo: 1 |
srAvgLte | integer | opcional | Rango histórico de rango de ventas (integer positivo, valor inferior = mejor clasificación, utilizado para el mes especificado por srAvgMonth. Ejemplo: 1 |
srAvgMonth | string | opcional | Clasificación de ventas históricas - mes seleccionado (formato: YYYYMM, e.g., 202511 para noviembre 2025, dentro de los últimos 36 meses) |
currentNewGte | integer | opcional | Nuevo rango actual de precios (en moneda menor) (bajo límite) Ejemplo: 1 |
currentNewLte | integer | opcional | Nuevo rango actual de precios (en moneda menor) (por límite superior) Ejemplo: 1 |
currentBuyBoxShippingGte | integer | opcional | Precio actual de la caja con rango de envío (en unidad de moneda menor) (limitado inferior) Ejemplo: 1 |
currentBuyBoxShippingLte | integer | opcional | Precio actual de la caja con rango de envío (en unidad de moneda menor) (por límite superior) Ejemplo: 1 |
currentCountReviewsGte | integer | opcional | Rango de cuenta de revisión actual (bajo límite) Ejemplo: 1 |
currentCountReviewsLte | integer | opcional | Rango de cuenta de revisión actual (encuadernado superior) Ejemplo: 1 |
currentRatingGte | number | opcional | Rango de calificación actual (0.0-5.0) (bajo límite) Ejemplo: 1 |
currentRatingLte | number | opcional | Rango de calificación actual (0.0-5.0) (encuadernado superior) Ejemplo: 1 |
packageLengthGte | integer | opcional | Rango de longitud del paquete (mm) (limitado inferior) Ejemplo: 1 |
packageLengthLte | integer | opcional | Rango de longitud del paquete (mm) Ejemplo: 1 |
packageWidthGte | integer | opcional | Ancho de paquete (mm) (limitado inferior) Ejemplo: 1 |
packageWidthLte | integer | opcional | Rango de ancho del paquete (mm) Ejemplo: 1 |
packageHeightGte | integer | opcional | Rango de altura del paquete (mm) Ejemplo: 1 |
packageHeightLte | integer | opcional | Rango de altura del paquete (mm) Ejemplo: 1 |
packageWeightGte | integer | opcional | Rango de peso del paquete (gramos) Ejemplo: 1 |
packageWeightLte | integer | opcional | Rango de peso del paquete (gramos) Ejemplo: 1 |
brand | array | opcional | MarcaOR partido) Ejemplo: [] |
color | array | opcional | ColorOR match), productos filtrantes con colores especificados Ejemplo: [] |
size | array | opcional | TamañoOR match), productos filtrantes con tamaños especificados Ejemplo: [] |
availableDateGte | string | opcional | Catálogo del producto rango de tiempo (formato actual: yyyy-MM-dd) Ejemplo: 2026-01-01 |
availableDateLte | string | opcional | Catálogo del producto rango de tiempo (formato actual: yyyy-MM-dd) Ejemplo: 2026-01-01 |
buyBoxIsAmazon | boolean | opcional | Si el vendedor de caja de compra es Amazon Ejemplo: false |
buyBoxIsFBA | boolean | opcional | Si la caja de compra es FBA Ejemplo: false |
isHazMat | boolean | opcional | Si es material peligroso Ejemplo: false |
variationCountGte | integer | opcional | Rango de recuento de variación (bajo límite) Ejemplo: 1 |
variationCountLte | integer | opcional | Rango de conteo de variación (encuadernado superior) Ejemplo: 1 |
currentCountNewGte | integer | opcional | Nuevo rango de conteo de ofertas (bajo límite) Ejemplo: 1 |
currentCountNewLte | integer | opcional | Nueva gama de conteo de ofertas (encuadernado superior) Ejemplo: 1 |
outOfStockPercentage90Gte | integer | opcional | Rango de porcentaje de 90 días fuera de existencia (bajo límite) Ejemplo: 1 |
outOfStockPercentage90Lte | integer | opcional | Rango de porcentaje de 90 días fuera de existencia (por límite superior) Ejemplo: 1 |
singleVariation | boolean | opcional | Regresar sólo una variación; cuando se establece a los productos verdaderos, multivariación sólo devolverá una variación Ejemplo: false |
productType | array | opcional | Filtro tipo producto (por defecto) [0,1,2]): 0=producto estándar, 1=producto descargable, 2=eBook, 5=padre variable ASIN Ejemplo: [
0,
1,
2
] |
history | integer | opcional | Ya sea para incluir datos históricos / ventas históricas en la respuesta (1=incluye, 0=exclude, default 0) Ejemplo: 0 |
rating | integer | opcional | Ya sea para buscar información de calificación (1=fetch, 0=no pare, default 1) Ejemplo: 1 |
page | integer | opcional | Número de página (desde 1 por defecto) Ejemplo: 1 |
perPage | integer | opcional | Resultados máximos por página (min 50, max 100, default 50) Ejemplo: 50 |
sort | array | opcional | Hasta 3 reglas, cada una con fieldName y sortDirection (asc o desc); campos apoyados: availableDate, currentSales, monthlySold, currentRating, currentCountReviews, currentBuyBoxShipping, currentNew Ejemplo: [] |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número total de filas. |
perPage | integer | opcional | Cantidad por página. |
currentPage | integer | opcional | Número de página actual. |
totalCount | integer | opcional | Cantidad total. |
sourceType | string | opcional | Tipo fuente: `kp`. |
type | string | opcional | Rendering estilo. |
columns | array | opcional | Columnas rendidas. |
costToken | integer | opcional | Consume token. |
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. |
manufacturer | string | opcional | fabricante. |
model | string | opcional | modelo. |
price | number | opcional | Precio actual en moneda local. |
primePrice | number | opcional | Prime Price. |
currency | string | opcional | Moneda. |
salesRank | integer | opcional | Clasificación de ventas. |
salesRank30 | integer | opcional | Promedio de ventas en los últimos 30 días. |
salesRank90 | integer | opcional | Promedio de ventas en los últimos 90 días. |
salesRank180 | integer | opcional | El promedio de ventas se sitúa en los últimos 180 días. |
monthlySalesUnits | integer | opcional | Volumen mensual de ventas. |
monthlySalesRevenue | number | opcional | Ventas mensuales. |
rating | number | opcional | Valoración actual (0.0-5.0). |
ratings | integer | opcional | Número de valoraciones. |
reviewCount | integer | opcional | Número de comentarios. |
availableDate | string | opcional | Tiempo de estante (`yyyy-MM-dd HH:mm:ss`). |
lastUpdate | string | opcional | Última actualización (`yyyy-MM-dd HH:mm:ss`). |
imageUrl | string | opcional | Imagen URL (dirección de solicitud). |
productImageUrls | array | opcional | Lista de imágenes de producto. |
asinUrl | string | opcional | Amazon ASIN detalles URL. |
categoryTree | string | opcional | Árbol de categoría. |
categoryTreeId | string | opcional | Categoría árbol ID. |
rootCategory | integer | opcional | Categoría de raíces ID. |
subcategories | array | opcional | Lista de subcategorías, incluida `code` (categoría ID), `rank` (Arrancando), `label` (nombre de la categoría). |
fulfillment | string | opcional | Método de entrega: `AMZ`, `FBA`, `FBM`. |
buyBoxSellerId | string | opcional | Comprar botón vendedor ID. |
sellerNum | integer | opcional | Número de vendedores. |
parentAsin | string | opcional | Parent ASIN. |
variationNum | integer | opcional | Número de variantes. |
color | string | opcional | color. |
dimension | string | opcional | tamaño. |
dimensionsType | string | opcional | Tipo de tamaño. |
material | string | opcional | El material de un producto se refiere a los principales materiales utilizados en su construcción. |
weight | string | opcional | Peso (gramos). |
packageWeight | string | opcional | Peso de embalaje (gramos). |
packageLength | integer | opcional | Longitud del paquete (mm). |
packageWidth | integer | opcional | Ancho del paquete (mm). |
packageHeight | integer | opcional | Altura del paquete (mm). |
packageDimensions | string | opcional | Tamaño de embalaje. |
packageQuantity | integer | opcional | La cantidad del artículo en el paquete, o 0 o -1 si no está disponible. |
itemLength | integer | opcional | Longitud del producto en milímetros, 0 o -1 si no está disponible. |
itemWidth | integer | opcional | Ancho de producto (mm), 0 o -1 si no está disponible. |
itemHeight | integer | opcional | Altura del producto en milímetros, 0 o -1 si no está disponible. |
isAdultProduct | boolean | opcional | Ya sea un producto adulto. |
isHazmat | boolean | opcional | Ya sea mercancías peligrosas. |
referralFeePercentage | number | opcional | Porcentaje de honorarios de referencia. |
fbaFees | number | opcional | FBA tasa de cumplimiento en moneda local. |
profit | number | opcional | margen de ganancia (porcentaje, como 25,5 por 25,5%). |
urlSlug | string | opcional | URL Slug. |
sourceType | string | opcional | Tipo fuente: `kp`. |
code | — | opcional | Categoría ID; el tipo de elemento estará sujeto al archivo fuente o a la documentación oficial aguas arriba. |
rank | — | opcional | Clasificación; tipo de elemento se basará en el archivo fuente o la documentación oficial aguas arriba. |
label | — | opcional | Nombre de la categoría; tipo de elemento estará sujeto al archivo fuente o a la documentación oficial aguas arriba. |
Preguntas y respuestas de ejemplo
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
Tu pregunta
Encontrar productos que coincidan con las “pasas de pies desintoxicados” en Amazon US con al menos 50 ventas mensuales.
Respuesta de ejemplo
La muestra devuelve un producto titulado “13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined”, a un precio de 39.99 con una puntuación de 4.3 y 365 comentarios. Su título no coincide exactamente con las “pantallas de pies desintoxicados”, así que repasa la relevancia antes de tratarlo como un competidor directo.
Sobre esta muestra: Un juego de palabras clave no es prueba de equivalencia de producto. Los precios y los exámenes son valores históricos de muestra; las reclamaciones de salud no son validadas por este resultado.
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
{
"domain": "1",
"keyword": "detox foot pads",
"monthlySoldGte": 50,
"perPage": 50,
"page": 1,
"singleVariation": true,
"sort": [
{
"fieldName": "monthlySold",
"sortDirection": "desc"
}
]
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"perPage": 50,
"sourceType": "keepa",
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "asin",
"sortable": true,
"title": "ASIN"
},
{
"filterable": true,
"cellType": "text",
"field": "parentAsin",
"sortable": true,
"title": "父ASIN"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品标题"
},
{
"filterable": true,
"cellType": "text",
"field": "itemHighlights",
"sortable": true,
"title": "亚马逊商品亮点,标题之外的简短商品信息;不可用时为null,最多125个字符"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "图片URL(完整URL)"
},
{
"filterable": true,
"cellType": "text",
"field": "productImageUrls",
"sortable": true,
"title": "商品图片列表"
},
{
"filterable": true,
"cellType": "text",
"field": "urlSlug",
"sortable": true,
"title": "URL Slug"
},
{
"filterable": true,
"cellType": "text",
"field": "asinUrl",
"sortable": true,
"title": "亚马逊asin的详情网址"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits",
"sortable": true,
"title": "月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesRevenue",
"sortable": true,
"title": "月销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits1MonthAgo",
"sortable": true,
"title": "1月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits2MonthsAgo",
"sortable": true,
"title": "2月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits3MonthsAgo",
"sortable": true,
"title": "3月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits4MonthsAgo",
"sortable": true,
"title": "4月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits5MonthsAgo",
"sortable": true,
"title": "5月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits6MonthsAgo",
"sortable": true,
"title": "6月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits7MonthsAgo",
"sortable": true,
"title": "7月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits8MonthsAgo",
"sortable": true,
"title": "8月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits9MonthsAgo",
"sortable": true,
"title": "9月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits10MonthsAgo",
"sortable": true,
"title": "10月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits11MonthsAgo",
"sortable": true,
"title": "11月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits12MonthsAgo",
"sortable": true,
"title": "12月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank",
"sortable": true,
"title": "销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank30",
"sortable": true,
"title": "近30天平均销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank90",
"sortable": true,
"title": "近90天平均销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank180",
"sortable": true,
"title": "近180天平均销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "当前评分(0"
},
{
"filterable": true,
"cellType": "number",
"field": "ratings",
"sortable": true,
"title": "评分数量"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewCount",
"sortable": true,
"title": "评论数量"
},
{
"filterable": true,
"cellType": "text",
"field": "availableDate",
"sortable": true,
"title": "上架时间(yyyy-MM-dd HH:mm:ss)"
},
{
"filterable": true,
"cellType": "text",
"field": "lastUpdate",
"sortable": true,
"title": "最后更新时间(yyyy-MM-dd HH:mm:ss)"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "当前价格(单位:元,如美元/欧元等)"
},
{
"filterable": true,
"cellType": "number",
"field": "primePrice",
"sortable": true,
"title": "prime价格"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "币种"
},
{
"filterable": true,
"cellType": "number",
"field": "fbaFees",
"sortable": true,
"title": "FBA配送费(单位:元)"
},
{
"filterable": true,
"cellType": "number",
"field": "profit",
"sortable": true,
"title": "利润率(百分比,如25"
},
{
"filterable": true,
"cellType": "text",
"field": "fulfillment",
"sortable": true,
"title": "配送方式(AMZ,FBA,FBM)"
},
{
"filterable": true,
"cellType": "number",
"field": "referralFeePercentage",
"sortable": true,
"title": "推荐费百分比"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "品牌"
},
{
"filterable": true,
"cellType": "text",
"field": "manufacturer",
"sortable": true,
"title": "制造商"
},
{
"filterable": true,
"cellType": "text",
"field": "buyBoxSellerId",
"sortable": true,
"title": "购买按钮卖家ID"
},
{
"filterable": true,
"cellType": "text",
"field": "isHazmat",
"sortable": true,
"title": "是否为危险品"
},
{
"filterable": true,
"cellType": "text",
"field": "isAdultProduct",
"sortable": true,
"title": "是否为成人产品"
},
{
"filterable": true,
"cellType": "number",
"field": "variationNum",
"sortable": true,
"title": "变体数量"
},
{
"filterable": true,
"cellType": "number",
"field": "sellerNum",
"sortable": true,
"title": "卖家数"
},
{
"filterable": true,
"cellType": "number",
"field": "rootCategory",
"sortable": true,
"title": "根类目ID"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryTree",
"sortable": true,
"title": "类目树"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryTreeId",
"sortable": true,
"title": "类目树Id"
},
{
"filterable": true,
"cellType": "number",
"field": "packageHeight",
"sortable": true,
"title": "包装高度(毫米)"
},
{
"filterable": true,
"cellType": "number",
"field": "packageLength",
"sortable": true,
"title": "包装长度(毫米)"
},
{
"filterable": true,
"cellType": "number",
"field": "packageWidth",
"sortable": true,
"title": "包装宽度(毫米)"
},
{
"filterable": true,
"cellType": "text",
"field": "packageDimensions",
"sortable": true,
"title": "包装尺寸"
},
{
"filterable": true,
"cellType": "number",
"field": "packageQuantity",
"sortable": true,
"title": "包装中商品的数量,不可用时为0或-1。示例: 3"
},
{
"filterable": true,
"cellType": "text",
"field": "packageWeight",
"sortable": true,
"title": "包装重量(克)"
},
{
"filterable": true,
"cellType": "text",
"field": "weight",
"sortable": true,
"title": "重量(克)"
},
{
"filterable": true,
"cellType": "text",
"field": "model",
"sortable": true,
"title": "型号"
},
{
"filterable": true,
"cellType": "text",
"field": "color",
"sortable": true,
"title": "颜色"
},
{
"filterable": true,
"cellType": "text",
"field": "material",
"sortable": true,
"title": "产品的材质,指其构造中使用的主要材料"
},
{
"filterable": true,
"cellType": "text",
"field": "dimensionsType",
"sortable": true,
"title": "尺寸类型"
},
{
"filterable": true,
"cellType": "text",
"field": "dimension",
"sortable": true,
"title": "尺寸"
},
{
"filterable": true,
"cellType": "number",
"field": "itemHeight",
"sortable": true,
"title": "商品高度,单位为毫米,不可用时为0或-1。示例: 100"
},
{
"filterable": true,
"cellType": "number",
"field": "itemLength",
"sortable": true,
"title": "商品长度,单位为毫米,不可用时为0或-1。示例: 100"
},
{
"filterable": true,
"cellType": "number",
"field": "itemWidth",
"sortable": true,
"title": "商品宽度,单位为毫米,不可用时为0或-1。示例: 100"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "来源类型:keepa"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
},
{
"filterable": true,
"cellType": "text",
"field": "subcategories",
"sortable": true,
"title": "子类目列表"
}
],
"totalCount": 2,
"currentPage": 1,
"type": "productWorkbenches",
"products": [
{
"variationNum": 0,
"packageWeight": "1102 g",
"itemHeight": 3,
"rating": 4.3,
"packageWidth": 168,
"availableDate": "2024-11-07 19:24:00",
"salesRank180": 41959,
"sourceTool": "keepa",
"reviewCount": 365,
"price": 39.99,
"referralFeePercentage": 11.25,
"buyBoxSellerId": "A13T0W77JZ2MN9",
"itemWidth": 2,
"fbaFees": 6.31,
"brand": "YHOVID",
"isAdultProduct": false,
"salesRank30": 58369,
"itemLength": 3,
"packageHeight": 138,
"packageDimensions": "231 x 168 x 138 mm",
"monthlySalesRevenue": 11997,
"sourceType": "keepa",
"categoryTreeId": "3760901:3764441:3774931:3775151:6939041011",
"lastUpdate": "2026-10-13 18:24:00",
"subcategories": [
{
"code": "6939041011",
"rank": 310,
"label": "Detox & Cleanse"
},
{
"code": "3760901",
"rank": 58650,
"label": "Health & Household"
}
],
"sellerNum": 1,
"color": "Light Yellow",
"salesRank90": 50300,
"title": "13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined",
"dimensionsType": "1 Count (Pack of 1) Pack of 130",
"manufacturer": "YHOVID",
"productImageUrls": [
"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"https://m.media-amazon.com/images/I/61UJn0pP8rL.jpg",
"https://m.media-amazon.com/images/I/71+LhTdsOqL.jpg",
"https://m.media-amazon.com/images/I/71ZplK0hX6L.jpg",
"https://m.media-amazon.com/images/I/71CL-RT+0ML.jpg",
"https://m.media-amazon.com/images/I/71B3TYk15TL.jpg",
"https://m.media-amazon.com/images/I/71t5EBZ4YRL.jpg"
],
"ratings": 365,
"imageUrl": "https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"itemHighlights": "for Liver Detox, Stomach, Neck, Knee, Foot & Entire Body, Organic Cotton Reusable Pads Kit for Hot/Cold Compres",
"packageLength": 231,
"currency": "$",
"categoryTree": "Health & Household:Diet & Sports Nutrition:Weight Loss:Supplements:Detox & Cleanse",
"salesRank": 58650,
"profit": 84.22,
"isHazmat": false,
"dimension": "3 x 2 x 3 mm",
"urlSlug": "YHOVID-Organic-Unrefined-Reusable-Compress",
"asinUrl": "https://www.amazon.com/dp/B0DJQ7HF3C",
"material": "Organic Cotton, Polyurethane Laminate",
"asin": "B0DJQ7HF3C",
"fulfillment": "FBA",
"rootCategory": 3760901,
"monthlySalesUnits": 300
}
]
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en 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-product-database-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_product_database_search",
"arguments": {
"domain": "1",
"keyword": "detox foot pads",
"monthlySoldGte": 50,
"perPage": 50,
"page": 1,
"singleVariation": true,
"sort": [
{
"fieldName": "monthlySold",
"sortDirection": "desc"
}
]
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-product-database-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"perPage\":50,\"sourceType\":\"keepa\",\"totalCount\":2,\"currentPage\":1,\"products\":[{\"variationNum\":0,\"packageWeight\":\"1102 g\",\"itemHeight\":3,\"rating\":4.3,\"packageWidth\":168,\"availableDate\":\"2024-11-07 19:24:00\",\"salesRank180\":41959,\"sourceTool\":\"keepa\",\"reviewCount\":365,\"price\":39.99,\"referralFeePercentage\":11.25,\"buyBoxSellerId\":\"A13T0W77JZ2MN9\",\"itemWidth\":2,\"fbaFees\":6.31,\"brand\":\"YHOVID\",\"isAdultProduct\":false,\"salesRank30\":58369,\"itemLength\":3,\"packageHeight\":138,\"packageDimensions\":\"231 x 168 x 138 mm\",\"monthlySalesRevenue\":11997,\"sourceType\":\"keepa\",\"categoryTreeId\":\"3760901:3764441:3774931:3775151:6939041011\",\"lastUpdate\":\"2026-10-13 18:24:00\",\"subcategories\":[{\"code\":\"6939041011\",\"rank\":310,\"label\":\"Detox & Cleanse\"},{\"code\":\"3760901\",\"rank\":58650,\"label\":\"Health & Household\"}],\"sellerNum\":1,\"color\":\"Light Yellow\",\"salesRank90\":50300,\"title\":\"13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined\",\"dimensionsType\":\"1 Count (Pack of 1) Pack of 130\",\"manufacturer\":\"YHOVID\",\"productImageUrls\":[\"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg\",\"https://m.media-amazon.com/images/I/61UJn0pP8rL.jpg\",\"https://m.media-amazon.com/images/I/71+LhTdsOqL.jpg\",\"https://m.media-amazon.com/images/I/71ZplK0hX6L.jpg\",\"https://m.media-amazon.com/images/I/71CL-RT+0ML.jpg\",\"https://m.media-amazon.com/images/I/71B3TYk15TL.jpg\",\"https://m.media-amazon.com/images/I/71t5EBZ4YRL.jpg\"],\"ratings\":365,\"imageUrl\":\"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg\",\"itemHighlights\":\"for Liver Detox, Stomach, Neck, Knee, Foot & Entire Body, Organic Cotton Reusable Pads Kit for Hot/Cold Compres\",\"packageLength\":231,\"currency\":\"$\",\"categoryTree\":\"Health & Household:Diet & Sports Nutrition:Weight Loss:Supplements:Detox & Cleanse\",\"salesRank\":58650,\"profit\":84.22,\"isHazmat\":false,\"dimension\":\"3 x 2 x 3 mm\",\"urlSlug\":\"YHOVID-Organic-Unrefined-Reusable-Compress\",\"asinUrl\":\"https://www.amazon.com/dp/B0DJQ7HF3C\",\"material\":\"Organic Cotton, Polyurethane Laminate\",\"asin\":\"B0DJQ7HF3C\",\"fulfillment\":\"FBA\",\"rootCategory\":3760901,\"monthlySalesUnits\":300}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"perPage": 50,
"sourceType": "keepa",
"totalCount": 2,
"currentPage": 1,
"products": [
{
"variationNum": 0,
"packageWeight": "1102 g",
"itemHeight": 3,
"rating": 4.3,
"packageWidth": 168,
"availableDate": "2024-11-07 19:24:00",
"salesRank180": 41959,
"sourceTool": "keepa",
"reviewCount": 365,
"price": 39.99,
"referralFeePercentage": 11.25,
"buyBoxSellerId": "A13T0W77JZ2MN9",
"itemWidth": 2,
"fbaFees": 6.31,
"brand": "YHOVID",
"isAdultProduct": false,
"salesRank30": 58369,
"itemLength": 3,
"packageHeight": 138,
"packageDimensions": "231 x 168 x 138 mm",
"monthlySalesRevenue": 11997,
"sourceType": "keepa",
"categoryTreeId": "3760901:3764441:3774931:3775151:6939041011",
"lastUpdate": "2026-10-13 18:24:00",
"subcategories": [
{
"code": "6939041011",
"rank": 310,
"label": "Detox & Cleanse"
},
{
"code": "3760901",
"rank": 58650,
"label": "Health & Household"
}
],
"sellerNum": 1,
"color": "Light Yellow",
"salesRank90": 50300,
"title": "13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined",
"dimensionsType": "1 Count (Pack of 1) Pack of 130",
"manufacturer": "YHOVID",
"productImageUrls": [
"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"https://m.media-amazon.com/images/I/61UJn0pP8rL.jpg",
"https://m.media-amazon.com/images/I/71+LhTdsOqL.jpg",
"https://m.media-amazon.com/images/I/71ZplK0hX6L.jpg",
"https://m.media-amazon.com/images/I/71CL-RT+0ML.jpg",
"https://m.media-amazon.com/images/I/71B3TYk15TL.jpg",
"https://m.media-amazon.com/images/I/71t5EBZ4YRL.jpg"
],
"ratings": 365,
"imageUrl": "https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"itemHighlights": "for Liver Detox, Stomach, Neck, Knee, Foot & Entire Body, Organic Cotton Reusable Pads Kit for Hot/Cold Compres",
"packageLength": 231,
"currency": "$",
"categoryTree": "Health & Household:Diet & Sports Nutrition:Weight Loss:Supplements:Detox & Cleanse",
"salesRank": 58650,
"profit": 84.22,
"isHazmat": false,
"dimension": "3 x 2 x 3 mm",
"urlSlug": "YHOVID-Organic-Unrefined-Reusable-Compress",
"asinUrl": "https://www.amazon.com/dp/B0DJQ7HF3C",
"material": "Organic Cotton, Polyurethane Laminate",
"asin": "B0DJQ7HF3C",
"fulfillment": "FBA",
"rootCategory": 3760901,
"monthlySalesUnits": 300
}
]
}
},
"isError": false
}
}