Amazon Rufus Scraper: Respuestas Conscientes del Producto por ASIN

Resumen:

• Amazon Rufus, el asistente de compras en la aplicación de Amazon, está disponible a través de la API de Scrapeless Scraping como scraper.amazon con type: "rufus".
• Funciona en dos modos: envía keywords para una respuesta de categoría con selecciones de productos agrupados y ordenados, o añade un asin para hacer una pregunta con conocimiento del producto sobre un artículo específico.
• Un POST a /api/v1/scraper/request devuelve la respuesta sintetizada, las selecciones agrupadas, un array de products aplanado y las preguntas de seguimiento sugeridas por Rufus.
• El parámetro con conocimiento del producto es asin. Con él establecido, Rufus responde sobre ese producto exacto; sin él, la misma pregunta recibe una respuesta genérica "¿qué producto?".
• Empieza gratis. Las nuevas cuentas de Scrapeless incluyen créditos gratuitos de la API Scraper — regístrate en app.scrapeless.com.

Amazon Rufus responde a preguntas de compras en lenguaje sencillo — "mejores auriculares con cancelación de ruido" — y ahora también puede responder preguntas sobre un producto específico: "¿es bueno para el gimnasio?". La API de Scraping de Scrapeless captura ambos como JSON estructurado. Esta guía muestra la solicitud, los dos modos, la forma de la respuesta y el único parámetro — asin — que hace a Rufus consciente del producto. Cada solicitud y campo a continuación fue capturada de una ejecución en vivo del actor.

Lo que puedes hacer con el Scraper Rufus

• Rastrear la participación de recomendaciones — capturar qué productos Rufus menciona para una consulta de categoría, en qué sección agrupada y en qué orden.
• Responder preguntas específicas sobre productos a gran escala — pasar un ASIN y una pregunta para ver cómo Rufus describe un producto para su ajuste, caso de uso o comparación.
• Monitorear una marca o competidor — observar si un producto aparece en las recomendaciones de Rufus y cómo se enmarca, a lo largo del tiempo.
• Alimentar sistemas posteriores — canalizar la respuesta, las selecciones agrupadas y las preguntas de seguimiento en tableros o alertas como JSON limpio.

Dos Modos: Categoría y Conocimiento del Producto

El tipo Rufus se comporta de manera diferente dependiendo de si incluyes un asin:

• Modo de categoría (keywords solamente). Rufus devuelve una recomendación sintetizada, content_blocks que agrupan productos en secciones etiquetadas, un array de products aplanado y un conjunto de related_questions. Utiliza esto para ver qué recomienda Rufus para una consulta.
• Modo con conocimiento del producto (keywords + asin). Rufus enfoca la pregunta en ese producto específico y responde directamente sobre él. En una ejecución en vivo, preguntar "¿Es bueno para el gimnasio y correr?" con el ASIN de un par de auriculares Sony WH-1000XM6 devolvió "No, los auriculares Sony WH-1000XM6 no son ideales para el gimnasio y correr…". Elimina el asin y la misma pregunta recibe una respuesta genérica "¿qué producto estás preguntando?" — el ASIN es lo que hace que la respuesta sea específica del producto.

Endpoint y Parámetros

El tipo Rufus se ejecuta en el endpoint de API de Scraping síncrono. Autentica con tu token en el encabezado x-api-token.

• Endpoint: POST https://api.scrapeless.com/api/v1/scraper/request
• Actor: scraper.amazon

El resultado se devuelve de manera síncrona en un objeto result.

Solicitud Autenticada

Modo de categoría (ilustrativo — reemplaza el token):

curl 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: YOUR_API_TOKEN' \
  --data '{
    "actor": "scraper.amazon",
    "input": {
      "type": "rufus",
      "keywords": "mejores auriculares con cancelación de ruido",
      "domain": "www.amazon.com"
    }
  }'

El modo con conocimiento del producto añade un asin:

curl 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: YOUR_API_TOKEN' \
  --data '{
    "actor": "scraper.amazon",
    "input": {
      "type": "rufus",
      "keywords": "¿Es bueno para el gimnasio y correr?",
      "domain": "www.amazon.com",
      "asin": "B0GN4CFF6H"
    }
  }'

Integración en Python

Este ejemplo lee el token de la variable de entorno SCRAPELESS_API_KEY y ejecuta una consulta de Rufus con conocimiento del producto. Utiliza solo la biblioteca estándar de Python.

import json
import os
import urllib.request

API_URL = "https://api.scrapeless.com/api/v1/scraper/request"
API_TOKEN = os.environ["SCRAPELESS_API_KEY"]

payload = {
    "actor": "scraper.amazon",
    "input": {
        "type": "rufus",
        "keywords": "¿Es bueno para el gimnasio y correr?", 

"dominio": "www.amazon.com",
"asin": "B0GN4CFF6H",
},
}

solicitud = urllib.request.Request(
API_URL,
data=json.dumps(payload).encode("utf-8"),
headers={"Content-Type": "application/json", "x-api-token": API_TOKEN},
method="POST",
)

con urllib.request.urlopen(solicitud, timeout=180) como respuesta:
datos = json.loads(respuesta.read().decode("utf-8"))

resultado = datos.get("resultado", {})
print("consulta:", resultado.get("user_query"))
print("respuesta:", (resultado.get("inference_text") o "")[:200])

