API de Scraper da Amazon Alexa: Respostas Estruturadas de Compras da Alexa

Resumo:

• O Amazon Alexa Scraper é um ator do LLM Chat Scraper sem scraping (scraper.alexa) que transforma uma pergunta de compra da Alexa em JSON estruturado.
• Um POST autenticado para /api/v2/scraper/execute com um prompt e um country retorna a resposta mais os produtos recomendados pela Alexa — sem automação de navegador ou engenharia reversa de aplicativo.
• Você recebe de volta a consulta, a resposta em Markdown e texto simples, um array products com preço, avaliação, entrega e ASIN, um ID de conversação para acompanhamento, e referências e sugestões opcionais.
• Os campos podem ser nulos e variam por consulta: references, sources e suggestions podem voltar vazios, e os preços chegam como strings de exibição, portanto, faça o parsing de forma defensiva.
• Comece gratuitamente. Novas contas Scrapeless incluem créditos gratuitos da API Scraper — inscreva-se em app.scrapeless.com.

A Amazon Alexa agora responde a perguntas de compra da maneira como uma pessoa faria — "melhores fones com cancelamento de ruído por menos de $300" — e responde com uma recomendação escrita e um conjunto de produtos para comprar. Isso torna a Alexa uma superfície de dados: os produtos que ela menciona, os preços que mostra e a ordem em que os classifica são todos sinais que valem a pena rastrear. Este guia mostra como capturar uma resposta da Alexa como dados estruturados com a Scrapeless Scraping API, o que a resposta contém e onde os campos precisam ser tratados com cuidado. Cada solicitação e campo abaixo foram capturados de uma execução ao vivo do ator.

O Que Você Pode Fazer Com o Amazon Alexa Scraper

O ator pega um prompt de compra em linguagem natural e um país-alvo e retorna a resposta da Alexa como JSON. Na prática, isso permite que você:

• Rastree recomendações de produtos — capture quais produtos a Alexa nomeia para uma consulta de categoria, com seu ASIN, preço e avaliação, e observe como o conjunto muda ao longo do tempo.
• Compare entre regiões — envie o mesmo prompt com um country diferente para ver como as escolhas da Alexa mudam por mercado.
• Monitore a visibilidade nas compras de IA — meça se seu produto ou o de um concorrente aparece na resposta da Alexa para as consultas que importam para você.
• Alimente sistemas downstream — canalize a resposta estruturada para painéis, planilhas ou alertas sem raspar o aplicativo da Alexa você mesmo.

Por Que o Ator Alexa da Scrapeless

As respostas de compras da Alexa são geradas por trás de um aplicativo, não servidas como uma página da web pública que você pode solicitar. O ator Scrapeless lida com a coleta e retorna um envelope limpo e amigável ao desenvolvedor, para que seu código envie um prompt e leia campos em vez de controlar um aplicativo, rotacionar infraestrutura ou manter seletores. A Alexa é um membro da família LLM Chat Scraper, o que significa que a mesma forma de solicitação que você usa aqui também funciona para os outros mecanismos de resposta — você altera o valor de actor e mantém o resto.

Endpoint e Parâmetros

O ator opera no endpoint síncrono da API Scraper. Autentique-se com seu token da API no cabeçalho x-api-token.

• Endpoint: POST https://api.scrapeless.com/api/v2/scraper/execute
• Ator: scraper.alexa

A resposta é retornada de forma síncrona em um objeto task_result; você não precisa fazer polling. Obtenha seu token no painel da Scrapeless.

Solicitação Autenticada

Uma solicitação mínima se parece com isso (ilustrativa — substitua o token):

curl 'https://api.scrapeless.com/api/v2/scraper/execute' \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: SEU_TOKEN_API' \
  --data '{
    "actor": "scraper.alexa",
    "input": {
      "prompt": "melhores fones com cancelamento de ruído por menos de $300",
      "country": "US"
    }
  }'

Integração em Python

Este exemplo lê o token da variável de ambiente SCRAPELESS_API_KEY, envia a solicitação e imprime a resposta e os produtos recomendados. Ele usa apenas a biblioteca padrão do Python.

import json
import os
import urllib.request

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

payload = {
    "actor": "scraper.alexa",
    "input": {
        "prompt": "melhores fones com cancelamento de ruído por menos de $300",
        "country": "US",
    },
}

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

with urllib.request.urlopen(request, timeout=180) as response:

data = json.loads(response.read().decode("utf-8"))

result = data.get("task_result", {})
print("status:", data.get("status"))
print("query:", result.get("user_text"))
print("produtos retornados:", len(result.get("products") or []))

for product in (result.get("products") or [])[:3]:
    print("-", product.get("title"))
    print("   preço:", product.get("price"), "| classificação:", product.get("rating"))
    print("   asin:", product.get("product_id"))

O que você recebe de volta

A resposta chega dentro de task_result. Os campos abaixo são os que você usará mais; os valores são um exemplo ilustrativo de uma execução ao vivo, reduzido para comprimento.

