Búsqueda por palabra clave de Amazon
Indique una URL de resultados de Amazon fuera de Japón y una cantidad esperada para obtener títulos, precios, valoraciones, entrega y datos del listado.
Traducido · es-ESVer texto original
Descripción general
Los compradores deciden con las tarjetas de búsqueda de Amazon antes de abrir la ficha del producto: título, precio visible, valoración, promesa de entrega y si la tarjeta está marcada como anuncio. Esta app convierte un enlace de resultados de Amazon fuera de Japón en una tabla estructurada de esas tarjetas públicas para que el surtido, los precios y la visibilidad partan de la misma vista de búsqueda que ve el cliente.
El conjunto conserva la palabra clave, el código de sitio y el enlace de búsqueda junto a cada producto, de modo que las comparaciones posteriores sigan ligadas a esa consulta. Es un libro de trabajo de resultados de búsqueda, no un sustituto de la ficha de detalle.
Notas sobre los datos
Cada fila es una tarjeta de producto de una página pública de resultados de Amazon fuera de Japón. Las filas se ordenan por hora de captura de más temprana a más tardía, y el mismo ID de producto se conserva una vez. Precio actual y Precio original son los textos de la tarjeta, con el símbolo de moneda mostrado; no son importes normalizados y pueden diferir del precio de ficha, impuestos o cupones. Entrega, Envío gratis, Precio de envío e Info de stock son la instantánea de la tarjeta en el momento de la captura. Capturado el se devuelve sin zona horaria. Palabra clave, ID de negocio, ID de elemento y Elemento de origen repiten el contexto de la búsqueda. El estado del anuncio es el texto de origen, aunque no esté en español.
No cubre el marketplace de Japón, fichas de detalle, variantes, reseñas, pedidos, trastienda del vendedor ni tarjetas que no sean visibles en la búsqueda pública. El marcador Sin datos distingue un elemento de búsqueda sin tarjetas de las filas de producto normales.
Ejemplo de resultado
Cada fila es una tarjeta de producto de los resultados de búsqueda.
| ID de producto | Título del producto | Precio actual | Valoración | Palabra clave | Etiqueta de anuncio |
|---|---|---|---|---|---|
| B0HG365ZZV-US | HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD | $899.99 | 4.8 | laptop | No |
| B0H72JH23T-US | HP 14 inch Laptop, 4GB DDR5 RAM, 128GB SSD, Intel N150 Processor | $299.99 | 5.0 | laptop | No |
Precio original, Entrega, Número de valoraciones, Código de sitio e Info de stock también están disponibles cuando la tarjeta los muestra.
Casos de uso
- Para revisar surtido, agrupe filas por Palabra clave y Código de sitio y examine Título del producto e ID de producto para ver qué productos ocupan los primeros resultados.
- Para comparar precios de lista, cruce Precio actual, Precio original y Valoración y separe promociones de precios completos.
- Para visibilidad, filtre Etiqueta de anuncio y lea Título del producto con Entrega para separar tarjetas patrocinadas y orgánicas.
- Para disponibilidad, lea juntas Info de stock, Compras recientes y Envío gratis para detectar escasez u ofertas de envío.
Alcance y límites
Una URL de resultados de Amazon fuera de Japón por tarea, con una cantidad esperada de 1 a 10000; los resultados se devuelven en lotes completos de 20 y pueden redondearse al alza; amazon.co.jp no es compatible; solo listados públicos de búsqueda.
- Adecuada para
- Cuando necesite tarjetas de producto de una página de resultados de Amazon fuera de Japón.
- Cuando quiera comparar precios de lista, valoraciones, promesas de entrega y anuncios de una consulta.
- No usar para
- Cuando necesite la ficha completa, variantes, reseñas o historial de precios: esta App solo devuelve información de la tarjeta de resultados.
- Cuando necesite datos de Japón, pedidos o trastienda del vendedor: esta App solo cubre listados públicos de búsqueda fuera de Japón.
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el autor. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1Si no se devuelven tarjetas, confirme que el enlace es una página pública de resultados de Amazon fuera de Japón e intente una consulta más corta o amplia.
- 2Conserve los registros completados tras un éxito parcial; reenvíe la misma entrada tras un fallo o caducidad.
- 3Reintente más tarde tras límite de ritmo, indisponibilidad temporal o agotamiento de tiempo.
- 4Si falla la autenticación, verifique la API Key configurada en el entorno de ejecución.
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
| Campo | Nombre de negocio | Tipo | Obligatorio | Predeterminado | Enum / Restricciones | Ejemplo | Descripción |
|---|---|---|---|---|---|---|---|
| search_url | URL de resultados de Amazon | string | Sí | — | — | https://www.amazon.com/s?k=ipad+mini&crid=3F8PFA9JP0GNF&sprefix=ipad%2Caps%2C387&ref=nb_sb_ss_p13n-expert-pd-ops-ranker_7_4 | URL HTTPS completa de una página de resultados de Amazon para un marketplace fuera de Japón. El enlace debe ser una página de resultados y tener como máximo 512 caracteres; amazon.co.jp no es compatible. |
| crawl_count | Cantidad de resultados esperada | string | Sí | — | — | 1 | Número esperado de productos en los resultados, de 1 a 10000. Los resultados se devuelven en lotes completos de 20, así que la cantidad real puede redondearse al alza. |
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
| Campo | Nombre de negocio | Tipo | Ejemplo | Descripción |
|---|---|---|---|---|
| ad_tag | Etiqueta de anuncio | boolean | false | Indica si la tarjeta de producto está marcada como anuncio en la página de resultados. |
| biz_id | ID de negocio | string | https://www.amazon.com/s?k=laptop | Identificador de negocio asociado al registro; en la forma actual es la URL de resultados de búsqueda. |
| crawl_rate | Estado de captura | string | running | Texto de estado de captura devuelto con el registro de origen. |
| crawl_time | Capturado el | string | 2026-09-15T14:46:17 | Hora de captura de esta tarjeta de producto; el origen no indica zona horaria. |
| current_price | Precio actual | string | $899.99 | Texto del precio actual mostrado en la tarjeta de resultados, incluido el símbolo de moneda. |
| delivery | Entrega | string | FREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon. | Plazos y condiciones de entrega mostrados en la tarjeta de resultados. |
| image_url | URL de imagen | string | https://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpg | URL de la imagen del producto mostrada en la tarjeta de resultados. |
| in_stock | Info de stock | string | Only 10 left in stock - order soon. | Texto de disponibilidad mostrado en la tarjeta de resultados. |
| item_id | ID de elemento | string | https://www.amazon.com/s?k=laptop | Identificador del elemento de captura de la página de resultados a la que pertenece este registro. |
| keyword | Palabra clave | string | laptop | Palabra clave de búsqueda asociada a esta tarjeta de producto. |
| original_price | Precio original | string | $1,799.99 | Texto del precio original o tachado mostrado en la tarjeta, incluido el símbolo de moneda. |
| product_id | ID de producto | string | B0HG365ZZV-US | Identificador de producto de este listado de resultados de búsqueda. |
| product_title | Título del producto | string | HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD | Título del producto mostrado en la tarjeta de resultados. |
| rating_count | Número de valoraciones | string | 12 | Número de valoraciones mostrado en la tarjeta de resultados. |
| rating_score | Valoración | string | 4.8 | Valoración mostrada en la tarjeta de resultados. |
| recent_purchase | Compras recientes | string | 500+ bought in past month | Texto de compras recientes mostrado en la tarjeta de resultados. |
| search_front_category | Categoría frontal | string | Electronics | Texto de categoría al frente de la búsqueda cuando la tarjeta lo proporciona. |
| shipping_free | Envío gratis | string | FREE delivery | Texto de envío gratis mostrado en la tarjeta de resultados. |
| shipping_price | Precio de envío | string | $0.00 | Texto del precio de envío mostrado en la tarjeta de resultados. |
| site_code | Código de sitio | string | US | Código del marketplace de Amazon de este listado, por ejemplo US. |
| sku_id | ID de SKU | string | B0HG365ZZV-US | Identificador de SKU devuelto con este resultado de búsqueda. |
| source_crawl_time | Hora de origen | string | 1789454777823 | Marca de tiempo de captura de origen devuelta como texto con el listado. |
| listing_status | Estado del anuncio | string | 有效 | Texto de estado del anuncio devuelto con el registro, en la redacción de origen. |
| source_item | Elemento de origen | string | https://www.amazon.com/s?k=laptop | URL de resultados de búsqueda asociada al elemento de captura que produjo este registro. |
| no_data | Marcador sin datos | boolean | false | Indica si el elemento de captura no produjo tarjetas de producto coincidentes. |
Schema del registro
La salida se devuelve registro a registro. detail.output.idFieldHint
{
"type": "object",
"properties": {
"ad_tag": {
"type": "boolean",
"title": "Etiqueta de anuncio",
"description": "Indica si la tarjeta de producto está marcada como anuncio en la página de resultados.",
"prefill": false
},
"biz_id": {
"type": "string",
"title": "ID de negocio",
"description": "Identificador de negocio asociado al registro; en la forma actual es la URL de resultados de búsqueda.",
"prefill": "https://www.amazon.com/s?k=laptop"
},
"crawl_rate": {
"type": "string",
"title": "Estado de captura",
"description": "Texto de estado de captura devuelto con el registro de origen.",
"prefill": "running"
},
"crawl_time": {
"type": "string",
"title": "Capturado el",
"description": "Hora de captura de esta tarjeta de producto; el origen no indica zona horaria.",
"prefill": "2026-09-15T14:46:17"
},
"current_price": {
"type": "string",
"title": "Precio actual",
"description": "Texto del precio actual mostrado en la tarjeta de resultados, incluido el símbolo de moneda.",
"prefill": "$899.99"
},
"delivery": {
"type": "string",
"title": "Entrega",
"description": "Plazos y condiciones de entrega mostrados en la tarjeta de resultados.",
"prefill": "FREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon."
},
"image_url": {
"type": "string",
"title": "URL de imagen",
"description": "URL de la imagen del producto mostrada en la tarjeta de resultados.",
"prefill": "https://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpg"
},
"in_stock": {
"type": "string",
"title": "Info de stock",
"description": "Texto de disponibilidad mostrado en la tarjeta de resultados.",
"prefill": "Only 10 left in stock - order soon."
},
"item_id": {
"type": "string",
"title": "ID de elemento",
"description": "Identificador del elemento de captura de la página de resultados a la que pertenece este registro.",
"prefill": "https://www.amazon.com/s?k=laptop"
},
"keyword": {
"type": "string",
"title": "Palabra clave",
"description": "Palabra clave de búsqueda asociada a esta tarjeta de producto.",
"prefill": "laptop"
},
"original_price": {
"type": "string",
"title": "Precio original",
"description": "Texto del precio original o tachado mostrado en la tarjeta, incluido el símbolo de moneda.",
"prefill": "$1,799.99"
},
"product_id": {
"type": "string",
"title": "ID de producto",
"description": "Identificador de producto de este listado de resultados de búsqueda.",
"prefill": "B0HG365ZZV-US"
},
"product_title": {
"type": "string",
"title": "Título del producto",
"description": "Título del producto mostrado en la tarjeta de resultados.",
"prefill": "HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD"
},
"rating_count": {
"type": "string",
"title": "Número de valoraciones",
"description": "Número de valoraciones mostrado en la tarjeta de resultados.",
"prefill": "12"
},
"rating_score": {
"type": "string",
"title": "Valoración",
"description": "Valoración mostrada en la tarjeta de resultados.",
"prefill": "4.8"
},
"recent_purchase": {
"type": "string",
"title": "Compras recientes",
"description": "Texto de compras recientes mostrado en la tarjeta de resultados.",
"prefill": "500+ bought in past month"
},
"search_front_category": {
"type": "string",
"title": "Categoría frontal",
"description": "Texto de categoría al frente de la búsqueda cuando la tarjeta lo proporciona.",
"prefill": "Electronics"
},
"shipping_free": {
"type": "string",
"title": "Envío gratis",
"description": "Texto de envío gratis mostrado en la tarjeta de resultados.",
"prefill": "FREE delivery"
},
"shipping_price": {
"type": "string",
"title": "Precio de envío",
"description": "Texto del precio de envío mostrado en la tarjeta de resultados.",
"prefill": "$0.00"
},
"site_code": {
"type": "string",
"title": "Código de sitio",
"description": "Código del marketplace de Amazon de este listado, por ejemplo US.",
"prefill": "US"
},
"sku_id": {
"type": "string",
"title": "ID de SKU",
"description": "Identificador de SKU devuelto con este resultado de búsqueda.",
"prefill": "B0HG365ZZV-US"
},
"source_crawl_time": {
"type": "string",
"title": "Hora de origen",
"description": "Marca de tiempo de captura de origen devuelta como texto con el listado.",
"prefill": "1789454777823"
},
"listing_status": {
"type": "string",
"title": "Estado del anuncio",
"description": "Texto de estado del anuncio devuelto con el registro, en la redacción de origen.",
"prefill": "有效"
},
"source_item": {
"type": "string",
"title": "Elemento de origen",
"description": "URL de resultados de búsqueda asociada al elemento de captura que produjo este registro.",
"prefill": "https://www.amazon.com/s?k=laptop"
},
"no_data": {
"type": "boolean",
"title": "Marcador sin datos",
"description": "Indica si el elemento de captura no produjo tarjetas de producto coincidentes.",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}Integración
Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino.
Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.
Configuración del cliente
Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.
{
"mcpServers": {
"meme_today__amazon-keyword-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=meme_today/amazon-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Deja que la IA lo configure por ti
¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)
detail.access.mcp.composeHint
Precios
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 20 registro; cualquier unidad parcial se redondea a 20 registro.
Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.
Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.
Ver créditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.