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