// Exemplo ilustrativo de uma execução ao vivo do scraper.alexa — nomes de campo são reais, valores reduzidos.
{
  "status": "sucesso",
  "task_id": "1ba323ef-1bee-446c-9a80-090cb9c67231",
  "task_result": {
    "user_text": "melhores fones de ouvido com cancelamento de ruído por menos de $300",
    "md_text": "**Fones de Ouvido Premium com Cancelamento de Ruído** ...",
    "raw_text": "**Fones de Ouvido Premium com Cancelamento de Ruído** {cite_product_1} ...",
    "completed": true,
    "conversation": { "id": "amzn1.conversation.866ba539-..." },
    "products": [
      {
        "citation_id": "cite_product_1",
        "product_id": "B09XS7JWHH",
        "title": "Fones de Ouvido Premium com Cancelamento de Ruído Sony, Bateria de 30 Horas, Controle por Voz Alexa",
        "price": "~~$399.99~~ $248.00",
        "rating": "{rating 4.2} 19,796 Avaliações",
        "delivery": "Entrega até 15 de julho",
        "image_url": "<URL da imagem do produto>",
        "url": "<dl.amazon.com redirecionando para /dp/B09XS7JWHH>"
      }
    ],
    "references": [],
    "sources": [],
    "suggestions": [],
    "directives": []
  }
}

Problemas Comuns de Formato de Dados

Alguns campos precisam de análise defensiva:

• user_text é a consulta, não a resposta. A resposta vive em md_text (rico) e raw_text (simples). Se você quiser a recomendação em prosa, leia esses campos.
• Os preços são strings de exibição, não números. Um item com desconto volta como ~~$399.99~~ $248.00, onde o valor riscado é o preço da lista e o segundo é o preço atual. Extraia os números em vez de converter o campo diretamente.
• rating é uma string formatada. Chega como {rating 4.2} 19,796 Avaliações, então extraia a pontuação e a contagem de avaliações com uma pequena regex em vez de esperar um float.
• Arrays vazios são normais. references, sources e suggestions podem estar vazios dependendo da consulta, então proteja-se contra None e [] antes de iterar.
• URLs de produtos são redirecionamentos. A url é um link dl.amazon.com/redirect que se resolve para a página do produto /dp/<ASIN>; use product_id quando você quiser o ASIN canônico.

Atores Companheiros

Como a Alexa é parte da família LLM Chat Scraper, o mesmo padrão de solicitação cobre os outros motores de resposta — troque scraper.alexa por scraper.chatgpt, scraper.gemini, scraper.perplexity e outros. Scrapeless também publica um repositório de exemplo de scraper Alexa de código aberto com código executável em cinco linguagens se você quiser um ponto de partida fora do Python. Para outro motor de resposta que compartilha a mesma estrutura de solicitação, consulte o guia da API do ChatGPT Scraper.

Conclusão

O Scraper da Amazon Alexa transforma uma resposta de compra conversacional em JSON estruturado com uma solicitação autenticada: envie um prompt e um país, leia de volta o texto da resposta e um array de produtos com ASIN, preço, classificação e entrega. Trate preços e classificações como strings, espere que alguns arrays estejam vazios, e você terá um feed confiável para rastrear como a Alexa recomenda produtos em diferentes consultas e regiões. A Amazon documenta Alexa para desenvolvedores, e a sala de notícias dos dispositivos da Amazon cobre como o assistente está evoluindo.
Pronto para capturar as respostas da Alexa como dados? Comece gratuitamente no painel do Scrapeless, veja onde o ator se encaixa na página do produto da API de Scraping, ou compare planos em preços do Scrapeless.

FAQ

Q: O que é o Scraper da Amazon Alexa?
A: É um ator de Scrapeless LLM Chat Scraper (scraper.alexa) que envia um prompt de compras para a Amazon Alexa e retorna a resposta como JSON estruturado — a consulta, a resposta em Markdown e texto simples, e um array products com ASIN, preço, classificação e entrega.

Q: Qual endpoint e parâmetros ele usa?
A: POST https://api.scrapeless.com/api/v2/scraper/execute com actor definido como scraper.alexa e um objeto input contendo prompt e country. Autentique-se com seu token no cabeçalho x-api-token.

Q: A resposta é síncrona?
A: Sim. O resultado vem de volta no objeto task_result da mesma resposta, então você não precisa consultar um endpoint de resultado separado.

Q: Preciso de um navegador ou pool de proxy?
A: Não. O Scrapeless executa a coleta por trás da API, então seu aplicativo apenas envia a solicitação e analisa o JSON retornado.

Q: Por que references, sources ou suggestions às vezes estão vazios?
A: Esses campos dependem da consulta. Um prompt de categoria simples pode retornar produtos sem citações separadas ou sugestões de acompanhamento, então trate os arrays como opcionais e proteja-se antes de iterar.

Q: Como leio o preço e a classificação?
A: Ambos são strings de exibição. O preço chega como ~~$399.99~~ $248.00 (preço de lista riscado, preço atual depois), e a classificação como {rating 4.2} 19.796 Avaliações. Extraia os números com um pequeno analisador em vez de converter o campo diretamente.

Q: Posso usar o mesmo código para outros assistentes de IA?
A: Sim. A Alexa compartilha a forma do pedido do LLM Chat Scraper com os outros motores, então trocar scraper.alexa por scraper.chatgpt, scraper.gemini ou scraper.perplexity reutiliza a mesma integração.