supermercados-mcp

Faz as compras do supermercado pelo Claude. Liga o Claude Code ao Continente, ao Pingo Doce e ao Auchan: ele procura os produtos, junta-os ao carrinho da tua conta, e tu só finalizas e pagas no site.

O que faz

Cada supermercado é um servidor à parte, por isso podes falar com um só ou com os três. Dizes ao Claude o que precisas, em linguagem normal: uma lista de compras, uma receita ou pedidos soltos. E ele:

• Compra no supermercado que disseres. Procura cada produto, escolhe o mais barato (pelo preço por quilo ou litro, para a quantidade de que precisas) e põe-no no carrinho da tua conta.

• Compara os três, se não disseres nenhum ou se pedires. Mostra o total do cesto em cada um e propõe onde fica mais barato.

• Pesquisa e gere o carrinho quando só queres ver preços, mudar quantidades, tirar coisas ou ver o que lá está.

O plugin nunca encomenda nem paga. A encomenda e o pagamento ficam sempre do teu lado, no site do supermercado.

Exemplos de pedidos:

• "Põe no meu carrinho do Auchan o que preciso para uma lasanha para 4."

• "Preciso de leite, ovos, arroz e frango. Onde fica mais barato?"

• "Compra isto no Continente: 2 leites meio gordos e 1 kg de arroz agulha."

• "O que tenho no carrinho do Pingo Doce?"

A skill comprar é a que diz ao Claude como fazer isto (escolher o mais barato, comparar, pedir confirmação antes de pôr no carrinho). Vem com o plugin.

Extras: skills opcionais

• perfil: uma entrevista curta, uma pergunta de cada vez, sobre o que tens na cozinha, as restrições e os teus gostos.

• receitas-semana: cria as refeições da semana a partir do perfil e junta tudo numa lista de compras, que podes depois mandar comprar.

Exemplo: "Somos dois homens adultos. Queremos 3 refeições por dia com vaca, frango e peixe, altas em proteína, baixas em gordura, com hidratos médios, e gastar no máximo 350 € por mês. Faz o plano e compra no supermercado mais barato."

Related MCP server: RappiMCP

Instalação no Windows 11

Precisas de:

• Claude Code instalado;

• Node.js 22.13 ou superior. Para ver a versão, abre o PowerShell e escreve node -v. Se for mais antiga, instala a versão LTS em https://nodejs.org.

Passos:

1. Abre o PowerShell e instala o navegador que o servidor do Continente usa. Só se faz uma vez (descarrega cerca de 110 MB):

   npx -y -p continente-mcp playwright install chromium

2. No Claude Code, adiciona o plugin:

   /plugin marketplace add vasco-branco06/supermercados-mcp
   /plugin install supermercados-mcp@supermercados-mcp

3. Fecha e volta a abrir o Claude Code.

4. Escreve /mcp. Deves ver três servidores: continente, pingo-doce e auchan. A primeira vez que cada um arranca demora um pouco, porque o npx descarrega o pacote.

5. Na primeira vez abre-se o Bloco de Notas com o ficheiro de credenciais. Preenche o email e a palavra-passe do Auchan e do Continente (e, se quiseres, o número do Pingo Doce) se quiseres usar o carrinho (podes deixar em branco e voltar mais tarde), guarda com Ctrl+S e fecha.

6. Começa por pedir, por exemplo: "Procura leite meio gordo no Auchan". Para o plano da semana, escreve "Faz o meu perfil".

A pesquisa de produtos funciona sem conta em nenhum dos três supermercados. Não precisas de instalar mais nada para o Pingo Doce e o Auchan.

Instalar só os servidores, sem o plugin

Se não queres o plugin, podes ligar os três servidores MCP diretamente ao teu cliente. Ficas sem as skills (comprar, perfil, receitas-semana) e sem o histórico, mas podes pedir ao Claude coisas como "procura leite meio gordo nos três supermercados e põe 2 no meu carrinho do Auchan". O login funciona da mesma forma.

Claude Code. No PowerShell, uma vez (o --scope user serve para todas as pastas):

claude mcp add --scope user pingo-doce -- cmd /c npx -y pingo-doce-mcp
claude mcp add --scope user auchan -- cmd /c npx -y auchan-mcp
claude mcp add --scope user continente -- cmd /c npx -y continente-mcp
npx -y -p continente-mcp playwright install chromium

O último comando descarrega o browser que o servidor do Continente usa (cerca de 110 MB) e só é preciso uma vez. Depois escreve claude mcp list: os três devem aparecer como "Connected". No macOS ou Linux, tira o cmd /c.

Claude Desktop e outros clientes MCP. Acrescenta este bloco ao ficheiro de configuração do cliente (no Claude Desktop, em Definições, Programador, Editar configuração, ou em %APPDATA%\Claude\claude_desktop_config.json) e reinicia-o:

{
  "mcpServers": {
    "continente": { "command": "npx", "args": ["-y", "continente-mcp"] },
    "pingo-doce": { "command": "npx", "args": ["-y", "pingo-doce-mcp"] },
    "auchan": { "command": "npx", "args": ["-y", "auchan-mcp"] }
  }
}

Precisas do Node.js 20.18.1 ou mais recente em qualquer dos casos. Testámos os comandos no Claude Code em Windows; o bloco de configuração segue o formato padrão dos clientes MCP.

