Strider Labs Instacart MCP

Servidor MCP para Instacart: permite que agentes de IA ordenen comestibles y artículos del hogar de tiendas locales.

GitHub
10
Prueba este MCPPatrocinado

Documentación

@striderlabs/mcp-instacart

Pide comestibles a través de Instacart usando agentes de IA

npm MCP Registry Claude Desktop License: MIT

Parte de Strider Labs — ejecución de acciones para agentes de IA personales.

Comienza en 2 Minutos

Para Usuarios de Claude Desktop

  1. Añade esto a tu configuración de Claude Desktop:
{
  "mcpServers": {
    "instacart": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-instacart"]
    }
  }
}
  1. Reinicia Claude.
  2. Dile a Claude: "Pide mis comestibles habituales para entrega mañana por la mañana"

Tu agente ahora puede realizar pedidos. Eso es todo.

Instalación (NPM)

npm install @striderlabs/mcp-instacart

O directamente con npx:

npx @striderlabs/mcp-instacart

Características

  • 🛒 Buscar productos por nombre o categoría
  • 📦 Explorar tiendas y disponibilidad de productos
  • 🏪 Agregar al carrito con cantidades y solicitudes especiales
  • 💳 Realizar pedidos con selección de horario de entrega
  • 📍 Seguir pedidos con estado en tiempo real
  • 🔐 Sesiones persistentes - mantente conectado entre reinicios
  • 🔄 MFA automático - maneja la autenticación multifactor
  • 📱 Credenciales por usuario - almacenamiento de sesión cifrado
  • ⭐ Artículos guardados - ordena tus favoritos más rápido

Probado y Compatible

ComponenteVersiónEstado
MCP SDK^1.0.0✅
Node.js18+✅
Claude DesktopÚltima✅
Claude (API)claude-3.5-sonnet+✅
Anthropic SDK^0.20+✅

Métricas

  • Descargas semanales: 271 (10-17 abr 2026) — Mejor conector de comestibles (+330% de crecimiento)
  • Estado: ✅ En producción
  • Confiabilidad: Tasa de finalización de tareas del 85%+
  • Descubrimiento: npm, mcpservers.org, ClawHub, PulseMCP, Glama, LobeHub

Disponible en Otros Lugares

Cómo Funciona

Para Agentes

Tu agente puede usar estas capacidades:

// Search for products
products = search_products({
  query: "organic milk",
  location: "San Francisco, CA"
})

// Browse a store's offerings
store_products = get_store_products({
  store_id: "whole_foods_sf",
  category: "Dairy"
})

// Add to cart
add_to_cart({
  product_id: "organic_milk_gallon",
  quantity: 2,
  special_instructions: "Cold stock, please"
})

// Place an order
order = place_order({
  delivery_time: "tomorrow morning",
  delivery_address: "123 Main St, San Francisco, CA",
  special_instructions: "Ring the doorbell twice"
})

// Track delivery
status = track_order({ order_id: order.order_id })

Gestión de Sesiones

  • Cada usuario tiene credenciales persistentes cifradas
  • Refresco automático de tokens OAuth
  • Manejo de MFA (SMS/correo electrónico)
  • Las sesiones sobreviven reinicios de agentes

Confiabilidad

  • Tasa de finalización de tareas del 85%+
  • Detección automatizada de cambios en la interfaz (los conectores se actualizan cuando Instacart cambia)
  • Rutas de respaldo para fallos
  • Monitoreo 24/7 y alertas

Autenticación

El servidor MCP usa un perfil de navegador persistente (~/.strider/instacart/browser-profile) para que tu sesión de inicio de sesión sobreviva a reinicios del servidor automáticamente.

Primer inicio de sesión

  1. Configura INSTACART_HEADLESS=false en la configuración de tu servidor MCP para que la ventana del navegador sea visible:
{
  "mcpServers": {
    "instacart": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-instacart"],
      "env": { "INSTACART_HEADLESS": "false" }
    }
  }
}
  1. Reinicia Claude / tu cliente MCP.
  2. Pide a Claude que ejecute instacart_login — se abrirá una ventana real del navegador.
  3. Inicia sesión en Instacart dentro de esa ventana.
  4. Ejecuta instacart_status para confirmar la autenticación.
  5. Elimina INSTACART_HEADLESS (o restablécelo a true) y reinicia — el perfil guardado te mantiene conectado.

Cómo funciona la detección de inicio de sesión

La autenticación se verifica navegando a /account y confirmando que la página se resuelve sin una redirección a /login o /authentication (detección positiva). Esto es más confiable que verificar la ausencia de un botón "Iniciar sesión".

Configuración

Variables de Entorno

# Show browser window (required for first-time login)
INSTACART_HEADLESS=false   # default: true (headless)

Autoalojado

# Clone the repo
git clone https://github.com/striderlabsdev/mcp-instacart
cd mcp-instacart

# Install dependencies
npm install

# Start the server
npm start

# Your agent can now connect to localhost:3000

Arquitectura

Cómo Nos Conectamos

Este conector usa automatización de navegador (Playwright) para interactuar con Instacart, porque Instacart no tiene una API pública. He aquí por qué es seguro y confiable:

  • Controlado por el usuario: Tu agente solo accede a tu propia cuenta de Instacart
  • Basado en sesión: Almacenamos tu sesión de inicio de sesión de forma segura, no tu contraseña
  • Consciente de cambios: Detectamos cambios en la interfaz de Instacart y alertamos de inmediato
  • Huella digital: Usamos perfiles de navegador realistas para evitar la detección de bots
  • Limitado por tasa: Respetamos la infraestructura de Instacart con retrasos adecuados

Seguridad

  • Credenciales almacenadas cifradas en tu .env local o bóveda segura
  • Sesiones aisladas por usuario
  • No se envía datos a terceros
  • Licencia MIT — audita el código tú mismo

Soporte

Contribuciones

¡Aceptamos contribuciones! Áreas de interés:

  • Reportes de errores y correcciones
  • Solicitudes de funciones (nuevas tiendas, categorías, etc.)
  • Mejoras de rendimiento
  • Mejoras en la documentación

Consulta CONTRIBUTING.md para las pautas.

Licencia

MIT — Libre de usar, modificar y distribuir. Consulta LICENSE para más detalles.

Construido por Strider Labs — Haciendo que los agentes de IA sean realmente útiles.

GitHub | Sitio web | Discord