Frank Energie Smart-Home-Integration, kostenlos und Open Source
Dynamische Strom- und Gaspreise von Frank Energie (Niederlande), für heute und morgen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Die dynamischen Strom- und Gaspreise von Frank Energie, dem niederländischen Anbieter, in Gladys: der Preis der aktuellen Stunde, die günstigsten Stunden des Tages, ein Preisdiagramm für heute und morgen und Szenen-Auslöser, damit deine Geräte laufen, wenn der Strom am günstigsten ist.
Diese Integration ist nicht mit Frank Energie verbunden. Die Integration liest die öffentlichen Preise von Frank Energie, gegen die echte API getestet, wurde aber ohne Frank-Energie-Vertrag entwickelt: Rückmeldungen sind willkommen.
Überblick
Frank Energie veröffentlicht, ohne Konto und ohne Schlüssel:
- die stündlichen Strompreise des niederländischen Day-Ahead-Markts (EPEX, Zone NL), als Börsenpreis oder als Endpreis, den ein Frank-Energie-Kunde pro kWh zahlt (Börsenpreis, Einkaufsaufschlag und Energiesteuer), mit oder ohne MwSt.;
- den Gaspreis des Gastags, gültig von 6 bis 6 Uhr, auf dieselbe Weise.
Die Preise für morgen werden zwischen 13 und 15 Uhr veröffentlicht. Der Endpreis ist der Preis pro Einheit: Die festen Monatskosten und die jährliche Steuerermäßigung deines Vertrags sind nicht enthalten.
Dein Frank-Energie-Konto (persönliche Preise, Verbrauch, Kosten, intelligentes Laden) wird nicht verwendet: Diese Version liest nur die öffentlichen Preise.
Alle Uhrzeiten sind Amsterdamer Zeit, und ein Tag geht in Amsterdam von Mitternacht bis Mitternacht, egal in welcher Zeitzone dein Gladys läuft.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer.
- Internetzugang von Gladys zu
graphql.frankenergie.nl. - Sonst nichts: kein Konto, kein API-Schlüssel, keine Hardware.
Installation
- Öffne in Gladys Integrationen → Von GitHub installieren und gib
https://github.com/guim31/gladys-frank-energieein. - Öffne die Integration, prüfe die Konfiguration, speichere.
- Öffne den Tab Entdecken und füge das Gerät Frank Energie hinzu.
- Füge auf einem Dashboard das Widget Strompreise hinzu.
Konfiguration
| Feld | Standard | Wirkung |
|---|---|---|
| Strompreis | Endpreis | Endpreis pro Einheit oder nur der EPEX-Day-Ahead-Börsenpreis |
| MwSt. einbeziehen | Ja | Preise mit der niederländischen MwSt. (21 %) |
| Gaspreis | Ja | Auch den Gaspreis des Tages zeigen; eine Änderung fügt eine Funktion hinzu oder entfernt sie |
| Sprache der Funktionsnamen | Französisch | Wird beim Hinzufügen des Geräts verwendet: Die Namen ändern sich danach nicht mehr |
Die Schaltfläche Preise jetzt abrufen fragt Frank Energie sofort ab und zeigt, was für heute und morgen veröffentlicht ist: praktisch, um die Verbindung zu prüfen.
Das Gerät Frank Energie
Ein einziges Gerät, nur lesbar, von der Integration selbst jede Minute aktualisiert (die Preise werden einmal pro Stunde bei Frank Energie abgerufen).
| Funktion | Typ | Wert |
|---|---|---|
| Aktueller Strompreis (€/kWh) | Preis | Preis der aktuellen Stunde |
| Preis nächste Stunde (€/kWh) | Preis | Preis der nächsten Stunde (nach 23 Uhr, sobald morgen bekannt ist) |
| Durchschnittspreis heute (€/kWh) | Preis | Durchschnitt der Stunden des Tages |
| Tiefstpreis heute (€/kWh) | Preis | Günstigste Stunde des Tages |
| Höchstpreis heute (€/kWh) | Preis | Teuerste Stunde des Tages |
| Günstigste Stunde heute | Text | Beginn der günstigsten Stunde, HH:MM |
| Teuerste Stunde heute | Text | Beginn der teuersten Stunde, HH:MM |
| Rang der Stunde (1 = günstigste) | Zähler | Rang der aktuellen Stunde am Tag, 1 bis 24 (23 oder 25 bei der Zeitumstellung) |
| Gaspreis heute (€/m³) | Preis | Gaspreis des Gastags (6 bis 6 Uhr), wenn aktiviert |
Gladys kennt keine Einheit €/kWh: Die Preise erscheinen in Euro, der Name sagt, wofür. Ist eine Funktion die einzige ihres Typs am Gerät, zeigt das Dashboard statt ihres Namens die allgemeine Bezeichnung des Typs („Zähler“).
Dashboard-Widget
Strompreise zeigt die Preisart, drei Kacheln (jetzt, nächste Stunde, Durchschnitt heute), das Diagramm von heute und morgen mit der günstigsten und der teuersten Stunde jedes Tages und einer Linie zur aktuellen Uhrzeit, danach die günstigste Stunde von heute und morgen, den Durchschnitt von morgen und den Gaspreis. Solange die Preise für morgen fehlen, steht dort, dass sie noch nicht veröffentlicht sind.
Szenen-Auslöser
Zwei Auslöser, im Szenen-Editor unter Frank Energie. Beide betreffen den Strom und die Stunden des aktuellen Tages (Mitternacht bis Mitternacht).
Die günstigsten Stunden des Tages beginnen
Löst einmal am Tag aus, zu Beginn des günstigsten Blocks aufeinanderfolgender Stunden. Wähle die Länge des Blocks: 1 bis 6 oder 8 Stunden (1 Stunde ist die günstigste Stunde des Tages). Variablen: Durchschnittspreis des Blocks, Beginn und Ende.
Eine der günstigsten Stunden beginnt
Löst zu Beginn jeder der N günstigsten Stunden des Tages aus, ob am Stück oder nicht. Wähle N: 1 bis 6, 8, 10 oder 12. Variablen: Preis der Stunde, ihr Rang, Beginn und Ende.
Die Auslöser kommen, wenn die Stunde beginnt, höchstens 10 Minuten zu spät (Neustart von Gladys oder der Integration): Eine Stunde, die schon länger läuft, löst nichts aus. „Der Preis fällt unter X“ ist kein Auslöser: Nutze die Funktion Aktueller Strompreis mit der Schwellenwert-Bedingung des Szenen-Editors.
Szenen-Beispiele
- Spülmaschine in den günstigsten 3 Stunden: Auslöser Die günstigsten Stunden des Tages beginnen, 3 Stunden → Steckdose der Spülmaschine einschalten.
- Warmwasserboiler in den 4 günstigsten Stunden: Auslöser Eine der günstigsten Stunden beginnt, 4 → Boiler einschalten; eine zweite Szene auf Rang der Stunde größer als 4 → ausschalten.
- Negativer Preis: wenn Aktueller Strompreis (Börsenpreis) unter 0 fällt → Boiler einschalten und Nachricht senden „Strom ist gerade gratis“.
Aktualisierung und API-Nutzung
Frank Energie veröffentlicht kein Kontingent für diese öffentliche API. Die Integration nutzt sie sparsam:
- zwei Anfragen pro Stunde, eine für heute und eine für morgen, jede liefert die Strom- und Gaspreise des Tages;
- ab 13 Uhr beide alle 15 Minuten erneut, bis die Preise für morgen veröffentlicht sind, danach wieder stündlich;
- nach einem Fehler neuer Versuch nach 5, 10, 20, 40 und dann 60 Minuten; die zuletzt bekannten Preise bleiben so lange in Gebrauch (die Preise sind einen Tag im Voraus bekannt).
Die Zustände werden nur bei einer Änderung veröffentlicht, dazu eine Erinnerung alle 6 Stunden.
Fehlerbehebung
- „Frank Energie ist nicht erreichbar“ in der Konfiguration: Gladys hat keinen Internetzugang, oder Frank Energie ist gestört. Die zuletzt bekannten Preise bleiben in Gebrauch; drücke Preise jetzt abrufen, um es erneut zu versuchen.
- „veröffentlicht aber keinen Strompreis für heute“: Frank Energie hat ohne Preis für den Tag geantwortet, das passiert bei einer Veröffentlichungsstörung. Die Integration versucht es alle 15 Minuten erneut.
- Kein Wert am Gerät: Füge das Gerät zuerst über den Tab „Entdecken“ hinzu; seine Werte kommen sofort.
- Die Gas-Funktion fehlt oder bleibt: Öffne nach einer Änderung der Gas-Einstellung den Tab „Entdecken“ und drücke beim Gerät auf Aktualisieren.
- Ausführliche Protokolle: Setze
LOG_LEVEL=debugam Container, um jeden Abruf zu sehen.
Einschränkungen
- Stundenpreise. Der niederländische Day-Ahead-Markt handelt seit Oktober 2025 in Viertelstunden, und Frank Energie kann sie veröffentlichen: Diese Version zeigt die Stundenpreise (den Durchschnitt der vier Viertelstunden).
- Nur die öffentlichen Preise: keine Anmeldung, also keine persönlichen Preise, kein Verbrauch, keine Kosten, kein intelligentes Laden.
- Der Endpreis ohne MwSt. wird aus den Bestandteilen berechnet, die Frank Energie veröffentlicht, mit der niederländischen MwSt. von 21 %.
- Die Auslöser betrachten nur den aktuellen Tag: Ein günstigster Block geht nie über Mitternacht.
- Nur lesend: Die Integration steuert selbst nichts.
- Die Funktionsnamen werden beim Hinzufügen des Geräts festgelegt; eine spätere Änderung der Sprache benennt sie nicht um.
Vergleich mit EnergyZero
Diese Integration folgt der EnergyZero-Integration desselben Autors: dasselbe Gerät, dasselbe Widget, dieselben Auslöser, sodass eine Szene von der einen zur anderen wechseln kann. Beide lesen denselben niederländischen Day-Ahead-Markt; die Endpreise unterscheiden sich durch den Aufschlag jedes Anbieters. Nimm die deines Anbieters.
Konfigurationseinstellungen
Diese Einstellungen fragt Frank Energie in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Energiepreise in den Niederlanden | section | Nein | Frank Energie veröffentlicht die stündlichen Strompreise des niederländischen Day-Ahead-Markts und seine Gaspreise, lesbar ohne Konto. Die Preise für morgen kommen zwischen 13 und 15 Uhr. Füge das Gerät Frank Energie über den Tab „Entdecken“ hinzu und das Preis-Widget über das Dashboard. Dein Kundenkonto (persönliche Preise, Verbrauch) wird nicht verwendet. Nicht mit Frank Energie verbunden. |
| Strompreis | select | Nein | Endpreis: was ein Frank-Energie-Kunde pro Einheit zahlt (Börsenpreis, Einkaufsaufschlag und Energiesteuer). Börse: nur der EPEX-Day-Ahead-Preis der niederländischen Zone. |
| MwSt. einbeziehen | boolean | Nein | Preise mit der niederländischen MwSt. (21 %). |
| Gaspreis | boolean | Nein | Auch den Gaspreis des Tages lesen (€/m³, von 6 bis 6 Uhr). Eine Änderung fügt eine Funktion hinzu oder entfernt sie: Aktualisiere das Gerät im Tab „Entdecken“. |
| Sprache der Funktionsnamen | select | Nein | Wird beim Hinzufügen des Geräts zu Gladys verwendet: Die Namen ändern sich danach nicht mehr. |
So installierst du Frank Energie in Gladys
- Öffne in Gladys Integrationen: Frank Energie erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-frank-energie:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-frank-energie.
Frank Energie benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Frank Energie ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation