E-Geier

E-Geier

[!WARNING] Dieses Projekt ist eingestellt (Oktober 2026). Die E-Control Austria hat auf Anfrage mitgeteilt, dass die Preisdaten laut Auslegung des zuständigen Ministeriums nur über www.spritpreisrechner.at veröffentlicht werden sollen und dass es für die Nutzung der Schnittstelle durch Dritte keine Genehmigung gibt. E-Geier wird deshalb nicht weiterentwickelt, die NuGet-Pakete sind als veraltet markiert. Bitte nutze den offiziellen Spritpreisrechner.

This project is discontinued (October 2026). E-Control Austria stated on request that, according to the responsible ministry, the price data is meant to be published only via www.spritpreisrechner.at and that third-party use of the interface is not approved. E-Geier is no longer developed and the NuGet packages are deprecated. Please use the official Spritpreisrechner.

[NuGet EGeier.Net] [NuGet EGeier.Mcp] [CI]

Wo tanke ich in der Nähe von Mödling am günstigsten Diesel? – E-Geier lässt deinen KI-Assistenten diese Frage beantworten.

E-Geier ist eine .NET-Bibliothek und ein lokaler MCP-Server für die öffentlichen APIs der E-Control Austria. Den Anfang macht der Spritpreisrechner; das Ladestellenverzeichnis für E-Autos soll folgen.

Warum „E-Geier“? Der Geier kreist geduldig über der Landschaft und stürzt sich dann zielsicher auf das günstigste Angebot. Das „E“ steht für Energie – Sprit heute, Strom morgen. Mit Bindestrich, bitte: Wir sind kein „Egeier“. 🦅⛽

[!IMPORTANT] Nicht mit der E-Control Austria verbunden. Alle Daten stammen aus der öffentlichen Spritpreisrechner-API. Keine Gewähr für Richtigkeit oder Aktualität.

Not affiliated with E-Control Austria. All data comes from the public Spritpreisrechner (fuel price calculator) API. No guarantee of accuracy or timeliness.

E-Geier ist ein Open-Source-Hobbyprojekt: kein gehosteter Dienst, keine Zugangsdaten, keine API-Schlüssel. Alles läuft auf deinem Rechner.

MCP-Server

Werkzeuge

Alle Werkzeuge lesen nur.

Kraftstoffe: diesel, super (Super 95) und cng (Erdgas). Deutsche und englische Bezeichnungen wie „Benzin“ oder „petrol“ funktionieren auch.

Installation

Voraussetzungen

.NET 10 SDK oder Runtime.

Einrichtung in Claude Desktop

Öffne Einstellungen → Entwickler → Konfiguration bearbeiten und ergänze claude_desktop_config.json:

Über NuGet (dnx ist ab dem .NET 10 SDK dabei):

{  "mcpServers": {    "e-geier": {      "command": "dnx",      "args": ["EGeier.Mcp", "--yes"]    }  }}

Alternativ als globales .NET-Tool:

dotnet tool install --global EGeier.Mcp

{  "mcpServers": {    "e-geier": {      "command": "e-geier-mcp"    }  }}

Aus dem Quellcode:

git clone https://github.com/haraldrohan/e-geier.gitcd e-geierdotnet build -c Release

{  "mcpServers": {    "e-geier": {      "command": "dotnet",      "args": ["run", "--project", "C:\\Pfad\\zu\\e-geier\\src\\EGeier.Mcp", "-c", "Release", "--no-build"]    }  }}

Danach Claude Desktop neu starten. Andere MCP-fähige Clients (VS Code, Claude Code, …) werden genauso mit einem stdio-Befehl eingerichtet, z. B. in Claude Code:

claude mcp add e-geier -- dnx EGeier.Mcp --yes

Konfiguration (optional)

Es ist nichts zu konfigurieren. Wer die Geocoding-Anfragen mit einer Kontaktadresse versehen will (von OpenStreetMap bei häufiger Nutzung empfohlen), setzt eine Umgebungsvariable:

"env": { "Nominatim__Email": "[email protected]" }

Mit Nominatim__BaseAddress lässt sich eine eigene Nominatim-Instanz verwenden.

Beispiel-Fragen

• „Wo tanke ich in der Nähe von Mödling am günstigsten Diesel?“
• „Was kostet Super in Graz gerade am wenigsten?“
• „Ich bin in der Mariahilfer Straße in Wien – welche Tankstelle hat jetzt noch offen und ist billig?“
• „Gibt es in Niederösterreich eine günstige CNG-Tankstelle?“
• „Vergleich die Dieselpreise in den Bezirken Mödling und Baden.“
• „Welche Bezirke gibt es in Tirol?“

