Eine HACS-kompatible Custom Integration, die deine HA-Einkaufslisten (Todo-Entitäten) mit dem Marktguru-Angebotsdienst verbindet und dir im Dashboard anzeigt, welche Artikel gerade wo im Angebot sind.
- 🛒 Liest Artikel aus einer oder mehreren HA-Einkaufslisten (Todo-Entitäten, z. B. Bring!, HomeAssistant Shopping List)
- 🏷️ Sucht automatisch nach aktuellen Angeboten per Marktguru-API
- 🏪 Konfigurierbarer Händler-Filter (Aldi, Lidl, Rewe, Edeka, Kaufland …)
- 📅 Zeigt Angebotszeitraum (von–bis) je Händler an
- 🔄 Automatische Aktualisierung (konfigurierbares Intervall, min. 5 Minuten)
▶️ Manuelle Suche per Service-Button im Dashboard- 🖼️ Custom Lovelace-Karte mit Kachel- und Listenansicht, Händler-Filter-Chips und Produktbildern
- 🔍 Lightbox: Produktbild per Klick vergrößern
- ✏️ Artikel direkt aus der Karte mit Angebotsinformationen ergänzen (z. B.
Butter → Butter (Lidl 0,99 €)) - ➡️ Artikel aus der Lightbox heraus auf eine andere Einkaufsliste verschieben
- ✅ Vollständiger Config Flow – keine
configuration.yaml-Änderungen nötig
- Auf den Button klicken – HACS öffnet sich direkt mit diesem Repository
- Herunterladen klicken → Home Assistant neu starten
Oder manuell als benutzerdefiniertes Repository:
- HACS öffnen → Integrationen → ⋮ → Benutzerdefiniertes Repository hinzufügen
- URL:
https://github.com/Noack1978/ha-angebote-checker· Typ: Integration - „Angebote Checker" installieren → Home Assistant neu starten
Den Ordner custom_components/angebote_checker/ in dein HA-Konfigurationsverzeichnis kopieren und HA neu starten.
- Einstellungen → Geräte & Dienste → Integration hinzufügen → „Angebote Checker"
- Konfigurieren:
- Name der Instanz
- Postleitzahl (5-stellig) – bestimmt die regionale Suche
- Einkaufslisten – alle Todo-Entitäten, die geprüft werden sollen
- Händler – optional einschränken; leer = alle Händler
- Aktualisierungsintervall in Minuten (5–1440)
Die Integration bringt eine eigene Lovelace-Karte mit, die nach der Installation automatisch im Dashboard-Editor unter „Angebote Checker" auswählbar ist.
type: custom:angebote-checker-card
entity: sensor.angebote_checker_angebote_checker
title: Angebote
max_height: 500
show_images: true
default_view: grid| Funktion | Beschreibung |
|---|---|
| Kachel-/Listenansicht | Umschalten über die Buttons oben rechts |
| Händler-Filter | Chips oberhalb der Angebote – Klick filtert nach Händler |
| Suchen-Button | Löst sofort eine neue API-Abfrage aus |
| Bild vergrößern | Klick auf ein Produktbild öffnet die Lightbox |
| Artikel ergänzen | In der Lightbox: benennt den Todo-Eintrag um (fügt Händler + Preis hinzu) |
| Liste verschieben | In der Lightbox: verschiebt den Artikel auf eine andere Todo-Liste |
service: angebote_checker.refreshLöst sofort eine neue Suche aus (z. B. per Dashboard-Button).
- 🐛 Fix: Umbenannte Artikel (z. B. „Butter (Lidl 0,99 €)") werden beim nächsten Angebots-Scan wieder korrekt gefunden – der Klammerinhalt mit Preis wird vor der Suche automatisch entfernt
- 🐛 Fix:
todo_lists-Attribut wurde bei erfolgreicher API-Abfrage nicht an den Sensor übergeben → Ergänzen und Verschieben schlugen immer fehl - 🐛 Fix: Nach dem Ergänzen eines Artikels wird
offer.itemin der Lightbox aktualisiert, damit ein anschließendes Verschieben den neuen Namen kennt
- 🔍 Lightbox: Produktbild per Klick vergrößerbar
- ✏️ Artikel aus der Lightbox heraus mit Angebotsinformationen ergänzen
- ➡️ Artikel direkt in der Karte auf eine andere Einkaufsliste verschieben
- 🐛 Fix: Datumsparser für
validityDates-API-Struktur korrigiert - 🐛 Fix: Syntaxfehler in JS-Karte behoben
- 🐛 Fix:
todo.get_items-Service-Verfügbarkeit wird jetzt vor Aufruf geprüft
- Erstveröffentlichung
- Custom Lovelace-Karte mit Kachel- und Listenansicht
- Händler-Filter, automatische Lovelace-Ressourcen-Registrierung
- Marktguru-API-Anbindung mit regionaler PLZ-Suche
Die Marktguru-API ist eine inoffizielle API ohne garantierte Stabilität. Die API-Keys sind in der App öffentlich und werden von vielen HA-Nutzern geteilt.
MIT License – © Noack1978