Strider Amazon

@striderlabs/mcp-amazon

Servidor MCP de Amazon de Strider Labs — brinda a los agentes de IA la capacidad de buscar productos, gestionar tu carrito, realizar pedidos y rastrear envíos en Amazon mediante automatización del navegador.

Características

• Búsqueda de productos — busca en Amazon con detalles completos de resultados (ASIN, precio, calificaciones, insignia Prime)
• Detalles del producto — obtén información completa del producto por ASIN o URL
• Gestión del carrito — añade artículos, consulta el carrito, vacía el carrito
• Realización de pedidos — previsualiza y realiza pedidos con seguridad de doble confirmación
• Seguimiento de pedidos — rastrea envíos con estado e información del transportista
• Historial de pedidos — recupera pedidos anteriores
• Estado Prime — verifica la membresía y los beneficios de Prime
• Gestión de direcciones — establece la dirección de entrega
• Persistencia de sesión — cookies guardadas en ~/.strider/amazon/ entre sesiones
• Modo sigiloso — retrasos aleatorios, rotación de user agent, enmascaramiento de webdriver para reducir la detección de bots

Instalación

npm install -g @striderlabs/mcp-amazon

# Install Playwright browsers (required)
npx playwright install chromium

Configuración del 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"]
    }
  }
}

Herramientas Disponibles

Herramienta	Descripción
amazon_status	Verifica el estado de inicio de sesión y la información de la sesión
amazon_login	Inicia el flujo de inicio de sesión (devuelve URL + instrucciones)
amazon_logout	Limpia la sesión y las cookies
amazon_search	Busca productos por palabra clave
amazon_get_product	Obtén detalles del producto por ASIN o URL
amazon_add_to_cart	Añade producto al carrito (ASIN, URL o consulta)
amazon_view_cart	Consulta el contenido del carrito y el subtotal
amazon_clear_cart	Elimina todos los artículos del carrito
amazon_preview_order	Previsualiza el pedido antes de realizarlo
amazon_place_order	Realiza el pedido (requiere confirm=true)
amazon_track_order	Rastrea el pedido por ID
amazon_get_orders	Obtén el historial de pedidos
amazon_prime_check	Verifica el estado de la membresía Prime
amazon_set_address	Establece la dirección de entrega

Ejemplos de Uso

Buscar y añadir al carrito

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 })

Realizar un pedido

Preview my order before placing
→ amazon_preview_order()

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

Rastrear un envío

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

Flujo de Autenticación

Amazon requiere inicio de sesión manual (los navegadores sin interfaz no pueden completar el flujo completo de autenticación de Amazon, incluida la 2FA):

1. Ejecuta amazon_login — devuelve https://www.amazon.com/ap/signin
2. Abre esa URL en tu navegador e inicia sesión con tus credenciales de Amazon
3. Completa cualquier autenticación de dos factores
4. Ejecuta amazon_status para verificar que la sesión se detecta
5. Las cookies se guardan en ~/.strider/amazon/cookies.json para futuras sesiones

Configuración

Los datos de sesión se almacenan en:

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

Para restablecer: ejecuta amazon_logout o elimina el directorio ~/.strider/amazon/.

Seguridad de Pedidos

amazon_place_order requiere confirm: true para realizar realmente un pedido:

• Sin confirm: true — devuelve una vista previa (igual que amazon_preview_order)
• Con confirm: true — realiza el pedido inmediatamente

Nunca establezcas confirm: true sin el consentimiento explícito del usuario.

Detección de Bots

Amazon tiene una detección de bots agresiva. Este servidor incluye:

• Retrasos aleatorios entre acciones (500–2000 ms)
• Rotación de user agent (Chrome/Safari en macOS/Windows)
• Enmascaramiento de la propiedad webdriver
• Suplantación de complementos/idioma del navegador
• Viewport y resolución de pantalla adecuados

Si recibes un error de CAPTCHA: visita amazon.com en tu navegador habitual, completa el CAPTCHA y vuelve a intentarlo. Las cookies se reutilizarán en llamadas posteriores.

Detalles Técnicos

• Runtime: Node.js 18+, ES modules
• Browser: Playwright Chromium (headless)
• Transport: MCP stdio
• Session storage: ~/.strider/amazon/

Limitaciones

• Requiere inicio de sesión manual (no hay autenticación programática para Amazon)
• Los desafíos CAPTCHA deben completarse en un navegador real
• El método de pago debe estar preconfigurado en tu cuenta de Amazon
• Los cambios en la interfaz de Amazon pueden romper los selectores DOM — reporta problemas en GitHub
• No está afiliado a Amazon.com, Inc.

Solución de Problemas

"CAPTCHA detectado" Visita amazon.com en tu navegador, completa el CAPTCHA y vuelve a intentarlo.

"No has iniciado sesión" Ejecuta amazon_login, abre la URL, inicia sesión y luego ejecuta amazon_status.

"Botón Añadir al carrito no encontrado" El artículo puede ser vendido por un vendedor externo que requiere selección de vendedor, o puede no estar disponible. Prueba amazon_get_product primero para verificar la disponibilidad.

"Tiempo de carga de página agotado" Verifica tu conexión a internet. Las páginas de Amazon pueden ser lentas en la primera carga.

Desarrollo

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

Licencia

MIT — consulta LICENSE

---

Creado por Strider Labs