// Projekt

Mercedes-Snapshot

Der Fahrzeugzustand als Tagesprotokoll – ohne App

Python · asyncio · WebSocket · Protobuf

Open Source auf GitHub · Python 3.10+

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 --stream

Technik 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.