Sem o plugin, o ficheiro de credenciais não se abre sozinho. Para o carrinho do Auchan, cria %USERPROFILE%\.auchan-mcp\credentials.env com as linhas AUCHAN_EMAIL=... e AUCHAN_PASSWORD=...; para o do Continente, %USERPROFILE%\.continente\credentials.env com CONTINENTE_EMAIL=... e CONTINENTE_PASSWORD=.... O Pingo Doce não usa ficheiro: pede-te o código no browser, quando for preciso.

Carrinho (opcional)

A pesquisa e a comparação de preços funcionam sem conta. Para o Claude pôr produtos no carrinho, o plugin entra na tua conta de cada supermercado:

• Auchan e Continente: na primeira vez que o plugin arranca, abre-se o Bloco de Notas com o ficheiro %USERPROFILE%\.supermercados-mcp\credentials.env já com as linhas AUCHAN_EMAIL, AUCHAN_PASSWORD, CONTINENTE_EMAIL e CONTINENTE_PASSWORD. Preenche as dos supermercados que usas, guarda com Ctrl+S e fecha. O plugin entra sozinho, em segundo plano, e volta a entrar sempre que o supermercado terminar a sessão, por isso não tens de fazer nada outra vez. Para abrir o ficheiro de novo, pede ao Claude "abre o ficheiro de credenciais" (skill credenciais).

• Pingo Doce: não tem palavra-passe. Entra-se com um código novo que chega por SMS ou por email, por isso não dá para entrar sozinho. Quando pedires o carrinho, o plugin abre a página de login do Pingo Doce no teu browser (o Edge ou o Chrome que já tens) e entras tu. Se escreveres o teu número no ficheiro (PINGODOCE_PHONE, 9 dígitos), a página abre já com o número preenchido e o código pedido, e só tens de escrever o código. A sessão fica guardada e dura enquanto o Pingo Doce a mantiver; quando expirar, o plugin abre a página de login outra vez.

No Auchan, o carrinho só aceita produtos depois de escolheres uma vez, no site, entrega em casa ou levantamento (com o código postal); essa escolha fica guardada na tua conta. O Auchan só deixa encomendar a partir de 20 €. Enquanto o Claude Code está aberto, o plugin faz um pedido leve de 10 em 10 minutos para o supermercado não fechar a sessão por inatividade. Se aparecer um CAPTCHA no login automático, o plugin pára e diz-te; não o contorna. Para desligar uma conta, pede ao Claude para terminar a sessão (ferramenta logout).

Não existe nenhuma ferramenta para finalizar a encomenda ou pagar.

Privacidade

Nada sai do teu computador, exceto os pedidos aos sites dos supermercados e a conversa com o Claude.

As palavras-passe ficam em texto simples nesse ficheiro, dentro da tua pasta de utilizador, como já acontecia no servidor do Continente. Não o partilhes, não o ponhas num backup público e não o mostres em capturas de ecrã. O ficheiro nunca é enviado para lado nenhum: só é lido para preencher o formulário de login do supermercado. O Pingo Doce não tem palavra-passe: só podes guardar o número de telemóvel, para a página de login vir preenchida.

Para apagar tudo, no PowerShell:

Remove-Item -Recurse -Force "$env:USERPROFILE\.supermercados-mcp", "$env:USERPROFILE\.pingodoce-mcp", "$env:USERPROFILE\.auchan-mcp", "$env:USERPROFILE\.continente"

As palavras-passe e as cookies nunca aparecem nas respostas das ferramentas nem nos registos.

Limites e avisos

• Este projeto não tem ligação ao Continente, ao Pingo Doce nem ao Auchan. Os nomes pertencem às respetivas empresas.

• Pode deixar de funcionar a qualquer momento se os sites mudarem. Quando a leitura falha, a ferramenta diz o que falhou e nunca inventa um preço.

• Os ficheiros robots.txt dos três sites pedem que as páginas de pesquisa não sejam lidas por programas automáticos. O projeto faz poucos pedidos (no máximo 1 por segundo a cada site), identifica-se com um user-agent próprio e guarda os resultados em cache durante 6 horas. Usa-o por tua conta e risco, para uso pessoal, e respeita os termos dos sites.

• A pesquisa não mostra a disponibilidade dos produtos. As promoções só aparecem no Pingo Doce. O Continente não indica a marca nem o tamanho.

• Confirma sempre o produto e o preço no site antes de comprar. As equivalências entre marcas e tamanhos que as skills sugerem são só sugestões.

Créditos

O servidor do Continente é o continente-mcp de David Marques (licença MIT), usado tal como ele o publica e sem alterações. Os servidores do Pingo Doce e do Auchan foram escritos de raiz neste repositório, com o dele como modelo para a estrutura de pastas, os nomes das ferramentas e a forma de guardar a sessão.

Para quem quer contribuir

• shared/ tem o schema dos produtos (zod) e o contrato comum dos servidores: shared/CONTRATO.md.

• servers/pingo-doce e servers/auchan são os dois servidores. Cada um tem os seus testes (npm test dentro da pasta), que correm sem internet sobre respostas guardadas.

• npm test na raiz corre os testes do contrato. npm run build:historico volta a gerar scripts/dist/historico.js.

• Notas do desenvolvimento em docs/desenvolvimento.

Licença

MIT