README.md
Compare prices, track budgets, and find deals across Dutch supermarkets.
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, trendsprijs_alert- Stel alerts in voor producten onder bepaalde prijscheck_alerts- Check welke alerts nu een goede deal zijn
2. Slimme Boodschappenlijst
bewaar_boodschappenlijst- Sla lijsten op voor hergebruiklaad_boodschappenlijst- Laad lijst met actuele prijzen & aanbiedingenlijst_boodschappenlijsten- Overzicht opgeslagen lijstenwacht_met_kopen- Advies: nu kopen of wachten op aanbieding?
3. Winkel Routeplanner
vind_winkels- Vind dichtstbijzijnde supermarktenplan_winkelroute- Optimale route langs meerdere winkels
4. Budget Tracking
set_budget- Stel weekbudget inbudget_check- Check of boodschappen binnen budget passenbespaar_tips- Persoonlijke bespaartips
5. Drogisterij Support
lijst_drogisten- Toon alle drogisterijen met aanbiedingenbekijk_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
# Lok
Tools (8)
prijshistorieView price history, lowest price ever, and trends for a product.prijs_alertSet alerts for products falling below a specific price.bewaar_boodschappenlijstSave shopping lists for future reuse.laad_boodschappenlijstLoad a saved list with current prices and deals.vind_winkelsFind the nearest supermarkets.plan_winkelrouteCalculate the optimal route visiting multiple stores.set_budgetSet a weekly spending budget.budget_checkCheck if a shopping list fits within the set budget.Environment Variables
DB_HOSTPostgreSQL hostDB_PORTPostgreSQL portDB_NAMEDatabase nameDB_USERDatabase userDB_PASSWORDDatabase passwordConfiguration
claude_desktop_config.json
{"mcpServers": {"nl-supermarkt": {"command": "npx", "args": ["-y", "mcp-remote", "http://localhost:8000/sse", "--allow-http"]}}}Try it
→Plan a meal for 4 days for 2 people at Albert Heijn and Jumbo with a maximum budget of 80 euros, focusing on pasta dishes.
→Show me current shampoo deals at Kruidvat and Etos.
→Set a price alert for Douwe Egberts coffee when it drops below 6 euros.
→Check if my shopping list of milk, bread, cheese, eggs, and butter fits within a 15 euro budget.