Bibliothek

dotnet add package EGeier.Net

using EGeier;using EGeier.Geocoding;using EGeier.Sprit;
services.AddSpritClient();services.AddNominatimGeocoder();
// ...
var place = await geocoder.GeocodeAsync("Mödling");var stations = await sprit.SearchByLocationAsync(place!.Latitude, place.Longitude, FuelType.Diesel);
foreach (var station in stations.Where(s => s.Prices.Count > 0)){    Console.WriteLine($"{station.GetPrice(FuelType.Diesel):0.000} €  {station.Name}, {station.Location?.City} ({station.DistanceKm:0.0} km)");}

Ohne Dependency Injection geht es auch: new SpritClient(new HttpClient()).

Überblick:

• ISpritClient – SearchByLocationAsync, SearchByRegionAsync, GetRegionsAsync, GetAdministrativeUnitsAsync, PingAsync, GetMonitoringAsync
• FuelType – Diesel, Super95, Cng (keine Magic Strings)
• RegionResolver – findet zu „Bezirk Mödling“, „Graz“, „Perchtoldsdorf“ oder „2340“ den passenden Regionscode
• IGeocoder / NominatimGeocoder – austauschbar; die Nominatim-Implementierung ist auf Österreich beschränkt, hält max. 1 Anfrage pro Sekunde ein, sendet einen eigenen User-Agent und cacht Ergebnisse 24 Stunden
• SpritApiException – verständliche Fehlermeldungen, inkl. DuringNoonPriceUpdate

Gut zu wissen über die API

• Die Suche nach Koordinaten liefert bis zu 10 Tankstellen, Preise aber nur für die günstigsten (gesetzliche Vorgabe). Die Suche nach Region liefert die 5 günstigsten.
• Preiserhöhungen sind in Österreich nur um 12:00 Uhr erlaubt. Rund um diese Zeit ist die API oft ein paar Minuten nicht erreichbar; E-Geier meldet das mit einem entsprechenden Hinweis.
• DistanceKm ist Luftlinie in Kilometern und bei der Regionssuche immer 0.

Entwicklung

dotnet builddotnet test --project tests/EGeier.Tests                               # offline, mit aufgezeichneten API-AntwortenEGEIER_LIVE_TESTS=1 dotnet test --project tests/EGeier.IntegrationTests  # gegen die echte API

Ohne EGEIER_LIVE_TESTS=1 werden die Live-Tests übersprungen.

Datenschutz

E-Geier läuft auf deinem Rechner. Die Anfragen gehen direkt von dort an die unten genannten Dienste; der Autor erhält keine Daten.

• Was verarbeitet wird: nur die Angaben eines Werkzeug-Aufrufs, also Ort oder Adresse, Kraftstoff und Region. E-Geier erhält keine Chatverläufe, keine Konto- oder Profildaten.
• Weitergabe: Ort oder Adresse gehen an OpenStreetMap Nominatim, um Koordinaten zu ermitteln. Koordinaten bzw. Regionscode gehen an die Spritpreisrechner-API der E-Control Austria.
• Speicherung: Keine Datenbank, keine Cookies, kein Tracking. Geocoding-Ergebnisse werden bis zu 24 Stunden im Arbeitsspeicher zwischengespeichert; nach einem Neustart ist alles weg. E-Geier legt keine dauerhaften Protokolle an.
• Kontakt: GitHub Issues

Datenquellen und Lizenzen

• Spritpreise: Spritpreisrechner der E-Control Austria, öffentliche API
• Geocoding: OpenStreetMap Nominatim, Daten © OpenStreetMap-Mitwirkende, ODbL. Bitte die Nutzungsrichtlinie beachten.
• E-Geier selbst: MIT-Lizenz

Haftungsausschluss / Disclaimer

Deutsch: E-Geier ist nicht mit der E-Control Austria verbunden. Alle Daten stammen aus der öffentlichen Spritpreisrechner-API. Keine Gewähr für Richtigkeit oder Aktualität. Maßgeblich ist der an der Zapfsäule angezeigte Preis.

English: E-Geier is not affiliated with E-Control Austria. All data comes from the public Spritpreisrechner API. No guarantee of accuracy or timeliness. The price shown at the pump is what counts.