Datos públicos del mercado de Amazon
API de búsqueda con Alexa de Amazon MCP
Pregunte a Amazon storefront Alexa para orientación comercial, grupos de productos recomendados, ASIN listas y preguntas de seguimiento. Disponible REST API o MCP.
Prompts y casos de uso de API de búsqueda con Alexa 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. Solicitar a Amazon recomendaciones de productos
Prompt: Hacer Amazon Alexa esta pregunta de compra: [SHOPPING_QUESTION]. Dame un informe legible de la respuesta y cualquier producto recomendado.
2. Preguntar sobre una página de producto
Prompt: Hacer Amazon Alexa esta pregunta de compra: [SHOPPING_QUESTION]. Resumir la respuesta y cualquier producto recomendado. Utilice el producto específico, búsqueda o página de categoría [PAGE_URL] como contexto; no utilice la página principal de Amazon.
3. Obtenga una respuesta comercial estructurada
Prompt: Hacer Amazon Alexa esta pregunta de compra: [SHOPPING_QUESTION]. Resumir la respuesta y cualquier producto recomendado. Devuelve la respuesta como estructurada JSON así puedo procesar las recomendaciones.
4. Hacer una pregunta de seguimiento
Prompt: Resume los detalles pertinentes de [PREVIOUS_ANSWER] y combínalos con [FOLLOW_UP_QUESTION] en una nueva pregunta para Amazon Alexa. Cada solicitud es una sesión separada, por lo que incluye el contexto en lugar de asumir que es recordado.
Qué debes proporcionar
Proporcionar una pregunta de compra y, si es relevante, un producto específico, búsqueda o página de categoría. Incluya la respuesta anterior pertinente al hacer una pregunta de seguimiento.
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_alexa_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-alexa-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_alexa_search",
"arguments": {
"format": "markdown",
"prompts": [
"What are good phone cases for iPhone?"
]
}
}
}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 |
|---|---|---|---|
prompts | array | obligatorio | Conversation prompt array, soporta sólo 1 entrada. Cada llamada acepta sólo 1 pregunta. Para las preguntas de seguimiento, el agente debe resumir información clave de la respuesta anterior (productos recomendados, ASINs, conclusiones clave, etc.), concatenarlo con la nueva pregunta, y enviarlo como un nuevo impulso[0]. Cada llamada es una nueva sesión independiente y no conserva la historia de la conversación cruzada Ejemplo: [
"What are good phone cases for iPhone?"
] |
format | string | opcional | Formato de respuesta: Markdown (default) devuelve un informe legible; json devuelve un array de datos estructurado |
url | string | opcional | Página vinculada URL, utilizado para complementar el contexto de página de la respuesta actual de Alexa. Sólo pasa esto cuando el usuario proporciona una página específica (página de inicio / página de resultados de búsqueda / página de detalles del producto, etc.); no pase este parámetro para la página principal de Amazon (e.g. https://www.amazon.com/) Ejemplo: https://example.com/image.jpg |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
stdout | string | opcional | Informe del formato de marcado Q. `format=markdown` se utiliza. |
data | array | opcional | Array of structured conversation results, returned only if `format=json`. |
resultsNum | integer | opcional | El número de conversaciones convierte a Alexa en realidad contestado; 0 significa que no se produjo ninguna respuesta válida. |
code | string | opcional | Código de estado comercial, exitoso `"200"`, igual que la versión numérica `errcode`. |
errcode | integer | opcional | Código de estado comercial, `200` indica éxito. |
costTime | integer | opcional | La interfaz lleva tiempo en milisegundos. |
costToken | integer | opcional | El número de Tokens consumidos por esta llamada; facturado sólo si la corriente ascendente es exitosa. |
taskId | string | opcional | La tarea ID devuelto por el río arriba. |
type | string | opcional | Estilo reductor: `stdoutWorkbenches` (Mercado) o `json`. |
prompt | string | opcional | La palabra rápida enviada a Alexa para la ronda actual. |
content | string | opcional | El contenido de texto de la respuesta de Alexa esta ronda. |
screenshot | string | opcional | Enlace a la captura de esta conversación. |
followUpQuestions | string[] | opcional | Alexa recomienda una lista de preguntas de seguimiento. |
products | array | opcional | Lista recomendada de grupos de productos, cada grupo contiene `title` y `items`. |
products[].title | string | opcional | Títulos recomendados de grupo. |
products[].items[].asin | string | opcional | Producto ASIN. |
products[].items[].title | string | opcional | Título del producto. |
products[].items[].url | string | opcional | Página de detalles del producto URL. |
products[].items[].cover | string | opcional | Imagen de la cubierta del producto URL. |
products[].items[].price | string | opcional | Precio actual, con moneda. |
products[].items[].originalPrice | string | opcional | Precio original o precio de huelga. |
products[].items[].score | string | opcional | Evaluaciones de productos. |
products[].items[].ratingsCount | string | opcional | Número de comentarios. |
products[].items[].describe | string | opcional | Introducción de productos. |
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
Recomendar un producto de cocina barato.
Respuesta de ejemplo
En la muestra publicada, Alexa recomienda OXO Buenas Grips Balloon Whisk, ASIN B00004OCNS. La respuesta describe un batido a prueba de lavavajillas con un mango antideslizante e informa un precio de $13.95 y una puntuación de 4.8 estrellas.
Sobre esta muestra: Estas son recomendaciones de muestra, precios y calificaciones, no un precio actual o un cheque de disponibilidad.
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
{
"prompts": [
"Recommend one inexpensive kitchen product."
],
"format": "json"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"screenshot": "https://image-alexa.datasea.network/screenshots/1793163726656-81dd8dab18c0fd9f-0.png",
"prompt": "Recommend one inexpensive kitchen product.",
"content": "Here's a great pick that's endlessly useful in the kitchen:\n\nAt just $13.95, it's one of those tools you'll reach for constantly. Want more affordable kitchen suggestions or anything specific?",
"products": [
{
"items": [
{
"cover": "https://m.media-amazon.com/images/I/61BRW8baOPL._AC_.jpg",
"score": "4.8",
"ratingsCount": "23,662",
"asin": "B00004OCNS",
"describe": "The OXO Good Grips Balloon Whisk is a beloved kitchen staple — perfect for eggs, sauces, and baking. The non-slip handle makes it comfortable to use, and it's dishwasher safe for easy cleanup. Rated 4.8 stars from over 23,000 reviews.",
"url": "https://www.amazon.com/dp/B00004OCNS?niid=nl_cl_lst_a_1_0&ref_=nl_cl_lst_a_1_0&nrid=1JFA4QJD11Z8P2FKJ3NM"
}
]
}
]
}
],
"costTime": 28567,
"resultsNum": 1,
"type": "json",
"taskId": "1793163726656-81dd8dab18c0fd9f"
}
}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-alexa-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_alexa_search",
"arguments": {
"prompts": [
"Recommend one inexpensive kitchen product."
],
"format": "json"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-alexa-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"screenshot\":\"https://image-alexa.datasea.network/screenshots/1793163726656-81dd8dab18c0fd9f-0.png\",\"prompt\":\"Recommend one inexpensive kitchen product.\",\"content\":\"Here's a great pick that's endlessly useful in the kitchen:\\n\\nAt just $13.95, it's one of those tools you'll reach for constantly. Want more affordable kitchen suggestions or anything specific?\",\"products\":[{\"items\":[{\"cover\":\"https://m.media-amazon.com/images/I/61BRW8baOPL._AC_.jpg\",\"score\":\"4.8\",\"ratingsCount\":\"23,662\",\"asin\":\"B00004OCNS\",\"describe\":\"The OXO Good Grips Balloon Whisk is a beloved kitchen staple — perfect for eggs, sauces, and baking. The non-slip handle makes it comfortable to use, and it's dishwasher safe for easy cleanup. Rated 4.8 stars from over 23,000 reviews.\",\"url\":\"https://www.amazon.com/dp/B00004OCNS?niid=nl_cl_lst_a_1_0&ref_=nl_cl_lst_a_1_0&nrid=1JFA4QJD11Z8P2FKJ3NM\"}]}]}],\"resultsNum\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"screenshot": "https://image-alexa.datasea.network/screenshots/1793163726656-81dd8dab18c0fd9f-0.png",
"prompt": "Recommend one inexpensive kitchen product.",
"content": "Here's a great pick that's endlessly useful in the kitchen:\n\nAt just $13.95, it's one of those tools you'll reach for constantly. Want more affordable kitchen suggestions or anything specific?",
"products": [
{
"items": [
{
"cover": "https://m.media-amazon.com/images/I/61BRW8baOPL._AC_.jpg",
"score": "4.8",
"ratingsCount": "23,662",
"asin": "B00004OCNS",
"describe": "The OXO Good Grips Balloon Whisk is a beloved kitchen staple — perfect for eggs, sauces, and baking. The non-slip handle makes it comfortable to use, and it's dishwasher safe for easy cleanup. Rated 4.8 stars from over 23,000 reviews.",
"url": "https://www.amazon.com/dp/B00004OCNS?niid=nl_cl_lst_a_1_0&ref_=nl_cl_lst_a_1_0&nrid=1JFA4QJD11Z8P2FKJ3NM"
}
]
}
]
}
],
"resultsNum": 1
}
},
"isError": false
}
}