// Projekt
Mercedes-Snapshot
Der Fahrzeugzustand als Tagesprotokoll – ohne App
Fahrzeugdaten ohne Umweg über die App
Mercedes-Snapshot ist ein eigenständiger Python-Client für die Mercedes me Connect API. Er meldet sich per OAuth2 mit PKCE an, öffnet die WebSocket-Verbindung, über die auch die offizielle App ihre Daten bekommt, und liest den aktuellen Zustand des Fahrzeugs.
Das Ergebnis landet in einem gut lesbaren Tagesprotokoll mit einer Übersicht vorneweg: Batteriezustand, Kilometerstand, Tank, Reichweite, Türen und Position samt Google-Maps-Link.
Grundlage ist das Reverse Engineering der Home-Assistant-Integration mbapi2020 von ReneNulschDE (MIT) – Anmeldeablauf, WebSocket-Header und Protobuf-Definitionen stammen von dort.
Wofür man es nutzt
- ·Tägliches Fahrzeug-Logbuch: Kilometerstand, Tank, AdBlue, Reichweite, Service-Intervall
- ·Standort finden und teilen – „Wo steht das Wohnmobil?“
- ·Starterbatterie im Blick, bevor das Fahrzeug über den Winter steht
- ·Türen, Fenster, Schiebedach und Verriegelung auf einen Blick
- ·Reifendruck und Warnungen für Bremse, Kühlmittel, Motor und AdBlue
- ·Live-Mitschnitt der Push-Updates, etwa beim Bewegen des Fahrzeugs
- ·Ohne gesetzte Fahrgestellnummer werden alle Fahrzeuge des Kontos erfasst
Bedienung
Ein Aufruf liest den Zustand und schreibt das Protokoll. Mit --stream bleibt die Verbindung offen und gibt jede Änderung sofort aus. Als Cron-Job entsteht so ein laufendes Archiv.
pip install aiohttp websockets protobuf
# Zustand lesen und yyyy-mm-dd.log schreiben
python mercedes_me.py
# Live-Updates mitschreiben, Ctrl+C beendet
python mercedes_me.py --streamTechnik und Grenzen
- ·Python mit asyncio, aiohttp und websockets
- ·Protobuf für die Nachrichten auf dem WebSocket
- ·Token wird zwischengespeichert und automatisch erneuert
- ·Zugangsdaten aus Datei, Umgebungsvariablen oder interaktiver Eingabe – nie im Repository
- ·Die Starterbatterie meldet die API nur als Ampel, nicht in Volt
- ·Nur eine WebSocket-Verbindung pro Konto; zu viele Neuverbindungen sperrt Mercedes bis Mitternacht UTC
Keine offizielle Mercedes-Benz-Software, Nutzung auf eigene Verantwortung. Token und Protokolle enthalten Fahrgestellnummer, Kennzeichen und Position und bleiben per .gitignore außerhalb von Git.