Strider Amazon

Servidor MCP para compras na Amazon - agentes de IA podem pesquisar produtos, verificar preços, adicionar ao carrinho e gerenciar listas de compras.

GitHub

Experimente este MCPPatrocinado

Documentação

@striderlabs/mcp-amazon

Servidor MCP da Amazon por Strider Labs — dê a agentes de IA a capacidade de pesquisar produtos, gerenciar seu carrinho, fazer pedidos e rastrear remessas na Amazon por meio de automação de navegador.

Recursos

Pesquisa de Produtos — pesquise na Amazon com detalhes completos dos resultados (ASIN, preço, avaliações, selo Prime)
Detalhes do Produto — obtenha informações completas do produto por ASIN ou URL
Gerenciamento de Carrinho — adicione itens, veja o carrinho, limpe o carrinho
Colocação de Pedidos — visualize e faça pedidos com segurança de dupla confirmação
Rastreamento de Pedidos — rastreie remessas com status e informações da transportadora
Histórico de Pedidos — recupere pedidos anteriores
Status Prime — verifique a assinatura e os benefícios do Prime
Gerenciamento de Endereço — defina o endereço de entrega
Persistência de Sessão — cookies salvos em ~/.strider/amazon/ entre sessões
Modo Furtivo — atrasos aleatórios, rotação de user agent, mascaramento de webdriver para reduzir a detecção de bots

Instalação

npm install -g @striderlabs/mcp-amazon

# Install Playwright browsers (required)
npx playwright install chromium

Configuração do Cliente MCP

Claude Desktop (`~/.claude/claude_desktop_config.json`)

{
  "mcpServers": {
    "amazon": {
      "command": "striderlabs-mcp-amazon"
    }
  }
}

Cliente MCP Genérico

{
  "mcpServers": {
    "amazon": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-amazon"]
    }
  }
}

Ferramentas Disponíveis

Ferramenta	Descrição
`amazon_status`	Verifique o status de login e informações da sessão
`amazon_login`	Inicie o fluxo de login (retorna URL + instruções)
`amazon_logout`	Limpe a sessão e os cookies
`amazon_search`	Pesquise produtos por palavra-chave
`amazon_get_product`	Obtenha detalhes do produto por ASIN ou URL
`amazon_add_to_cart`	Adicione produto ao carrinho (ASIN, URL ou consulta)
`amazon_view_cart`	Veja o conteúdo do carrinho e o subtotal
`amazon_clear_cart`	Remova todos os itens do carrinho
`amazon_preview_order`	Visualize o pedido antes de fazer
`amazon_place_order`	Faça o pedido (requer `confirm=true`)
`amazon_track_order`	Rastreie o pedido por ID
`amazon_get_orders`	Obtenha o histórico de pedidos
`amazon_prime_check`	Verifique o status da assinatura Prime
`amazon_set_address`	Defina o endereço de entrega

Exemplos de Uso

Pesquisar e adicionar ao carrinho

Search for "AirPods Pro" on Amazon
→ amazon_search({ query: "AirPods Pro", maxResults: 5 })

Add the first result to cart
→ amazon_add_to_cart({ asinOrQuery: "B0BDHWDR12", quantity: 1 })

Fazer um pedido

Preview my order before placing
→ amazon_preview_order()

Place the order (user must confirm first)
→ amazon_place_order({ confirm: true })

Rastrear uma remessa

Track order 123-4567890-1234567
→ amazon_track_order({ orderId: "123-4567890-1234567" })

Fluxo de Autenticação

A Amazon exige login manual (navegadores headless não conseguem concluir o fluxo completo de autenticação da Amazon, incluindo 2FA):

Execute amazon_login — ele retorna https://www.amazon.com/ap/signin
Abra essa URL no seu navegador e faça login com suas credenciais da Amazon
Conclua qualquer autenticação de dois fatores
Execute amazon_status para verificar se a sessão foi detectada
Os cookies são salvos em ~/.strider/amazon/cookies.json para sessões futuras

Configuração

Os dados da sessão são armazenados em:

~/.strider/amazon/
├── cookies.json    # Browser session cookies
└── session.json    # Cached session metadata

Para redefinir: execute amazon_logout ou exclua o diretório ~/.strider/amazon/.

Segurança de Pedidos

amazon_place_order requer confirm: true para realmente fazer um pedido:

Sem confirm: true — retorna uma prévia (igual a amazon_preview_order)
Com confirm: true — faz o pedido imediatamente

Nunca defina confirm: true sem consentimento explícito do usuário.

Detecção de Bots

A Amazon tem detecção agressiva de bots. Este servidor inclui:

Atrasos aleatórios entre ações (500–2000ms)
Rotação de user agent (Chrome/Safari em macOS/Windows)
Mascaramento de propriedades do webdriver
Spoofing de plugins/idioma do navegador
Viewport e resolução de tela adequados

Se você receber um erro de CAPTCHA: visite amazon.com no seu navegador normal, complete o CAPTCHA e tente novamente. Os cookies serão reutilizados em chamadas subsequentes.

Detalhes Técnicos

Runtime: Node.js 18+, módulos ES
Navegador: Playwright Chromium (headless)
Transporte: MCP stdio
Armazenamento de sessão: ~/.strider/amazon/

Limitações

Requer login manual (sem autenticação programática para a Amazon)
Desafios de CAPTCHA devem ser concluídos em um navegador real
O método de pagamento deve ser pré-configurado na sua conta da Amazon
Mudanças na interface da Amazon podem quebrar seletores DOM — relate problemas no GitHub
Não afiliado à Amazon.com, Inc.

Solução de Problemas

"CAPTCHA detectado" Visite amazon.com no seu navegador, complete o CAPTCHA e tente novamente.

"Não conectado" Execute amazon_login, abra a URL, faça login e depois execute amazon_status.

"Botão Adicionar ao Carrinho não encontrado" O item pode ser vendido por um vendedor terceirizado que exige seleção do vendedor, ou pode estar indisponível. Tente amazon_get_product primeiro para verificar a disponibilidade.

"Tempo de carregamento da página esgotado" Verifique sua conexão com a internet. As páginas da Amazon podem ser lentas no primeiro carregamento.

Desenvolvimento

git clone https://github.com/striderlabs/mcp-amazon
cd mcp-amazon
npm install
npx playwright install chromium
npm run build
npm start

Licença

MIT — veja LICENSE

Construído por Strider Labs