NL Supermarkt MCP Server

MCP (Model Context Protocol) server voor Nederlandse supermarkt én drogisterij prijsvergelijking, boodschappenplanning en budget tracking.

Features

Basis Functionaliteiten

• Producten zoeken - Zoek producten bij 12+ Nederlandse supermarkten én drogisterijen
• Prijsvergelijking - Vergelijk prijzen tussen supermarkten en drogisten
• Boodschappenlijst optimalisatie - Vind goedkoopste combinatie
• Folder aanbiedingen - Bekijk actuele aanbiedingen met promo types (1+1, 2e halve prijs, etc.)
• Drogisterij aanbiedingen - Bekijk aanbiedingen van Kruidvat, Etos, Trekpleister, etc.
• Recepten zoeken - Zoek recepten met dieetfilters (vegetarisch, vegan, glutenvrij)
• Weekmenu planning - Plan maaltijden met automatische boodschappenlijst

Nieuwe Features (v2.0)

1. Prijshistorie & Alerts

• prijshistorie - Bekijk prijsverloop, laagste prijs ooit, trends
• prijs_alert - Stel alerts in voor producten onder bepaalde prijs
• check_alerts - Check welke alerts nu een goede deal zijn

2. Slimme Boodschappenlijst

• bewaar_boodschappenlijst - Sla lijsten op voor hergebruik
• laad_boodschappenlijst - Laad lijst met actuele prijzen & aanbiedingen
• lijst_boodschappenlijsten - Overzicht opgeslagen lijsten
• wacht_met_kopen - Advies: nu kopen of wachten op aanbieding?

3. Winkel Routeplanner

• vind_winkels - Vind dichtstbijzijnde supermarkten
• plan_winkelroute - Optimale route langs meerdere winkels

4. Budget Tracking

• set_budget - Stel weekbudget in
• budget_check - Check of boodschappen binnen budget passen
• bespaar_tips - Persoonlijke bespaartips

5. Drogisterij Support

• lijst_drogisten - Toon alle drogisterijen met aanbiedingen
• bekijk_aanbiedingen - Bekijk aanbiedingen per categorie (haarverzorging, make-up, parfum, etc.)

Quick Start

# Clone repository
git clone https://github.com/Samvox1/nl-supermarkt-mcp.git
cd nl-supermarkt-mcp

# Start met Docker Compose
docker compose up -d

# Eerste data sync (duurt ~5 minuten)
docker compose run --rm scheduler python3 sync_folderz.py

Claude Desktop Configuratie

Voeg toe aan ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  mcpServers: {
    nl-supermarkt: {
      command: npx,
      args: [-y, mcp-remote, http://localhost:8000/sse, --allow-http]
    }
  }
}

Beschikbare Supermarkten

Code	Naam	Producten
ah	Albert Heijn	~15.000
jumbo	Jumbo	~17.000
lidl	Lidl	~16.000
aldi	Aldi	~1.600
plus	Plus	~14.000
dekamarkt	DekaMarkt	~10.000
dirk	Dirk	~7.000
vomar	Vomar	~900
hoogvliet	Hoogvliet	~7.000
spar	Spar	~7.700
picnic	Picnic	-
poiesz	Poiesz	~1.800

Beschikbare Drogisterijen

Code	Naam	Aanbiedingen
kruidvat	Kruidvat	✅
etos	Etos	✅
trekpleister	Trekpleister	✅
da	DA	✅
hollandbarrett	Holland & Barrett	✅
douglas	Douglas	✅
onlinedrogist	De Online Drogist	✅

Drogisterij Categorieën

• haarverzorging - shampoo, conditioner, haarverf
• mondverzorging - tandpasta, tandenborstel, mondwater
• lichaamsverzorging - deodorant, douchegel, scheermesjes
• huidverzorging - dagcrème, bodylotion, zonnebrand
• make-up - mascara, lippenstift, foundation
• parfum - parfum, eau de toilette
• gezondheid - vitamines, paracetamol, pleisters
• oogzorg - lenzen, lenzenvloeistof
• hygiene - maandverband, tampons

Voorbeeldgebruik

Weekplanning met budget

Plan boodschappen voor 4 dagen, 2 personen bij AH en Jumbo.
Budget max 80 euro, voorkeur voor pasta gerechten.

Drogisterij aanbiedingen

Toon aanbiedingen voor shampoo bij Kruidvat en Etos.

Prijsalert instellen

Stel een alert in voor Douwe Egberts koffie onder 6 euro.

Budget check

Check of melk, brood, kaas, eieren en boter binnen 15 euro budget past.

Data Bronnen

• Prijzen: Checkjebon.nl (dagelijks 07:00)
• Aanbiedingen: Folderz.nl (2x per dag - supermarkten én drogisten)
• Recepten: TheMealDB + eigen NL recepten

Automatische Sync (Cronjobs)

Sync	Schema	Beschrijving
sync_recepten.py	05:00	Recepten database
sync_folderz.py	06:30 & 14:30	Folder aanbiedingen (supermarkten + drogisten)
sync_prices.py	07:00 & 15:00	Productprijzen
detect_price_drops.py	08:00	Prijsdalingen detecteren

Environment Variables

Variable	Default	Beschrijving
DB_HOST	db	PostgreSQL host
DB_PORT	5432	PostgreSQL port
DB_NAME	supermarkt_db	Database naam
DB_USER	postgres	Database user
DB_PASSWORD	supermarkt123	Database wachtwoord

Development

# Lokaal draaien (zonder Docker)
pip install -r requirements.txt
python src/server_sse.py

# Logs bekijken
docker logs supermarkt-mcp
docker logs supermarkt-scheduler

License

MIT