# 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
```bash
# 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`:
```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](https://checkjebon.nl) (dagelijks 07:00)
- **Aanbiedingen**: [Folderz.nl](https://folderz.nl) (2x per dag - supermarkten én drogisten)
- **Recepten**: [TheMealDB](https://themealdb.com) + 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
```bash
# 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
