willhaben-mcp

Ein MCP-Server, der einer KI ermöglicht, willhaben.at Marktplatz-Inserate zu durchsuchen und die vollständigen Details von Anzeigen abzurufen. Er kapselt die reverse-engineerte Mobile-App-API von willhaben und liefert die wichtigen Felder an die KI zurück.

Tools

search_willhaben(keyword, ...)

Durchsuche den Marktplatz. keyword ist optional, wenn du eine category angibst.

Filter:

• category (ID oder Name)

• condition (neu, gebraucht, refurbished, ...)

• clothing_size und shoe_size

• color, pattern

• brand

• Region, Verkäufertyp, Preisbereich, PayLivery, letzte 48h

• Sortierung und Paginierung

Gibt eine gekürzte Liste der Treffer zurück.

get_ad_detail(ad_id)

Alles über eine Anzeige: die vollständige (nicht gekürzte) Beschreibung, alle Bilder, aufgeschlüsselte Attribute, Kategoriepfad und genaue Standort. Führe es mit einer ID aus, die du aus einer Suche erhalten hast.

list_categories(query, parent_id)

Finde Kategorie-IDs für den category-Filter.

• query: durchsuche den gesamten Baum nach Namen

• parent_id: durchstöbere eine Ebene tiefer (beide weglassen für die Kategorien der obersten Ebene)

Der vollständige Baum (~3500 Kategorien) wird mit dem Server in category-tree.json ausgeliefert.

search_brands(category, term)

Marken sind kategoriespezifisch und es gibt 1000+ pro Kategorie, daher ist dies eine Type-ahead-Suche. Gib eine Kategorie und einen Suchbegriff an, um passende Marken-IDs zu erhalten, und übergib dann eine ID an search_willhaben(brand=...).

Hinweis: condition, sizes, color, pattern und brand sind kategorieabhängig. Die Anwendung in einer breiten Kategorie kann null Treffer ergeben, daher gehe zuerst in eine spezifische Unterkategorie.

Related MCP server: Secondhand MCP

Einrichtung

pip install -r requirements.txt

Ausführen

python main.py

Der Server startet über streamable HTTP und gibt aus, wo er lauscht:

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

Richte deinen MCP-Client auf diese URL aus. Host, Port und Pfad stehen oben in main.py.

Hinweise

• Die Detail-API ist durch ein statisches App-Token abgesichert und spricht nur HTTP/2. Beides wird in main.py behandelt. Falls willhaben das Token rotiert, hole ein frisches Token aus den Request-Headern der App und ersetze WH_APPLICATION_TOKEN.

• category-tree.json ist ein generierter Snapshot des Kategoriebaums des willhaben-Marktplatzes (id, label, parentId, children). main.py lädt ihn beim Start für den category-Filter und list_categories. Crawle ihn neu, wenn sich die Taxonomie ändert.

• API-Details sind in search_api.md dokumentiert.

• Dies verwendet die interne API von willhaben, keine offizielle. Sei nett zu ihr.

Haftungsausschluss

Dies ist ein unabhängiges, inoffizielles Projekt und ist weder mit willhaben verbunden, noch von willhaben unterstützt, noch mit willhaben verbunden. „willhaben" und alle zugehörigen Marken gehören ihren jeweiligen Inhabern.

Es ist nur zu Bildungs- und Forschungszwecken veröffentlicht. Es spricht mit der internen API von willhaben, die nicht für die öffentliche Nutzung gedacht ist und jederzeit brechen oder sich ändern kann. Du bist für die Art der Nutzung verantwortlich: Respektiere die Nutzungsbedingungen von willhaben, die Robots-Regeln und das geltende Recht und belaste ihre Server nicht oder verarbeite keine personenbezogenen Daten aus Inseraten. Keine Garantie irgendwelcher Art; Nutzung auf eigenes Risiko.

Wenn du ein Rechteinhaber bist und ein Anliegen zu diesem Repository hast, öffne bitte ein Issue und ich werde umgehend antworten.

Lizenz

MIT LICENSE. Bereitgestellt „wie besehen", ohne Gewähr.