Skip to content

About

Skill para Claude Code que automatiza compras no iFood via browser

Resources

Stars

29 stars

Watchers

1 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

╔══════════════════════════════════════════════════════════════════╗
║                                                                  ║
║    🛒  A S S I S T E N T E   D E   C O M P R A S                 ║
║    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━                     ║
║    Mercado Online • Claude Skill • Open Source                   ║
║                                                                  ║
║    >> Compara preços entre lojas automaticamente                 ║
║    >> Lembra suas marcas e preferências                          ║
║    >> Substituições inteligentes quando falta um produto         ║
║    >> Monta o carrinho inteiro — você só confere e paga          ║
║                                                                  ║
║    $                                                             ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

Claude Cowork Skill — Automação inteligente de compras de supermercado via iFood Mercado e Prezunic, com memória de preferências, substituições automáticas e comparação de preços entre lojas.


O que é

Um skill para o Claude Cowork que transforma o processo de fazer mercado online em algo rápido e inteligente. Em vez de navegar manualmente pelo iFood, você descreve o que precisa e o assistente monta o carrinho, compara preços, sugere substituições e aprende com suas preferências ao longo do tempo.

Capacidades principais:

  • Carrinho recorrente — repete compras anteriores respeitando marcas e quantidades preferidas
  • Substituições inteligentes — quando um item não está disponível, sugere alternativas com trade-offs claros (preço, marca, tamanho)
  • Busca progressiva — tenta variações do termo antes de declarar um item indisponível
  • Seleção híbrida de mercado — compara lojas na primeira compra, lembra a preferência, recompara periodicamente
  • Controle de orçamento — acompanha o subtotal + taxa de entrega em relação à meta semanal
  • Monitoramento de pedido mínimo — avisa quando o carrinho está abaixo do mínimo da loja
  • Listas por contexto — café da manhã, marmitas, churrasco, limpeza, bebê, pet
  • Planejamento semanal — cardápio de 7 dias convertido em lista de compras

Nunca finaliza o pagamento — o assistente monta o carrinho e confirma com você, mas o checkout é sempre feito por você.


Requisitos


Instalação

Opção A — npx (recomendada)

npx skills add fabianocruz/assistente-compras-ifood --skill assistente-compras-ifood

Para instalar globalmente:

npx skills add fabianocruz/assistente-compras-ifood --skill assistente-compras-ifood -g

Opção B — Manual

git clone https://github.com/fabianocruz/assistente-compras-ifood.git
cp -r assistente-compras-ifood/skills/assistente-compras-ifood ~/.claude/skills/

Opção C — Arquivo .skill

  1. Baixe assistente-compras-ifood.skill da seção Releases
  2. No Cowork, abra as configurações de Skills e importe o arquivo

Primeiro Uso (Onboarding)

Na primeira sessão, o assistente vai pedir até 6 informações para criar seu perfil:

  1. Endereço de entrega — rua, número, bairro, cidade, CEP
  2. Moradores — quantas pessoas, tem bebê ou pet?
  3. Prioridade — economia, equilíbrio ou qualidade?
  4. Restrições alimentares — alergias, dieta especial?
  5. Marcas preferidas — tem marcas que sempre compra ou evita?
  6. Orçamento semanal — quer definir uma meta? (opcional)

Esses dados são salvos em user_state.json no seu workspace, nunca na skill em si. Você controla e pode editar o arquivo a qualquer momento.


Uso

Com o skill instalado, basta conversar naturalmente no Cowork:

"Quero fazer mercado"
"Repete a última compra"
"Monta um carrinho para churrasco de 10 pessoas"
"Planeja as refeições da semana"
"Qual mercado tem o melhor preço pra minha lista?"
"Me avisa quando o café cair abaixo de R$ 18"

Estrutura do Projeto

assistente-compras-ifood/
├── assistente-compras-ifood.skill      # Skill empacotada (instalável)
├── README.md
├── LICENSE
└── skills/
    └── assistente-compras-ifood/       # Código-fonte da skill
        ├── SKILL.md                    # Documento principal (instruções para o Claude)
        ├── references/
        │   ├── user_state_schema.md    # Schema completo do JSON de memória
        │   ├── substitution_rules.md   # Regras de substituição por categoria
        │   ├── browser_patterns.md     # Padrões de automação (iFood e Prezunic)
        │   └── user_state.json         # Template vazio para novos usuários
        ├── scripts/
        │   ├── init_user_state.py      # Cria user_state.json para novo usuário
        │   ├── update_user_state.py    # Atualiza histórico de forma segura
        │   └── normalize_price.py      # Normalização de preços (R$/kg, R$/L)
        └── evals/
            └── evals.json              # Casos de teste para validação

Dados Pessoais e Privacidade

O skill não armazena dados pessoais internamente. Todo o histórico, preferências e endereço ficam no arquivo user_state.json no seu workspace local — que só você acessa. Para compartilhar ou fazer backup, basta copiar esse arquivo.

O user_state.json incluído neste repositório é um template vazio, sem dados de nenhum usuário.


Contribuindo

Pull requests são bem-vindos! Algumas ideias de contribuição:

  • Suporte a novas plataformas (Carrefour, Extra, Rappi Mercado)
  • Novas categorias de substituição em substitution_rules.md
  • Novos casos de teste em evals/evals.json
  • Tradução do skill para outros idiomas

Licença

MIT — veja LICENSE para detalhes.

About

Skill para Claude Code que automatiza compras no iFood via browser

Resources

Stars

29 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages