logo
languageESdown
menu

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 productoTítulo del productoPrecio actualValoraciónPalabra claveEtiqueta de anuncio
B0HG365ZZV-USHP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD$899.994.8laptopNo
B0H72JH23T-USHP 14 inch Laptop, 4GB DDR5 RAM, 128GB SSD, Intel N150 Processor$299.995.0laptopNo

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.

  1. 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.
  2. 2Conserve los registros completados tras un éxito parcial; reenvíe la misma entrada tras un fallo o caducidad.
  3. 3Reintente más tarde tras límite de ritmo, indisponibilidad temporal o agotamiento de tiempo.
  4. 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.

CampoNombre de negocioTipoObligatorioPredeterminadoEnum / RestriccionesEjemploDescripción
search_urlURL de resultados de AmazonstringSí——https://www.amazon.com/s?k=ipad+mini&crid=3F8PFA9JP0GNF&sprefix=ipad%2Caps%2C387&ref=nb_sb_ss_p13n-expert-pd-ops-ranker_7_4URL 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_countCantidad de resultados esperadastringSí——1Nú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.

CampoNombre de negocioTipoEjemploDescripción
ad_tagEtiqueta de anunciobooleanfalseIndica si la tarjeta de producto está marcada como anuncio en la página de resultados.
biz_idID de negociostringhttps://www.amazon.com/s?k=laptopIdentificador de negocio asociado al registro; en la forma actual es la URL de resultados de búsqueda.
crawl_rateEstado de capturastringrunningTexto de estado de captura devuelto con el registro de origen.
crawl_timeCapturado elstring2026-09-15T14:46:17Hora de captura de esta tarjeta de producto; el origen no indica zona horaria.
current_pricePrecio actualstring$899.99Texto del precio actual mostrado en la tarjeta de resultados, incluido el símbolo de moneda.
deliveryEntregastringFREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon.Plazos y condiciones de entrega mostrados en la tarjeta de resultados.
image_urlURL de imagenstringhttps://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpgURL de la imagen del producto mostrada en la tarjeta de resultados.
in_stockInfo de stockstringOnly 10 left in stock - order soon.Texto de disponibilidad mostrado en la tarjeta de resultados.
item_idID de elementostringhttps://www.amazon.com/s?k=laptopIdentificador del elemento de captura de la página de resultados a la que pertenece este registro.
keywordPalabra clavestringlaptopPalabra clave de búsqueda asociada a esta tarjeta de producto.
original_pricePrecio originalstring$1,799.99Texto del precio original o tachado mostrado en la tarjeta, incluido el símbolo de moneda.
product_idID de productostringB0HG365ZZV-USIdentificador de producto de este listado de resultados de búsqueda.
product_titleTítulo del productostringHP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSDTítulo del producto mostrado en la tarjeta de resultados.
rating_countNúmero de valoracionesstring12Número de valoraciones mostrado en la tarjeta de resultados.
rating_scoreValoraciónstring4.8Valoración mostrada en la tarjeta de resultados.
recent_purchaseCompras recientesstring500+ bought in past monthTexto de compras recientes mostrado en la tarjeta de resultados.
search_front_categoryCategoría frontalstringElectronicsTexto de categoría al frente de la búsqueda cuando la tarjeta lo proporciona.
shipping_freeEnvío gratisstringFREE deliveryTexto de envío gratis mostrado en la tarjeta de resultados.
shipping_pricePrecio de envíostring$0.00Texto del precio de envío mostrado en la tarjeta de resultados.
site_codeCódigo de sitiostringUSCódigo del marketplace de Amazon de este listado, por ejemplo US.
sku_idID de SKUstringB0HG365ZZV-USIdentificador de SKU devuelto con este resultado de búsqueda.
source_crawl_timeHora de origenstring1789454777823Marca de tiempo de captura de origen devuelta como texto con el listado.
listing_statusEstado del anunciostring有效Texto de estado del anuncio devuelto con el registro, en la redacción de origen.
source_itemElemento de origenstringhttps://www.amazon.com/s?k=laptopURL de resultados de búsqueda asociada al elemento de captura que produjo este registro.
no_dataMarcador sin datosbooleanfalseIndica si el elemento de captura no produjo tarjetas de producto coincidentes.

Schema del registro

La salida se devuelve registro a registro. detail.output.idFieldHint

output.schema
{
  "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 config
{
  "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

20 registros devueltos

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.

0,001 US$/ 20 registro
Per task submitted

Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.

0,0001 US$/ ejecución

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éditos

Pruébalo ahora

Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.

Ejemplo
Los parámetros se validan contra input.schema antes del envío
Rellena primero los parámetros obligatorios
Desde 0,001 US$ / 20 registro