## Lo que obtienes de vuelta

El modo de categoría devuelve el payload más rico. Los campos a continuación son los que usarás con más frecuencia; los valores son una muestra ilustrativa de una ejecución en vivo, recortada por longitud.

```json
// Muestra ilustrativa de una ejecución en vivo de scraper.amazon (tipo rufus) — los nombres de los campos son reales, los valores recortados.
{
  "metadata": { "tipo": "rufus" },
  "resultado": {
    "user_query": "mejores auriculares con cancelación de ruido",
    "inference_text": "Aquí tienes algunos de los mejores auriculares con cancelación de ruido ...",
    "content_blocks": [
      { "tipo": "texto" },
      { "tipo": "sección_producto", "productos": [{ "asin": "B0FDKR293G" }] }
    ],
    "productos": [
      {
        "asin": "B0FDKR293G",
        "titulo": "Auriculares Bluetooth Bose QuietComfort Ultra (2da Gen)",
        "precio": "$369.00",
        "precio_original": "$449.00",
        "calificación": "4.3",
        "reseñas": "2,297",
        "categoría": "Mejor ANC en general",
        "entrega": "ENVÍO GRATIS el dom, 19 de julio",
        "imagen_url": "<url de la imagen del producto>",
        "url": "<url del producto en amazon>"
      }
    ],
    "preguntas_relacionadas": [
      "Mejores auriculares ANC para entrenamientos",
      "Comparar Sony XM5 vs Bose QC Ultra"
    ]
  }
}

El modo consciente de productos devuelve el mismo sobre, pero la respuesta en inference_text está limitada al ASIN que enviaste, y el arreglo productos suele estar ausente porque Rufus responde sobre un artículo en lugar de recomendar una lista.

Problemas comunes con la forma de datos

• asin es el interruptor consciente del producto — y debe ser asin. Pasar product_id o productId se ignora silenciosamente; solo asin limita a Rufus a un producto específico.
• Las respuestas de categoría y conscientes del producto difieren. Una consulta de categoría devuelve productos y content_blocks; una consulta consciente del producto devuelve un inference_text específico del producto y generalmente no hay arreglo de productos. Rama en cuál enviaste.
• Los precios y calificaciones son cadenas. precio, precio_original, calificación y reseñas vuelven como cadenas de visualización ("$369.00", "2,297"), así que analízalos en lugar de convertirlos directamente.
• content_blocks lleva el agrupamiento. El arreglo aplanado de productos pierde las etiquetas de sección; lee content_blocks cuando necesites saber en qué sección colocó Rufus un producto.
• Las respuestas son instantáneas por consulta. Una respuesta de Rufus refleja una consulta en un momento específico, no una exportación de catálogo, así que captura con el tiempo para rastrear cambios.

Actores compañeros y lectura relacionada

El tipo Rufus es un modo del actor de Amazon. Scrapeless publica un repositorio de ejemplo de scraper Rufus de código abierto con código ejecutable en cinco idiomas. Para obtener información sobre el asistente, Amazon presenta Rufus, su asistente de compras generativo, y cubre la gama más amplia en su sala de prensa de retail. Para otro motor de respuesta de IA, consulta la guía de la API del scraper ChatGPT.

Conclusión

El scraper Rufus convierte al asistente de compras de Amazon en JSON estructurado, en dos modos desde un único punto final: envía palabras clave para una recomendación agrupada y clasificada, o agrega un asin para una respuesta consciente del producto sobre un artículo específico. Rama en cuál modo enviaste, analiza los precios y calificaciones en cadena, y lee content_blocks cuando necesites el agrupamiento. Es un flujo confiable para rastrear cómo Rufus recomiendan y describen los productos.
¿Listo para capturar las respuestas de Rufus como datos? Comienza gratis desde el tablero de Scrapeless, ve dónde se encuentra el actor en la página de productos de la API de scraping, o compara planes en precios de Scrapeless.

FAQ

P: ¿Qué es el scraper de Amazon Rufus?
R: Es el actor de la API de Scraping de Scrapeless scraper.amazon con type: "rufus", que envía una pregunta a Amazon Rufus y devuelve la respuesta como JSON estructurado: la respuesta sintetizada, selecciones de productos agrupadas, un array products aplanado y preguntas de seguimiento sugeridas.

P: ¿Cómo pregunto sobre un producto específico?
R: Agrega un campo asin a la entrada. Rufus entonces responde sobre ese producto exacto. Sin el asin, la misma pregunta devuelve una respuesta genérica "¿qué producto?".

P: ¿Qué endpoint y parámetros utiliza?
R: POST https://api.scrapeless.com/api/v1/scraper/request con actor configurado en scraper.amazon y un objeto input que contiene type: "rufus", keywords, domain, y opcionalmente asin. Autentica con tu token en x-api-token.

P: ¿Funciona product_id en lugar de asin?
R: No. Solo asin limita a Rufus a un producto específico; product_id y productId son ignorados.

P: ¿Cómo obtengo la sección bajo la cual se agrupó un producto?
R: Lee content_blocks. El array products aplanado elimina las etiquetas de sección, mientras que content_blocks preserva la agrupación de product_section que utilizó Rufus.

P: ¿La respuesta es sincrónica?
R: Sí. El objeto result se devuelve en la misma respuesta; no debes consultar un endpoint separado.