NLACE-COM GitHub avatar

mcp-supermercados-cl

NLACE-COM

An MCP server for searching products, comparing prices, and building shopping lists across five major Chilean supermarkets, designed to run locally via stdio.

Stars

55

7-day growth

No data

Forks

13

Open issues

1

License

MIT

Last updated

2026-07-20

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It is a local-first, privacy-preserving tool that integrates deeply with individual supermarket chains (including club prices, frequent items, and cart), handles antibot measures with a Playwright bridge, and provides actionable errors and guided prompts.

Who it is for

  • Chilean consumers who shop at Jumbo, Santa Isabel, Unimarc, Tottus, or Lider and want to compare prices and build lists via AI assistants
  • Developers building MCP-based tools or integrations for grocery shopping in Chile
  • Data enthusiasts interested in price tracking and offer discovery across supermarket chains

Use cases

  • Search for a product across multiple chains and compare its unit price to find the best deal
  • Build a shopping list from natural language, prioritizing frequent purchases, offers, and budget constraints
  • View and add items to your Jumbo cart directly from an AI assistant, including club/socio prices
  • Discover and compare total cart costs across chains with a single command

Strengths

  • Covers all five major Chilean chains with deep features (club prices, frequent items, cart) for Jumbo and Santa Isabel
  • 100% local execution: no central server, traffic comes from user's IP, credentials never leave the browser
  • Handles antibot protections for Unimarc, Tottus, and Lider via an optional Playwright bridge using the user's own browser profile
  • Includes 160+ passing contract tests, live smoke tests, and a session smoke test to catch API changes early

Considerations

  • Requires Node.js 20+ and must be run locally (no cloud deployment possible due to IP restrictions and antibot measures)
  • Full session features (cart, frequent purchases, saved lists) currently only available for Jumbo/Santa Isabel; other chains lack this depth
  • Setting up automatic session handling for some chains requires installing Playwright and configuring a dedicated Chrome profile

README quick start

🛒 mcp-supermercados-cl

Servidor MCP para buscar productos, comparar precios y armar la mejor lista de compra en supermercados chilenos con Claude, ChatGPT u otro cliente MCP.

El foco es profundidad en la cadena donde tú ya compras — precios club, beneficios por RUT, productos frecuentes, carro — con la comparación entre cadenas como capacidad secundaria. Cubre las cinco grandes cadenas del país.

100 % local: el tráfico sale de tu máquina, a ritmo humano, y tus credenciales nunca tocan un servidor central.


Tabla de contenidos


🚫 ¿Se deploya en Vercel/AWS? No

Este MCP no tiene URL de producción y no se deploya en ningún servidor. Es intencional, y es la razón por la que funciona:

  • Usa transporte stdio (local), no HTTP. Corre en tu máquina, junto a tu cliente MCP (Claude Desktop, Claude Code, Cursor, ChatGPT Desktop).
  • Unimarc, Tottus y Lider bloquean el tráfico de datacenter (antibots). Un deploy en la nube no funcionaría para esas cadenas: necesitan tu IP residencial.
  • El precio socio, tus frecuentes y el carro viven en tu navegador logueado. Las credenciales no deben tocar un servidor central — eso además evita el mayor riesgo legal (un servicio que scrapee cuentas ajenas).

La forma de "producción" de un MCP como este es instalarlo local (vía npx o clonando el repo) y conectarlo a tu cliente. Igual que la mayoría de los MCP servers.


📦 Instalación

Requiere Node.js ≥ 20. Publicado en npm: mcp-supermercados-cl.

Opción 1 — vía npx (recomendada). No instalas nada; tu cliente MCP lo ejecuta al vuelo. En Claude Desktop / Claude Code (claude_desktop_config.json o .mcp.json):

{
  "mcpServers": {
    "supermercados": {
      "command": "npx"

Description

Servidor MCP para buscar productos, comparar precios y armar la mejor lista de compra en supermercados chilenos (Jumbo, Santa Isabel, Unimarc, Tottus, Lider) desde Claude o ChatGPT. 100% local.

Related repositories

Similar projects matched by category, topics, and programming language.

0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
OneInterface
Featured
OneInterface GitHub avatar

stormy-cookbook

Stormy Cookbook provides copy-pasteable recipes for using the Stormy Social Data API and MCP server, which offers a unified REST API and MCP tools to search profiles, posts, and emails across TikTok, YouTube, Instagram, LinkedIn, X, and Reddit through a single HTTP contract.

AI & Machine LearningLarge Language Models
72
TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861