Amazon Rufus Scraper: Respostas Conscientes do Produto por ASIN

TL;DR:

• Amazon Rufus, o assistente de compras no aplicativo da Amazon, está disponível através da API Scrapeless Scraping como scraper.amazon com type: "rufus".
• Funciona em dois modos: envie keywords para uma resposta de categoria com escolhas de produtos agrupadas e classificadas — ou adicione um asin para fazer uma pergunta consciente do produto sobre um item específico.
• Um POST para /api/v1/scraper/request retorna a resposta sintetizada, as escolhas agrupadas, um array products achatado e as perguntas sugeridas de Rufus.
• O parâmetro consciente do produto é asin. Com ele definido, Rufus responde sobre aquele produto exato; sem ele, a mesma pergunta recebe uma resposta genérica "qual produto?".
• Comece grátis. Novas contas Scrapeless incluem créditos gratuitos da API Scraper — inscreva-se em app.scrapeless.com.

Amazon Rufus responde perguntas de compras em linguagem simples — "melhores fones de ouvido com cancelamento de ruído" — e agora também pode responder a perguntas sobre um produto específico: "isso é bom para a academia?". A Scrapeless Scraping API captura tudo isso como JSON estruturado. Este guia mostra a solicitação, os dois modos, a estrutura da resposta e o único parâmetro — asin — que torna Rufus consciente do produto. Cada solicitação e campo abaixo foi capturado de uma execução ao vivo do ator.

O Que Você Pode Fazer Com o Scraper Rufus

• Acompanhe a parcela de recomendações — capture quais produtos Rufus menciona para uma consulta de categoria, em qual seção agrupada e em que ordem.
• Responda a perguntas específicas de produtos em grande escala — passe um ASIN e uma pergunta para ver como Rufus descreve um produto em termos de adequação, caso de uso ou comparação.
• Monitore uma marca ou concorrente — observe se um produto aparece nas recomendações de Rufus, e como ele é apresentado, ao longo do tempo.
• Alimente sistemas downstream — envie a resposta, escolhas agrupadas e perguntas de acompanhamento para dashboards ou alertas como JSON limpo.

Dois Modos: Categoria e Consciente do Produto

O tipo Rufus se comporta de forma diferente dependendo de você incluir um asin:

• Modo de categoria (keywords apenas). Rufus retorna uma recomendação sintetizada, content_blocks que agrupam produtos em seções etiquetadas, um array products achatado e um conjunto de related_questions. Use isso para ver o que Rufus recomenda para uma consulta.
• Modo consciente do produto (keywords + asin). Rufus delimita a pergunta para aquele produto específico e responde diretamente sobre ele. Em uma execução ao vivo, perguntando "Isso é bom para a academia e corrida?" com o ASIN para um par de fones de ouvido Sony WH-1000XM6 retornou "Não, os fones de ouvido Sony WH-1000XM6 não são ideais para a academia e corrida...". Remova o asin e a mesma pergunta recebe uma resposta genérica "sobre qual produto você está perguntando?" — o ASIN é o que torna a resposta específica ao produto.

Ponto de Acesso e Parâmetros

O tipo Rufus funciona no ponto de acesso síncrono da API Scraping. Autentique-se com seu token no cabeçalho x-api-token.

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

O resultado é retornado de forma síncrona em um objeto result.

Solicitação Autenticada

Modo de categoria (ilustrativo — substitua o token):

curl 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: SEU_API_TOKEN' \
  --data '{
    "actor": "scraper.amazon",
    "input": {
      "type": "rufus",
      "keywords": "melhores fones de ouvido com cancelamento de ruído",
      "domain": "www.amazon.com"
    }
  }'

O modo consciente do produto adiciona um asin:

curl 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: SEU_API_TOKEN' \
  --data '{
    "actor": "scraper.amazon",
    "input": {
      "type": "rufus",
      "keywords": "Isso é bom para a academia e corrida?",
      "domain": "www.amazon.com",
      "asin": "B0GN4CFF6H"
    }
  }'

Integração com Python

Este exemplo lê o token da variável de ambiente SCRAPELESS_API_KEY e executa uma consulta consciente do produto Rufus. Ele usa apenas a biblioteca padrão do 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": "Isso é bom para a academia e corrida?",

{
  "domínio": "www.amazon.com",
  "asin": "B0GN4CFF6H"
}

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

com urllib.request.urlopen(solicitação, timeout=180) como resposta:
    dados = json.loads(resposta.read().decode("utf-8"))

resultado = dados.get("resultado", {})
print("consulta:", resultado.get("user_query"))
print("resposta:", (resultado.get("inference_text") or "")[:200])

O Que Você Recebe de Volta

O modo categoria retorna o carregamento mais rico. Os campos abaixo são os que você usará com mais frequência; os valores são uma amostra ilustrativa de uma execução ao vivo, reduzidos em comprimento.

