Strider Labs Instacart MCP

@striderlabs/mcp-instacart

Peça mantimentos via Instacart usando agentes de IA

Parte do Strider Labs — execução de ações para agentes de IA pessoais.

Comece em 2 Minutos

Para Usuários do Claude Desktop

1. Adicione isto à sua configuração do Claude Desktop:

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

2. Reinicie o Claude.
3. Diga ao Claude: "Peça meus mantimentos de sempre para entrega amanhã de manhã"

Seu agente agora pode fazer pedidos. É isso.

---

Instalação (NPM)

npm install @striderlabs/mcp-instacart

Ou com npx diretamente:

npx @striderlabs/mcp-instacart

Recursos

• 🛒 Pesquise produtos por nome ou categoria
• 📦 Navegue pelas lojas e disponibilidade de produtos
• 🏪 Adicione ao carrinho com quantidades e pedidos especiais
• 💳 Faça pedidos com seleção de horário de entrega
• 📍 Acompanhe pedidos com status em tempo real
• 🔐 Sessões persistentes — mantenha-se conectado entre reinicializações
• 🔄 MFA automático — lida com autenticação multifator
• 📱 Credenciais por usuário — armazenamento de sessão criptografado
• ⭐ Itens salvos — peça seus favoritos mais rápido

Testado e Compatível

Componente	Versão	Status
MCP SDK	^1.0.0	✅
Node.js	18+	✅
Claude Desktop	Mais recente	✅
Claude (API)	claude-3.5-sonnet+	✅
Anthropic SDK	^0.20+	✅

Métricas

• Downloads semanais: 271 (10–17 de abril de 2026) — Principal conector de supermercado (+330% de crescimento)
• Status: ✅ Ativo em produção
• Confiabilidade: Taxa de conclusão de tarefas acima de 85%
• Descoberta: npm, mcpservers.org, ClawHub, PulseMCP, Glama, LobeHub

Disponível em Outros Lugares

• npm: npmjs.com/@striderlabs/mcp-instacart
• Claude Plugins: Pesquise "Strider Labs" no Claude
• mcpservers.org: Strider Labs Instacart
• Strider Labs completo: github.com/striderlabsdev/striderlabs

Como Funciona

Para Agentes

Seu agente pode usar estes recursos:

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

Gerenciamento de Sessão

• Cada usuário tem credenciais criptografadas e persistentes
• Atualização automática de token OAuth
• Tratamento de MFA (SMS/email)
• Sessões sobrevivem a reinicializações do agente

Confiabilidade

• Taxa de conclusão de tarefas acima de 85%
• Detecção automatizada de mudanças na interface (conectores são atualizados quando o Instacart muda)
• Caminhos alternativos para falhas
• Monitoramento 24/7 + alertas

Autenticação

O servidor MCP usa um perfil de navegador persistente (~/.strider/instacart/browser-profile) para que sua sessão de login sobreviva a reinicializações do servidor automaticamente.

Primeiro login

1. Defina INSTACART_HEADLESS=false na configuração do seu servidor MCP para que a janela do navegador fique visível:

{
  "mcpServers": {
    "instacart": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-instacart"],
      "env": { "INSTACART_HEADLESS": "false" }
    }
  }
}

2. Reinicie o Claude / seu cliente MCP.
3. Peça ao Claude para executar instacart_login — uma janela real do navegador será aberta.
4. Faça login no Instacart dentro dessa janela.
5. Execute instacart_status para confirmar a autenticação.
6. Remova INSTACART_HEADLESS (ou defina de volta para true) e reinicie — o perfil salvo mantém você conectado.

Como funciona a detecção de login

A autenticação é verificada navegando para /account e confirmando que a página resolve sem redirecionamento para /login ou /authentication (detecção positiva). Isso é mais confiável do que verificar a ausência de um botão "Entrar".

Configuração

Variáveis de Ambiente

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

Auto-hospedado

# 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

Arquitetura

Como Nos Conectamos

Este conector usa automação de navegador (Playwright) para interagir com o Instacart, porque o Instacart não tem uma API pública. Veja por que isso é seguro e confiável:

• Controlado pelo usuário: Seu agente acessa apenas sua própria conta do Instacart
• Baseado em sessão: Armazenamos sua sessão de login com segurança, não sua senha
• Ciente de mudanças: Detectamos mudanças na interface do Instacart e alertamos imediatamente
• Impressão digital: Usamos perfis de navegador realistas para evitar detecção de bots
• Limite de taxa: Respeitamos a infraestrutura do Instacart com atrasos apropriados

Segurança

• Credenciais armazenadas criptografadas no seu .env local ou cofre seguro
• Sessões isoladas por usuário
• Nenhum dado enviado a terceiros
• Licença MIT — audite o código você mesmo

Suporte

• 📖 Documentação Completa do Strider Labs
• 🐛 Reportar Problemas
• 💬 Discussões
• 🌐 Site
• 📧 Email

Contribuindo

Aceitamos contribuições! Áreas de interesse:

• Relatórios e correções de bugs
• Solicitações de recursos (novas lojas, categorias, etc.)
• Melhorias de desempenho
• Aprimoramentos de documentação

Veja CONTRIBUTING.md para diretrizes.

Licença

MIT — Livre para usar, modificar e distribuir. Veja LICENSE para detalhes.

---

Construído por Strider Labs — Tornando agentes de IA realmente úteis.

GitHub | Site | Discord