geizhals-mcp

Ein MCP-Server, der es einer KI ermöglicht, die Preisvergleichsdaten von Geizhals zu durchsuchen: Produkte, Bestpreise, Preishistorie, Bewertungen und Kategorien. Er kapselt die API der Geizhals-Mobil-App (api.geizhals.net/gh/v9) und gibt der KI die wichtigen Felder zurück.

Highlights

• Bester Preis in allen Shops
  Finde ein Produkt und erhalte dessen Bestpreis, die komplette Preisspanne, Sternebewertungen und die Anzahl der Testberichte – aggregiert über alle Geizhals-Händler statt über ein einzelnes Angebot.

• Wissen, wann man kaufen sollte
  Rufe den vollständigen Preisverlauf und die aktuellen Preisstürze (Schnäppchen) ab, sortierbar nach dem prozentual größten Nachlass – so kann ein Modell beantworten: „Ist das gerade günstig oder sollte ich warten?“

• Vom Stichwort zur Kategorie
  Suche per Freitext oder navigiere durch den kompletten Geizhals-Kategoriebaum (über 2200 Kategorien, die mit dem Server mitgeliefert werden), um genau das richtige Segment zu erreichen, und vergleiche anschließend eine kurze Auswahl nebeneinander.

Related MCP server: geizhals-mcp

Tools

search_geizhals(query, ...)

Suche Produkte per Stichwort. Filter für Land (loc/hloc), Kategorie und Hersteller, dazu Sortierung und Paginierung. Liefert die Treffer und Facetten-Aggregate (Kategorien, Hersteller, Preisspanne) zur weiteren Verfeinerung.

get_product(product_id)

Vollständige Details eines Produkts: Name, Bewertung, Bestpreis-Spanne, Bilder, Angebotslink und die Anzahl der Testberichte.

get_price_history(product_id, days=31)

Die Zusammenfassung der Min-/Max-/Aktuell-Preise sowie die rohe Datenreihe [timestamp, price, flag].

get_product_ratings(product_id)

Durchschnittsbewertung, Gesamtzahlen, Verteilung pro Stern und den Link zu den Bewertungen.

browse_category(category, ...)

Listet die Produkte einer Kategorie anhand ihres Codes auf, inklusive Preisspanne und Sortierung.

compare_products(product_ids)

Vergleicht mehrere Produkte nebeneinander.

get_deals(sort="percent", ...)

Aktuelle Preisstürze: Produkte, deren bester Preis gerade gefallen ist, mit prozentualem und absolutem Nachlass. Sortierbar nach dem größten percent-Rückfall sowie nach price, latest, popularity oder top-Angeboten und filterbar mit min_discount_percent.

list_categories(query)

Durchsuche den Kategoriebaum von Geizhals, um die Kategoriecodes zu finden, die browse_category erwartet. Der komplette Baum wird mit dem Server unter data/categories.json mitgeliefert.

Setup

Erfordert Python 3.9+.

pip install -r requirements.txt

Ausführen

python main.py

Der Server startet über Streamable HTTP und gibt aus, unter welcher Adresse er erreichbar ist:

Starting geizhals-mcp server on http://127.0.0.1:8000/mcp

Weise deinen MCP-Client auf diese URL an. Host, Port und Pfad stehen ganz oben in main.py.

Verwendung mit Claude Desktop

Claude Desktop startet MCP-Server über stdio. Verbinde diesen HTTP-Server also mit mcp-remote (erfordert Node.js):

1. Starte den Server (python main.py) und lasse ihn laufen.

2. Öffne in Claude Desktop Einstellungen > Entwickler > Konfiguration bearbeiten; dadurch wird claude_desktop_config.json in der nächsten Räumung angezeigt. Öffne sie und füge den geizhals-Eintrag hinzu:

   {
     "mcpServers": {
       "geizhals": {
         "command": "cmd",
         "args": ["/c", "npx", "-y", "mcp-remote", "http://127.0.0.1:8000/mcp"]
       }
     }
   }

   Unter macOS/Linux lasse den Windows-Wrapper weg: verwende "command": "npx" mit "args": ["-y", "mcp-remote", "http://127.0.0.1:8000/mcp"].

3. Speichere die Datei und starte Claude Desktop neu.

Notizen

• data/categories.json ist ein Schnappschuss des Kategoriebaums von Geizhals (title, id, children). main.py lädt ihn für list_categories.

• coverage.json enthält die Katalogzahlen, die in den Badges oben angezeigt werden. scripts/update_coverage.py aktualisiert sie von der Geizhals-Startseite und ein täglicher GitHub Action committet alle Änderungen.

• Details zur API findest du in search_api.md.

• Wir nutzen die interne mobile API von Geizhals, keine offizielle. Bitte sei rücksichtsvoll.

Troubleshooting

403 invalid request_fingerprint in payload – Der HMAC-Secret oder das Signaturschema in main.py (GH_HMAC_SECRET, request_fingerprint, API_HOST) entspricht nicht mehr dem, was die aktuelle Geizhals-App sendet. Das wurde von Geizhals per Reverse Engineering aus der App gewonnen und direkt eingebaut; es kann also schwanken, sobald Geizhals das Geheimnis rotiert oder das Fingerprint-Schema ändert.

Haftungsausschluss

Dies ist ein unabhängiges, inoffizielles Projekt und ist nicht mit Geizhals verbunden, wird nicht von Geizhals unterstützt oder steht in keinerlei Verbindung zu Geizhals. „Geizhals“ und die zugehörigen Marken gehören rechtlichen Eigentümern.

Es wird ausschließlich zu Bildungs- und Forschungszwecken veröffentlicht. Es kommuniziert mit der internen API von Geizhals, die nicht für die öffentliche Nutzung vorgesehen ist und jederzeit ausfallen oder sich ändern kann. Du bist verantwortlich für den Einsatz: Respektiere die Nutzungsbedingungen und Robots-Regeln von Geizhals und das jeweilige Recht und überlaste die Server nicht.

Lizenz

Gültige Lizenz: MIT LICENSE. Ohne Gewährleistung, „wie besehen“.