{
  "metadados": { "tipo": "rufus" },
  "resultado": {
    "user_query": "melhores fones de ouvido com cancelamento de ruído",
    "inference_text": "Aqui estão alguns dos melhores fones de ouvido com cancelamento de ruído ...",
    "content_blocks": [
      { "tipo": "texto" },
      { "tipo": "seção_de_produto", "produtos": [{ "asin": "B0FDKR293G" }] }
    ],
    "produtos": [
      {
        "asin": "B0FDKR293G",
        "título": "Fones de Ouvido Bluetooth Bose QuietComfort Ultra (2ª Geração)",
        "preço": "$369.00",
        "preço_original": "$449.00",
        "classificação": "4.3",
        "avaliações": "2.297",
        "categoria": "Melhor ANC Geral",
        "entrega": "Entrega GRÁTIS Dom, 19 de Jul",
        "imagem_url": "<URL da imagem do produto>",
        "url": "<URL do produto na amazon>"
      }
    ],
    "perguntas_relacionadas": [
      "Melhores fones intra-auriculares ANC para treinos",
      "Comparar Sony XM5 vs Bose QC Ultra"
    ]
  }
}

O modo ciente do produto retorna o mesmo envelope, mas a resposta em inference_text é limitada ao ASIN que você passou, e a matriz produtos geralmente está ausente porque Rufus está respondendo sobre um item em vez de recomendar uma lista.

Problemas Comuns de Formato de Dados

• asin é o interruptor ciente do produto - e deve ser asin. Passar product_id ou productId é silenciosamente ignorado; apenas asin limita Rufus a um produto específico.
• As respostas de categoria e cientes do produto diferem. Uma consulta de categoria retorna produtos e content_blocks; uma consulta ciente do produto retorna um inference_text específico do produto e geralmente nenhuma matriz produtos. Ramifique-se com base no que você enviou.
• Os preços e classificações são strings. preço, preço_original, classificação e avaliações retornam como strings de exibição ("$369.00", "2.297"), então analise-os em vez de converter diretamente.
• content_blocks carregam o agrupamento. A matriz produtos achatada perde os rótulos das seções; leia content_blocks quando você precisar saber em qual seção Rufus colocou um produto.
• As respostas são instantâneas por consulta. Uma resposta de Rufus reflete uma consulta em um único momento, não uma exportação de catálogo, portanto, capture ao longo do tempo para rastrear mudanças.

Atores Acompanhantes e Leitura Relacionada

O tipo Rufus é um modo do ator da Amazon. Scrapeless publica um repositório de exemplo de scraper Rufus de código aberto com código executável em cinco linguagens. Para um contexto sobre o assistente, a Amazon apresenta Rufus, seu assistente de compras generativo, e cobre a linha mais ampla em sua sala de notícias de varejo. Para outro mecanismo de resposta de IA, consulte o guia da API do Scraper ChatGPT.

Conclusão

O scraper Rufus transforma o assistente de compras da Amazon em JSON estruturado, em dois modos a partir de um único endpoint: envie keywords para uma recomendação agrupada e classificada, ou adicione um asin para uma resposta ciente do produto sobre um item específico. Ramifique-se com base em qual modo você enviou, analise os preços e avaliações em strings de exibição e leia content_blocks quando precisar do agrupamento. É um feed confiável para rastrear como Rufus recomenda e descreve produtos.
Pronto para capturar as respostas do Rufus como dados? Comece gratuitamente no painel do Scrapeless, veja onde o ator se encaixa na página do produto API de Scraping ou compare planos em preços do Scrapeless.

FAQ

Q: O que é o scraper Amazon Rufus?
A: É o ator scraper.amazon da Scrapeless Scraping API com type: "rufus", que envia uma pergunta ao Amazon Rufus e retorna a resposta como JSON estruturado - a resposta sintetizada, escolhas de produtos agrupadas, um array products achatado e perguntas de acompanhamento sugeridas.

Q: Como faço para perguntar sobre um produto específico?
A: Adicione um campo asin ao input. Rufus então responde sobre aquele produto exato. Sem o asin, a mesma pergunta retorna uma resposta genérica "qual produto?".

Q: Qual endpoint e parâmetros ele utiliza?
A: POST https://api.scrapeless.com/api/v1/scraper/request com actor definido como scraper.amazon e um objeto input contendo type: "rufus", keywords, domain e opcionalmente asin. Autentique-se com seu token em x-api-token.

Q: O product_id funciona em vez de asin?
A: Não. Somente asin limita o Rufus a um produto específico; product_id e productId são ignorados.

Q: Como faço para obter a seção sob a qual um produto foi agrupado?
A: Leia content_blocks. O array products achatado elimina os rótulos das seções, enquanto content_blocks preserva o agrupamento product_section que Rufus utilizou.

Q: A resposta é síncrona?
A: Sim. O objeto result é retornado na mesma resposta; você não precisa consultar um endpoint separado.