Für Käufer
Passende Motorräder finden und freigegebene Probefahrttermine direkt verbindlich buchen – auf MotoSale oder mit einem verbundenen KI-Assistenten. Ohne freie Zeitfenster bleibt die unverbindliche Anfrage möglich.
OFFENE SCHNITTSTELLEN
MotoSale öffnet seinen Schweizer Motorrad-Marktplatz für Anwendungen und KI-Assistenten – über eine dokumentierte REST-API und einen MCP-Server.
Die öffentliche Motorradsuche ist verfügbar. Geschützte Aktionen erfordern ein MotoSale-Konto und eine autorisierte Verbindung.
search_motorcycles
{ brand: "BMW", price_max: 15000 }
"brand": "BMW"
"currency": "CHF"
"url": "https://motosale.ch/..."
NEU · ONLINE & ÜBER KI
Händler geben freie Termine im MotoSale-Kalender frei. Du wählst einen verfügbaren Zeitpunkt und buchst ihn nach deiner Bestätigung sofort – auf MotoSale oder über einen verbundenen KI-Assistenten.
Passendes Angebot im Marktplatz oder per KI-Assistent suchen.
Nur vom Händler freigegebene Zeitfenster werden angezeigt.
Anmelden, Termin bestätigen – die Reservierung steht sofort.
Beispiel · Probefahrtkalender
Frei
Frei
Belegt
Frei
Verbindlich buchbar nur bei aktiven Händlerangeboten mit freigegebenen Zeitfenstern. Für andere Termine kannst du weiterhin eine unverbindliche Anfrage senden.
Auch über MCP
Kompatible und mit MotoSale verbundene Assistenten können freie Termine abfragen und nach deiner Zustimmung verbindlich buchen.
Ob du ein Motorrad suchst, Fahrzeuge verkaufst oder eine Anwendung entwickelst: dieselben aktuellen Inseratedaten können auch über standardisierte Schnittstellen genutzt werden.
Passende Motorräder finden und freigegebene Probefahrttermine direkt verbindlich buchen – auf MotoSale oder mit einem verbundenen KI-Assistenten. Ohne freie Zeitfenster bleibt die unverbindliche Anfrage möglich.
Eigene Inserate samt Entwürfen finden, Statistiken lesen und Fotos importieren. Mit zusätzlichen App-Freigaben verwaltest du Kalender und Interessentenanfragen; Veröffentlichungen bleiben einzeln freizugeben.
Öffentliche Fahrzeugdaten über REST und OpenAPI abrufen oder über MCP in kompatible KI-Assistenten integrieren – ohne eigene Synchronisation des Inseratebestands.
Vom Dialog zum Inserat – mit klaren Freigaben, statt unkontrollierter Automatisierung.
KI-Assistent oder Anwendung mit der passenden Schnittstelle verbinden
Aktuelle Angebote suchen oder als angemeldeter Nutzer eine Aktion vorbereiten
Ergebnis direkt auf MotoSale ansehen; geschützte Aktionen bewusst bestätigen
Das Model Context Protocol (MCP) stellt Werkzeuge bereit, mit denen kompatible Assistenten strukturiert auf Motorradangebote zugreifen können. Eine MCP-Adresse bedeutet nicht, dass alle KI-Dienste MotoSale automatisch finden oder verwenden.
Ohne Anmeldung: Motorräder suchen, Angebote abrufen und freie Probefahrttermine prüfen.
https://mcp.motosale.ch/mcpEigene Inserate, Statistiken und weitere persönliche Daten lesen oder Aktionen ausführen: Anmeldung und Berechtigungsprüfung erforderlich.
https://mcp.motosale.ch/mcp/accountOAuth ist bei MotoSale aktiviert. Für das Veröffentlichen und Ändern des Verkaufsstatus ist zusätzlich eine einmalige Freigabe auf motosale.ch erforderlich. Die Unterstützung externer MCP-Server hängt vom KI-Anbieter ab.
Sechs Werkzeuge lesen öffentliche Angebote, Kataloge und freie Termine. Alle persönlichen Lesezugriffe und Änderungen benötigen eine autorisierte Verbindung; Kalender und Nachrichten zusätzlich eine App-Freigabe.
search_motorcyclesMotorräder, Roller, Mofas, Quads/ATV, UTV und Trikes nach Fahrzeugtyp, Marke, Umkreis, Preis und technischen Merkmalen suchen
get_vehicle_taxonomyGültige Fahrzeugarten und Unterkategorien in drei Sprachen abrufen
get_vehicle_brandsHersteller im MotoSale-Katalog entdecken
get_brand_modelsAlle bekannten Modelle eines Herstellers abrufen
get_motorcycleEin bestimmtes Inserat im Detail abrufen
request_test_rideEine unverbindliche Wunschzeit anfragen, wenn kein freier Termin passt
get_test_ride_availabilityFreie, sofort verbindlich buchbare Probefahrttermine eines Inserats in Schweizer Zeit abrufen
book_test_rideNach ausdrücklicher Zustimmung einen freien Probefahrttermin sofort verbindlich buchen (verifiziertes Konto erforderlich)
cancel_test_rideEine eigene zukünftige Käuferbuchung nach Bestätigung stornieren
create_listing_draftEin unveröffentlichtes Händler-Inserat für eine unterstützte Fahrzeugart als Entwurf erstellen
import_listing_photosFotos von HTTPS-Adressen privat an eigene Entwürfe oder inaktive Inserate anhängen; bestehende Fotos bleiben erhalten
update_listingEigene Entwürfe und inaktive Inserate bearbeiten; aktive Angebote weiterhin im MotoSale-Editor ändern
publish_listingEin eigenes Inserat nach Bestätigung und einmaliger Freigabe auf MotoSale veröffentlichen
set_listing_statusEigenes Inserat nach einmaliger Freigabe als verkauft oder inaktiv markieren
list_my_listingsEigene Inserate aller Status einschliesslich Entwürfen lesen, zählen und nach Titel oder Modell finden
get_my_listingEin eigenes Inserat mit gespeicherten Feldern, Fotos, Status und Editorlink abrufen
get_dealer_statisticsEigene Bestandszahlen, Aufrufe und eingehende Anfragen nach Inserat und Zeitraum abrufen
list_dealer_test_ridesEigene Probefahrtbuchungen nach Status, Fahrzeug und Zeitraum lesen; Kalenderfreigabe erforderlich
get_dealer_calendarFreie, gebuchte, gesperrte und kollidierende eigene Zeitfenster lesen
create_test_ride_slotsZeitfenster für ein eigenes aktives Inserat anlegen, auf Wunsch wöchentlich wiederholen
bulk_create_test_ride_slotsWiederkehrende Zeitfenster für mehrere eigene Inserate und Wochentage anlegen
update_test_ride_slotEin ungebuchtes eigenes Zeitfenster verschieben, sperren oder entsperren
remove_test_ride_slotEin ungebuchtes eigenes Zeitfenster entfernen
cancel_dealer_test_rideEine konkrete Kundenbuchung nach Zustimmung stornieren und den Käufer benachrichtigen
list_my_conversationsAnfragen zu eigenen Inseraten einschliesslich Gastanfragen und ungelesener Nachrichten finden
get_my_conversationNachrichten einer eigenen Konversation lesen, ohne den Lesestatus zu ändern
mark_conversation_readAn dich gerichtete Nachrichten einer eigenen Konversation als gelesen markieren
reply_to_conversationNach Freigabe von Empfänger und Text antworten: registrierten Nutzern im Postfach, Gästen per E-Mail
get_dealer_accessBerechtigungen der verbundenen Anwendung prüfen und den Link zur Verwaltung abrufen
API 1.4.0 ergänzt 15 Händlerwerkzeuge. Ein verbundenes, verifiziertes Händlerkonto kann den eigenen Bestand und aggregierte Statistiken lesen. Kalender und Nachrichten erhalten eigene Freigaben je Anwendung.
Lies alle eigenen Inserate oder filtere nach draft, active, inactive und sold. q sucht in Titel, Marke und Modell; model filtert gezielt. meta.total zählt alle passenden eigenen Inserate, auch über mehrere Seiten. is_published zeigt, ob ein Inserat tatsächlich veröffentlicht ist; unveröffentlichte Inserate haben einen Editorlink.
Bestand, Aufrufe und Interessentenaktivität sind pro Inserat oder insgesamt verfügbar. lifetime_views zählt über die Laufzeit; recorded_views erfasst Ereignisse im gewählten Zeitraum, keine eindeutigen Besucher. Tage folgen Europe/Zurich. Angebotspreissummen sind kein Umsatz; unread_messages zeigt den aktuellen ungelesenen Bestand.
Lies Buchungen und freie, gebuchte oder gesperrte Fenster, lege einzelne oder wiederkehrende Zeiten an und ändere ungebuchte Termine. Ohne Zeitfilter werden die nächsten 31 Tage angezeigt. Bestätigte Kundenbuchungen sind geschützt: Eine Umbuchung braucht eine ausdrücklich bestätigte Stornierung samt Benachrichtigung und eine neue Käuferbuchung.
Lies registrierte und Gastanfragen; als gelesen markieren ist eine eigene Aktion. Antworten erfordern deine Freigabe von Empfänger und genauem Text. Registrierte Nutzer erhalten sie im MotoSale-Postfach, Gäste per E-Mail an ihre ursprüngliche Anfrageadresse. Bei Wiederholungen denselben Idempotenzschlüssel und Text verwenden. pending, sending, failed und uncertain bestätigen keinen Versand; nur sent mit sent:true bestätigt den E-Mail-Versand.
Prüfe die aktuellen Rechte mit get_dealer_access. Unter „Verbundene Anwendungen“ gibst du Kalender und Nachrichten zum Lesen oder Verwalten frei und entziehst Rechte wieder. Bestehende Verbindungen benötigen dafür eine manuelle Freigabe; eigener Bestand und Statistik sind bereits nutzbar. Verwalten umfasst Lesen. Die vom MCP veröffentlichten Identitätsscopes email und profile bleiben unverändert; der Assistent kann sich keine Rechte selbst geben.
Berechtigungen verbundener Anwendungen verwaltenlist_my_listings({ status: "draft", limit: 50 })
list_my_listings({ q: "R1200GS" })
list_my_listings({ brand: "BMW", model: "R 1200" })
get_dealer_statistics({ days: 30 })
GET /api/v1/me/listings?status=draft&limit=50
GET /api/v1/me/listings?q=R1200GSDer Katalog umfasst Motorräder, Roller, Mofas, Quads/ATV, UTV/Side-by-Side und Trikes. Die Taxonomie liefert gültige Fahrzeugarten und Unterkategorien sowie Bezeichnungen auf Deutsch, Französisch und Italienisch. Hersteller und Modelle können separat abgefragt werden.
Fahrzeugkategorien und Unterkategorien abrufenNeben Marke, Modell und Preis sind unter anderem Leistung in PS, Hubraum, Treibstoff, Zustand, Service/MFK, Kanton und Umkreissuche (10–200 km) verfügbar. Für Quads und UTV lassen sich auch 2x4/4x4/6x6, Strassenzulassung, Sitzplätze, Seilwinde, Anhängerkupplung und Nutzlast filtern. Ungültige Kombinationen werden abgewiesen.
GET /api/v1/motorcycles
?vehicle_type=quad_atv
&drive_type=4x4
&has_winch=true
&limit=5Ein verbundener Assistent kann Bilder von HTTPS-Adressen zu MotoSale kopieren und deinen eigenen Entwürfen oder inaktiven Inseraten hinzufügen. Die Originale bleiben privat. Vorhandene Fotos bleiben erhalten; neue Bilder werden in der übergebenen Reihenfolge angehängt.
Bis zu 10 Fotos insgesamt pro Inserat. Der Import unterstützt JPEG, PNG und statisches WebP mit maximal 25 MiB und 50 Megapixeln je Bild.
Bei einem Bildfehler pausiert der Import, damit die Reihenfolge erhalten bleibt. Die Rückmeldung zeigt den Stand für jedes Bild. Für einen erneuten Versuch dieselbe Bildliste und denselben Idempotenzschlüssel verwenden; bereits übernommene Fotos werden nicht doppelt angehängt.
POST /api/v1/listings/{id}/photos/import
{
"image_urls": [
"https://dealer.example/foto.jpg"
],
"idempotency_key":
"11111111-1111-4111-8111-111111111111"
}Der Import veröffentlicht nichts. Öffne den Entwurf im MotoSale-Editor, prüfe die Fotos und lasse sie dort für die Veröffentlichung aufbereiten.
Neue Inserate werden nur als Entwurf erstellt. Geschützte Aktionen benötigen ein autorisiertes MotoSale-Konto. Zum Veröffentlichen oder Ändern des Verkaufsstatus muss der Händler eine einmalige Freigabe über den vom Assistenten gelieferten Link auf MotoSale erteilen; blosses Bestätigen im Chat genügt nicht. Bereits aktive oder verkaufte Inserate bleiben für Änderungen im MotoSale-Editor. Importierte Fotos werden vor der Veröffentlichung im Editor aufbereitet.
Die REST-API v1 liefert JSON für öffentliche Angebote und Kataloge sowie für eigene Inserate, Statistiken, Kalender und Konversationen. OpenAPI dokumentiert Filter, Felder und alle geschützten Routen. Persönliche Lesezugriffe und Schreibaktionen benötigen ein gültiges Benutzer-Zugriffstoken.
Alle bekannten Modelle eines Herstellers abrufenOpenAPI-Dokumentation öffnenEine öffentliche Anfrage liefert passende, aktive Inserate als JSON – mit Preisen in CHF und einem direkten Link zum Angebot.
GET /api/v1/motorcycles
?brand=BMW
&price_max=15000
&limit=5Beispiel: Motorräder mit BMW suchenDie Abfrage ist öffentlich. Die angezeigten Angebote und Preise stammen jeweils aus dem aktuellen Inseratebestand.
MotoSale trennt öffentlich lesbare Fahrzeugdaten von Aktionen, die ein Benutzerkonto voraussetzen.
Nicht automatisch. Die öffentliche API ist abrufbar, aber MCP-Werkzeuge müssen von der jeweiligen KI-Anwendung unterstützt und eingebunden werden.
Motorräder und freie Probefahrttermine kannst du ohne Konto ansehen. Zum Buchen brauchst du ein MotoSale-Konto mit bestätigter E-Mail-Adresse und musst den Termin ausdrücklich bestätigen.
Ja, wenn der Händler dafür ein freies Zeitfenster freigegeben hat: Nach deiner Bestätigung wird der Termin unmittelbar gebucht. Für andere Zeiten ist weiterhin eine unverbindliche Anfrage möglich.
Entdecke die aktuellen Motorradangebote oder erfahre, wie du als Händler mit MotoSale arbeiten kannst.