# maboto.de — Marktbeobachtungstool

> Lokales Marktbeobachtungstool für ortskonkrete, händlerübergreifende Übersicht der wöchentlichen Angebote nach Produktgruppen. LLM-kategorisiert mit OpenRouter, Open Source, gehostet auf minim4-2, erreichbar über https://maboto.de/.

Wöchentlicher Datenabruf von Marktguru + lokale Händler (Rewe, Edeka, Aldi, Lidl, Kaufland, Netto, Norma, Penny, dm, Rossmann, Müller, Budni, Action, Deichmann, H&M, Saturn, MediaMarkt, Thalia, Adler). Angebote werden in 11 Produktgruppen sortiert.

## API-Endpoints (alle POST, JSON-Body)

- [POST /api/rohdaten](https://maboto.de/api/rohdaten): Stufe 1 — Rohdaten holen für eine PLZ
- [POST /api/kategorisieren](https://maboto.de/api/kategorisieren): Stufe 2 — LLM-Kategorisierung (erfordert OpenRouter-Key im Body)
- [POST /api/korrektur](https://maboto.de/api/korrektur): Manuelle Korrektur einer Produktgruppe
- [GET  /api/lauf/{job_id}](https://maboto.de/api/lauf/test): Job-Status (Polling)
- [GET  /api/modelle?q=...](https://maboto.de/api/modelle): Liste verfügbarer OpenRouter-Modelle
- [GET  /api/rohdaten/{plz}](https://maboto.de/api/rohdaten/40721): gespeicherte Rohdaten einer PLZ (oder 404)
- [GET  /llms.txt](https://maboto.de/llms.txt): diese Datei

## Hinweise für KI-Agenten

- Alle Endpoints sind **public** ohne Login. OpenRouter-Key muss im Request-Body mitgeschickt werden.
- OpenRouter-Modelle: gratis- und paid-Modelle verfügbar (siehe `/api/modelle`).
- CORS: KEINE CORS-Header gesetzt. Frontend leitet via nginx-style-Reverse-Proxy.
- **WebMCP nicht implementiert** — interaktive Formulare werden nicht für Agenten exponiert.
- Daten werden lokal auf minim4-2 gecacht (`/Volumes/mini24www/lokalserver-data/`), 7-Tage-Rolling-Window.

## Tech-Stack

- FastAPI (Python 3.12) + Uvicorn
- OpenAI-kompatible API für LLM-Calls (über OpenRouter)
- Marktguru-HTML-Parser + Custom-Händler-Scraper
- File-basierte Persistenz (kein SQL)

## Verwandte Sites

- [Hauptblog](https://www.dillenberg.net/)
- [Entwickler-Spielwiese](https://dev.dillenberg.net/): 60+ Sub-Apps