Inteligencia de Amazon SS
API de búsqueda amplia de productos de Amazon MCP
Buscar productos de Amazon por ventas, precio, calificaciones y cumplimiento. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de búsqueda amplia 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 productos de Amazon
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE].
2. Compruebe una instantánea histórica
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Use la instantánea histórica disponible para [YEAR_MONTH]. No solicite un mes futuro o presente observaciones guardadas como datos en vivo.
3. Buscar una frase exacta
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Use frases clave que coincidan.
4. Buscar un partido de palabras clave más amplio
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Usa palabras clave borrosas que coincidan.
5. Buscar un partido de la palabra clave exacta
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Usar la palabra clave exacta que coincida.
6. Buscar productos recientemente listados
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos listados dentro [NUMBER_OF_MONTHS] meses, elegir 1, 3, 6, 12 o 24.
7. Buscar productos por método de cumplimiento
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Uso [FULFILLMENT_METHODS]: Amazon retail, FBA o cumplimiento del vendedor, o una combinación compatible. Dejar el cumplimiento sin restricciones si no se selecciona ningún método.
8. 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 10 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.
9. Excluir palabras clave no deseadas
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Excluir los resultados que contienen [EXCLUDED_WORDS].
10. Buscar en una categoría
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Limita la búsqueda a la categoría de Amazon [CATEGORY_NAME_OR_PATH].
11. Encontrar productos por ubicación del vendedor
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos cuyos vendedores están dentro [SELLER_LOCATIONS].
12. Incluir vendedores seleccionados
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los resultados de los vendedores [SELLERS_TO_INCLUDE].
13. Excluir a los vendedores seleccionados
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Exclusión de los vendedores [SELLERS_TO_EXCLUDE].
14. Incluye marcas seleccionadas
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener resultados de las marcas [BRANDS_TO_INCLUDE].
15. Excluir las marcas seleccionadas
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Excluir las marcas [BRANDS_TO_EXCLUDE].
16. Buscar productos por precio
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con precio entre [LOWER_LIMIT] y [UPPER_LIMIT].
17. Buscar productos por margen bruto
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con margen bruto entre [LOWER_LIMIT] y [UPPER_LIMIT] por ciento.
18. Buscar productos por ingresos mensuales de ventas
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con ingresos mensuales de ventas entre [LOWER_LIMIT] y [UPPER_LIMIT].
19. Buscar productos por FBA Gastos de envío
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con FBA Gastos de envío entre [LOWER_LIMIT] y [UPPER_LIMIT].
20. Buscar productos por volumen de ventas mensuales
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con volumen de ventas mensuales entre [LOWER_LIMIT] y [UPPER_LIMIT].
21. Buscar productos por variante último volumen de ventas de 30 días
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con el volumen de ventas de 30 días de variante entre [LOWER_LIMIT] y [UPPER_LIMIT]. Usa la última instantánea de 30 días.
22. Buscar productos por tasa de crecimiento del volumen de ventas mensual
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con tasa de crecimiento del volumen de ventas mensual entre [LOWER_LIMIT] y [UPPER_LIMIT] por ciento.
23. Buscar productos por categoría principal BSR rango
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con categoría principal BSR rango entre [LOWER_LIMIT] y [UPPER_LIMIT].
24. Buscar productos por BSR Tasa de crecimiento
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con BSR tasa de crecimiento entre [LOWER_LIMIT] y [UPPER_LIMIT] por ciento.
25. Buscar productos por BSR conteo de crecimiento
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con BSR crecimiento [LOWER_LIMIT] y [UPPER_LIMIT].
26. Buscar productos por subcategoría BSR rango
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con subcategoría BSR rango entre [LOWER_LIMIT] y [UPPER_LIMIT]. Categoría de uso [CATEGORY_PATH] y permitir el filtrado de subcategorías.
27. Buscar productos por valor de calificación
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con valor de calificación entre [LOWER_LIMIT] y [UPPER_LIMIT].
28. Buscar productos por cuenta de revisión
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener los productos con cuenta de revisión entre [LOWER_LIMIT] y [UPPER_LIMIT].
29. Buscar productos por cuenta de nueva revisión mensual
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con recuento mensual de nueva revisión entre [LOWER_LIMIT] y [UPPER_LIMIT].
30. Encontrar productos por lista puntuación de la calidad de página
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantenga los productos con la lista de la puntuación de la calidad de página entre [LOWER_LIMIT] y [UPPER_LIMIT].
31. Encontrar productos por número de variaciones
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con número de variaciones entre [LOWER_LIMIT] y [UPPER_LIMIT].
32. Buscar productos por peso
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con peso entre [LOWER_LIMIT] y [UPPER_LIMIT]. Uso [WEIGHT_UNIT], eligiendo gramos, kilogramos, onzas o libras.
33. Encontrar productos por número de vendedores
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos con número de vendedores entre [LOWER_LIMIT] y [UPPER_LIMIT].
34. Comprueba listed or delisted products
Prompt: Buscar productos para [KEYWORD] dentro [MARKETPLACE]. [INCLUDE_OR_HIDE] productos excluidos en los resultados.
35. Investigación de una categoría y sus subcategorías
Prompt: Encontrar [KEYWORD] en la categoría [CATEGORY_PATH] dentro [MARKETPLACE]. [ENABLE_OR_DISABLE] Filtro subcategoría.
36. Filtro por la insignia del mejor vendedor
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos [WITH_OR_WITHOUT] la insignia del Mejor Vendedor, o dejar la insignia sin restricciones.
37. Filtro por la placa de selección de Amazon
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos [WITH_OR_WITHOUT] la placa de selección de Amazon, o dejar el estado de insignia sin restricciones.
38. Filtro por la placa de Nuevo lanzamiento
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Mantener productos [WITH_OR_WITHOUT] la insignia de New Release, o dejar el estado de insignia sin restricciones.
39. Investigación de productos y variaciones de los padres
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Use el [PARENT_PRODUCT_OR_VARIANT] vista para los resultados.
40. 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 ventas mensuales, crecimiento de ventas mensuales o ventas de variantes. Utiliza el orden [ASCENDING_OR_DESCENDING].
41. 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 ingresos mensuales, precio o margen de ganancia bruto. Utiliza el orden [ASCENDING_OR_DESCENDING].
42. Priorizar los resultados por visibilidad de la búsqueda
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Establece [RANKING_PRIORITY] como criterio principal y elige de la categoría principal BSR rango. Utiliza el orden [ASCENDING_OR_DESCENDING].
43. 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 de calificación, cuenta de revisión, tasa de revisión o cuenta de revisión mensual. Utiliza el orden [ASCENDING_OR_DESCENDING].
44. 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].
45. Priorizar los resultados por orden predeterminado
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Utilice el orden de resultado predeterminado de la fuente.
46. Utilice la última instantánea disponible
Prompt: Buscar productos de Amazon que coincidan [KEYWORD] dentro [MARKETPLACE]. Utilice la última instantánea disponible en lugar de un mes histórico. Mantenga el período de observación devuelto explícito.
47. Encontrar una lista de productos manejable
Prompt: Encontrar [KEYWORD] productos en España [MARKETPLACE] precio entre [MIN_PRICE] y [MAX_PRICE], con ventas mensuales entre [MIN_SALES] y [MAX_SALES] y repaso cuenta entre [MIN_REVIEWS] y [MAX_REVIEWS]. Regrese los primeros 20 partidos para su revisión.
48. Tamaños del paquete de filtro en US
Prompt: Encontrar [keyword] productos en los US con [one selected package-size class: small standard, large standard, small oversize, medium oversize, large oversize, special oversize, other, extra-large up to 50 lb, extra-large above 50 through 70 lb, extra-large above 70 through 150 lb, extra-large over 150 lb]. Aplicar la clasificación de paquetes para ese mercado y preservar sus pruebas de tamaño devuelto.
49. Tamaños del paquete de filtro en JP
Prompt: Encontrar [keyword] productos en Japón con [one selected package-size class: small, standard, oversize, extra-large, other]. Aplicar la clasificación de paquetes para ese mercado y preservar sus pruebas de tamaño devuelto.
50. Tamaños del paquete de filtro en CA
Prompt: Encontrar [keyword] productos en Canadá con [one selected package-size class: envelope, standard, small oversize, medium oversize, large oversize, special oversize, other]. Aplicar la clasificación de paquetes para ese mercado y preservar sus pruebas de tamaño devuelto.
51. Tamaños del paquete de filtro en UK/FR/DE/IT/ES
Prompt: Encontrar [keyword] productos en España [the UK, France, Germany, Italy or Spain] con [one selected package-size class: small envelope, standard envelope, large envelope, extra-large envelope, small parcel, standard parcel, small oversize, standard oversize, large oversize, special oversize, other]. Aplicar la clasificación de paquetes para ese mercado y preservar sus pruebas de tamaño devuelto.
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_broad_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-broad-product-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_broad_product_search",
"arguments": {
"keyword": "phone case",
"marketplace": "US",
"matchType": 1,
"page": 1,
"size": 20
}
}
}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 |
|---|---|---|---|
chatId | string | opcional | Chat ID, maxLength 1000 Ejemplo: example-id |
uid | string | opcional | Usuario ID, maxLength 1000 Ejemplo: example-id |
requestId | string | opcional | Empuja ID, maxLength 1000 Ejemplo: example-id |
teamId | string | opcional | Equipo ID, maxLength 1000 Ejemplo: example-id |
keyword | string | opcional | Palabras clave de búsqueda; traducir al idioma correspondiente del país siempre que sea posible, e.g. utilizar palabras clave en inglés para US, palabras clave alemanas para Alemania, etc. maxLength 10240 Ejemplo: phone case |
matchType | integer | opcional | Tipo de partido: 1 = partido de frase (por defecto), 2 = partido borroso, 3 = partido exacto Ejemplo: 1 |
excludeKeywords | string | opcional | Excluir las palabras clave; maxLength 10240 Ejemplo: phone case |
marketplace | string | opcional | Código del sitio del mercado, por defecto USSólo US, UK, DE, FR, JP, CA, IT, ES, MX, IN están permitidos (debe coincidir con este enum; AU, TR, y otros sitios sin lista no son compatibles) Ejemplo: US |
nodeLabel | string | opcional | Nombre de la categoría Amazon; maxLength 1000 |
nodeIdPath | string | opcional | Nodo de categoría Amazon ID; maxLength 1000 |
filterSubNode | boolean | opcional | Ya sea para filtrar los nodos subcategoría; sólo eficaz cuando nodeLabel o nodeIdPath tiene un valor; pase JSON boolean true / false Ejemplo: false |
dataSnapshotMonth | string | opcional | Datos del producto snapshot mes, formato yyyyMM (e.g. 202412 para la instantánea de datos 2024 diciembre), o casi durante los últimos 30 días datos en tiempo real. Por defecto: casi. Utilizado para el análisis histórico y la comparación de periodos; solo soporta las instantáneas históricas existentes, no se admiten las fechas futuras; maxLength 1000 |
minPrice | number | opcional | Precio mínimo (= 0) Ejemplo: 1 |
maxPrice | number | opcional | Precio máximo (= 0) Ejemplo: 1 |
minProfit | number | opcional | márgen bruto mínimo, porcentaje unitario (1-100) Ejemplo: 1 |
maxProfit | number | opcional | Máximo margen bruto, porcentaje unitario (1-100) Ejemplo: 1 |
minRevenue | number | opcional | Ingresos mensuales mínimos de ventas (con = 0) Ejemplo: 1 |
maxRevenue | number | opcional | Ingresos máximos de ventas mensuales (= 0) Ejemplo: 1 |
minFba | number | opcional | Mínimo FBA Gastos de envío (consign= 0) Ejemplo: 1 |
maxFba | number | opcional | Máximo FBA Gastos de envío (consign= 0) Ejemplo: 1 |
minUnits | integer | opcional | Volumen mínimo de ventas mensuales (= 0) Ejemplo: 1 |
maxUnits | integer | opcional | Volumen máximo de ventas mensuales (= 0) Ejemplo: 1 |
minAmzUnit | integer | opcional | Volumen de ventas mínimo de 30 días (sólo apoyado cuando dataSnapshotMonth es una "último 30 días" tipo de consulta); mínimo 0 Ejemplo: 1 |
maxAmzUnit | integer | opcional | Máxima variante del volumen de ventas de 30 días (sólo soportado para las consultas de los últimos 30 días); mínimo 0 Ejemplo: 1 |
minUnitsGrowthRate | number | opcional | Tasa mínima de crecimiento del volumen de ventas mensuales, porcentaje Ejemplo: 1 |
maxUnitsGrowthRate | number | opcional | Tasa máxima de crecimiento del volumen de ventas mensuales, unidad % Ejemplo: 1 |
minBsr | integer | opcional | Categoría principal más baja BSR rango Ejemplo: 1 |
maxBsr | integer | opcional | Categoría principal más alta BSR rango Ejemplo: 1 |
minBsrGrowthRate | number | opcional | Mínimo BSR tasa de crecimiento, porcentaje unitario Ejemplo: 1 |
maxBsrGrowthRate | number | opcional | Máximo BSR tasa de crecimiento, porcentaje unitario Ejemplo: 1 |
minBsrGrowthCount | integer | opcional | Mínimo BSR conteo de crecimiento Ejemplo: 1 |
maxBsrGrowthCount | integer | opcional | Categoría principal máxima BSR conteo de crecimiento Ejemplo: 1 |
minSubNodeBsrRank | integer | opcional | Subcategoría más baja BSR rango (requiere filterSubNode = verdadero) Ejemplo: 1 |
maxSubNodeBsrRank | integer | opcional | Subcategoría más alta BSR rango (requiere filterSubNode = verdadero) Ejemplo: 1 |
minRating | number | opcional | Valor mínimo (0-5) Ejemplo: 1 |
maxRating | number | opcional | Valor máximo de calificación (0-5), 3.8-4.3 es el rango de oportunidad de mejora del producto Ejemplo: 1 |
minRatings | integer | opcional | Cuenta de revisión mínima (0-10000) Ejemplo: 1 |
maxRatings | integer | opcional | Cuenta de revisión máxima (0-10000) Ejemplo: 1 |
minRatingsGrowthCount | integer | opcional | Cuenta de nueva revisión mensual mínima (= 0) Ejemplo: 1 |
maxRatingsGrowthCount | integer | opcional | Máximo recuento mensual de nueva revisión ( > 0) Ejemplo: 1 |
minListingQualityScore | number | opcional | Puntuación de la calidad de la página de Listado Mínimo (= 0) Ejemplo: 1 |
maxListingQualityScore | number | opcional | Máxima puntuación de la calidad de la página de Listado (= 0) Ejemplo: 1 |
minVariations | integer | opcional | Número mínimo de variaciones Ejemplo: 1 |
maxVariations | integer | opcional | Número máximo de variaciones Ejemplo: 1 |
minWeights | number | opcional | Peso mínimo (= 0) Ejemplo: 1 |
maxWeights | number | opcional | Peso máximo (= 0) Ejemplo: 1 |
weightUnit | string | opcional | Unidad de peso: g, kg, oz, lb. Este campo debe especificarse si los parámetros incluyen filtro de peso |
dimensionType | string | opcional | Tipo de dimensión del paquete (los códigos varían por sitio, véase abajo) |
minSellers | integer | opcional | Número mínimo de vendedores Ejemplo: 1 |
maxSellers | integer | opcional | Número máximo de vendedores Ejemplo: 1 |
badgeBestSeller | string | opcional | Filtro de insignia del mejor vendedor: Y, N, o vacío (todas) |
badgeAmazonsChoice | string | opcional | Filtro de placa de selección de Amazon: Y, N, o vacío (todas) |
badgeNewRelease | string | opcional | Nuevo filtro de placa de liberación: Y, N, o vacío (todas) |
fulfillment | string | opcional | Método de Fulfillment: simple select AMZ / FBA / FBM, o multi-seleccion como AMZ,FBA, FBA,FBM, AMZ,FBA,FBM, etc.; múltiples condiciones utilizan la separación de coma; vacío significa no límite |
showVariation | string | opcional | Ya sea para las variantes de consulta: Y o N, por defecto N |
hideUnlistedProduct | boolean | opcional | Ya sea para ocultar productos delistados, por defecto verdadero Ejemplo: false |
listedWithinLastMonths | integer | opcional | Tiempo desde el listado (meses), sólo se permite: 1, 3, 6, 12, 24 (debe coincidir estos valores enum; no pasar otros enteros) Ejemplo: 1 |
sellerNation | string | opcional | Código de ubicación del vendedore.g. US, CN, HK), múltiples condiciones separadas por coma, por defecto sin límite |
includeSellers | string | opcional | Incluir a los vendedores; maxLength 10240 |
excludeSellers | string | opcional | Excluir a los vendedores; maxLength 10240 |
includeBrands | string | opcional | Incluye marcas; maxLength 10240 |
excludeBrands | string | opcional | Excluir las marcas; maxLength 10240 |
order | object | opcional | Ordenar configuración; si se aprueba, se recomienda proporcionar campo y desc (ambos se requieren en el sub-schema) Ejemplo: {} |
order.field | string | opcional | Campo tipo: total_units ( ventas mensuales), total_amount (ingresos mensuales) bsr_rank, precio, puntuación, comentarios, rentabilidad, reviews_rate, available_date, preguntas, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit (varios ventas). Default total_units. Pase una cadena vacía "" para no clasificar por los campos de negocio anteriores (las consultas completas tipo semántica son manejadas por el servidor) |
order.desc | string | opcional | "verdad" descendiendo, subiendo "falso"; "verdad" predeterminado; maxLength 1000 |
page | integer | opcional | Número de página, a partir de 1, predeterminado 1 Ejemplo: 1 |
size | integer | opcional | Resultados por página (10-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 |
|---|---|---|---|
total | integer | opcional | Número total de productos iguales |
products | array | opcional | Lista de productos |
columns | array | opcional | Definiciones de columna rendidas |
keyword | string | opcional | Palabras clave de búsqueda utilizadas (si hay) |
nodeIdPath | string | opcional | Búsqueda categoría nodo |
nodeLabel | string | opcional | Nombre de la categoría Amazon |
dataSnapshotMonth | string | opcional | Mes de consulta de datos |
sourceType | string | opcional | Tipo de fuente, como `amazon` |
type | string | opcional | estilo de renderización |
message | string | opcional | Mensaje adicional o mensaje de error |
costToken | integer | opcional | Consume token |
asin | string | opcional | Amazon ASIN |
title | string | opcional | Título del producto |
asinUrl | string | opcional | Página de detalles de productos Amazon URL |
imageUrl | string | opcional | Imagen del producto URL |
price | number | opcional | precio actual |
averagePrice | number | opcional | precio promedio |
primePrice | number | opcional | Precio inicial -1 significa ninguno |
currency | string | opcional | Moneda |
monthlySalesUnits | integer | opcional | ventas mensuales |
monthlySalesRevenue | number | opcional | ventas mensuales |
monthlySalesUnitsGrowthRate | number | opcional | Tasa mensual de crecimiento de las ventas |
bsr | integer | opcional | BSR Ranking |
bsrGrowthRate | number | opcional | BSR Tasa de crecimiento |
rating | number | opcional | Valoración |
ratings | integer | opcional | Número de valoración |
ratingsRate | number | opcional | Tasa de examen |
profit | number | opcional | Tasa bruta de lucro (%) |
fba | number | opcional | FBA envío |
sellerNum | integer | opcional | Número de vendedores |
sellerId | string | opcional | BuyBox vendedor ID |
sellerName | string | opcional | BuyBox Nombre del vendedor |
sellerNation | string | opcional | BuyBox nacionalidad vendedor |
brand | string | opcional | marca |
brandUrl | string | opcional | Página URL |
fulfillment | string | opcional | Método de envío (AMZ/FBA/FBM) |
availableDate | string | opcional | Hora de lanzamiento (timestamp) |
availableDateString | string | opcional | Fecha de lanzamiento (cadena formateada) |
variationNum | integer | opcional | Número de variantes |
variant30DayUnits | integer | opcional | Volumen mensual de ventas de cuerpos hija (número de piezas) |
variant30DayRevenue | number | opcional | Ventas mensuales subsidiarias |
variant30DayUpdatedAt | string | opcional | Tiempo de actualización de datos del subcuente |
weight | string | opcional | peso |
packageWeight | string | opcional | Peso de embalaje |
dimension | string | opcional | Tamaño |
packageDimensions | string | opcional | Tamaño del embalaje |
dimensionsType | string | opcional | tamaño |
packageDimensionType | string | opcional | Tipo de tamaño de embalaje |
listingQualityScore | number | opcional | Lista de puntuación de calidad |
deliveryPrice | number | opcional | tarifa de envío del vendedor, -1 significa ninguno |
nodeLabelPath | string | opcional | Categoría |
nodeIdPath | string | opcional | Node ID sendero |
nodeId | integer | opcional | Node ID |
dataSnapshotMonth | string | opcional | Mes de consulta de datos |
badgeBestSeller | string | opcional | Logo Best VendedorY/N) |
badgeAmazonChoice | string | opcional | Logo Amazon's ChoiceY/N) |
badgeNewRelease | string | opcional | Nuevo logo de lanzamientoY/N) |
badgeVideo | string | opcional | Logotipo de presentación de vídeoY/N) |
badgeEbc | string | opcional | Identificación de página A+Y/N) |
badge | object | opcional | Objeto sumario de identidad, incluido `bestSeller`, `amazonChoice`, `newRelease`, `video`, `ebc` |
subcategories | array | opcional | Lista de subcategorías, cada una conteniendo `code`, `rank`, `label` |
sku | string | opcional | SKU |
keyword | string | opcional | Palabras clave correspondientes al filtrado |
sourceType | string | opcional | Tipo de fuente |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Encontrar casos de teléfono en Amazon US y mostrar la primera página de resultados.
Explicación ilustrativa de la respuesta
El resultado ilustrativo contiene “Example phone case”, precio a USD 19.99, con 300 unidades de ventas mensuales y una puntuación de 4.5. Estas cifras muestran cómo comparar los productos devueltos.
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-broad-product-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_broad_product_search",
"arguments": {
"keyword": "phone case",
"marketplace": "US",
"matchType": 1,
"page": 1,
"size": 20
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-broad-product-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"products\":[{\"asin\":\"B000000001\",\"title\":\"Example phone case\",\"price\":19.99,\"currency\":\"USD\",\"monthlySalesUnits\":300,\"rating\":4.5}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"products": [
{
"asin": "B000000001",
"title": "Example phone case",
"price": 19.99,
"currency": "USD",
"monthlySalesUnits": 300,
"rating": 4.5
}
]
}
},
"isError": false
}
}