Inserate durchsuchenInserat erstellen

Konto

Anmelden

Sprache / Langue / Lingua

OFFENE SCHNITTSTELLEN

Motorräder finden. Auch mit KI-Assistenten.

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.

MotoSale / API
01 · MCP

search_motorcycles

{ brand: "BMW", price_max: 15000 }

02 · JSON

"brand": "BMW"

"currency": "CHF"

"url": "https://motosale.ch/..."

motosale.ch

NEU · ONLINE & ÜBER KI

Motorrad finden. Probefahrt direkt buchen.

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.

1. Motorrad finden

Passendes Angebot im Marktplatz oder per KI-Assistent suchen.

2. Freien Termin wählen

Nur vom Händler freigegebene Zeitfenster werden angezeigt.

3. Buchung bestätigen

Anmelden, Termin bestätigen – die Reservierung steht sofort.

Beispiel · Probefahrtkalender

Europe/Zurich
10:00

Frei

11:30

Frei

14:00

Belegt

15:30

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.

Eine Plattform. Mehr Möglichkeiten.

Ob du ein Motorrad suchst, Fahrzeuge verkaufst oder eine Anwendung entwickelst: dieselben aktuellen Inseratedaten können auch über standardisierte Schnittstellen genutzt werden.

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.

Für Händler

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.

Für Entwickler

Öffentliche Fahrzeugdaten über REST und OpenAPI abrufen oder über MCP in kompatible KI-Assistenten integrieren – ohne eigene Synchronisation des Inseratebestands.

So funktioniert die Verbindung

Vom Dialog zum Inserat – mit klaren Freigaben, statt unkontrollierter Automatisierung.

  1. 01

    KI-Assistent oder Anwendung mit der passenden Schnittstelle verbinden

  2. 02

    Aktuelle Angebote suchen oder als angemeldeter Nutzer eine Aktion vorbereiten

  3. 03

    Ergebnis direkt auf MotoSale ansehen; geschützte Aktionen bewusst bestätigen

Model Context Protocol

MCP – für kompatible KI-Assistenten

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.

Öffentliche Motorradsuche

Ohne Anmeldung: Motorräder suchen, Angebote abrufen und freie Probefahrttermine prüfen.

https://mcp.motosale.ch/mcp

Persönliche Aktionen

Eigene Inserate, Statistiken und weitere persönliche Daten lesen oder Aktionen ausführen: Anmeldung und Berechtigungsprüfung erforderlich.

https://mcp.motosale.ch/mcp/account

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

29 MCP-Werkzeuge · API 1.4.0

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_motorcycles

Motorräder, Roller, Mofas, Quads/ATV, UTV und Trikes nach Fahrzeugtyp, Marke, Umkreis, Preis und technischen Merkmalen suchen

get_vehicle_taxonomy

Gültige Fahrzeugarten und Unterkategorien in drei Sprachen abrufen

get_vehicle_brands

Hersteller im MotoSale-Katalog entdecken

get_brand_models

Alle bekannten Modelle eines Herstellers abrufen

get_motorcycle

Ein bestimmtes Inserat im Detail abrufen

request_test_ride

Eine unverbindliche Wunschzeit anfragen, wenn kein freier Termin passt

get_test_ride_availability

Freie, sofort verbindlich buchbare Probefahrttermine eines Inserats in Schweizer Zeit abrufen

book_test_ride

Nach ausdrücklicher Zustimmung einen freien Probefahrttermin sofort verbindlich buchen (verifiziertes Konto erforderlich)

cancel_test_ride

Eine eigene zukünftige Käuferbuchung nach Bestätigung stornieren

create_listing_draft

Ein unveröffentlichtes Händler-Inserat für eine unterstützte Fahrzeugart als Entwurf erstellen

import_listing_photos

Fotos von HTTPS-Adressen privat an eigene Entwürfe oder inaktive Inserate anhängen; bestehende Fotos bleiben erhalten

update_listing

Eigene Entwürfe und inaktive Inserate bearbeiten; aktive Angebote weiterhin im MotoSale-Editor ändern

publish_listing

Ein eigenes Inserat nach Bestätigung und einmaliger Freigabe auf MotoSale veröffentlichen

set_listing_status

Eigenes Inserat nach einmaliger Freigabe als verkauft oder inaktiv markieren

list_my_listings

Eigene Inserate aller Status einschliesslich Entwürfen lesen, zählen und nach Titel oder Modell finden

get_my_listing

Ein eigenes Inserat mit gespeicherten Feldern, Fotos, Status und Editorlink abrufen

get_dealer_statistics

Eigene Bestandszahlen, Aufrufe und eingehende Anfragen nach Inserat und Zeitraum abrufen

list_dealer_test_rides

Eigene Probefahrtbuchungen nach Status, Fahrzeug und Zeitraum lesen; Kalenderfreigabe erforderlich

get_dealer_calendar

Freie, gebuchte, gesperrte und kollidierende eigene Zeitfenster lesen

create_test_ride_slots

Zeitfenster für ein eigenes aktives Inserat anlegen, auf Wunsch wöchentlich wiederholen

bulk_create_test_ride_slots

Wiederkehrende Zeitfenster für mehrere eigene Inserate und Wochentage anlegen

update_test_ride_slot

Ein ungebuchtes eigenes Zeitfenster verschieben, sperren oder entsperren

remove_test_ride_slot

Ein ungebuchtes eigenes Zeitfenster entfernen

cancel_dealer_test_ride

Eine konkrete Kundenbuchung nach Zustimmung stornieren und den Käufer benachrichtigen

list_my_conversations

Anfragen zu eigenen Inseraten einschliesslich Gastanfragen und ungelesener Nachrichten finden

get_my_conversation

Nachrichten einer eigenen Konversation lesen, ohne den Lesestatus zu ändern

mark_conversation_read

An dich gerichtete Nachrichten einer eigenen Konversation als gelesen markieren

reply_to_conversation

Nach Freigabe von Empfänger und Text antworten: registrierten Nutzern im Postfach, Gästen per E-Mail

get_dealer_access

Berechtigungen der verbundenen Anwendung prüfen und den Link zur Verwaltung abrufen

Dein Händleralltag über MCP

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.

Bestand und Entwürfe finden

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.

Statistiken richtig einordnen

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.

Kalender und Buchungen verwalten

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.

Interessenten gezielt antworten

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.

Zugriff pro Anwendung freigeben

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 verwalten

Beispiele für deinen eigenen Bestand

list_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=R1200GS

Alle Fahrzeugarten und Unterkategorien

Der 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 abrufen

Erweiterte Suchfilter

Neben 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=5

Inserate inklusive Fotos vorbereiten

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

Sichere Inseratverwaltung per MCP

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.

REST / JSON

REST-API – für Websites und Anwendungen

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 öffnen
HTTP / JSON

Beispiel: Motorräder mit BMW suchen

Eine ö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=5
Beispiel: Motorräder mit BMW suchen

Die Abfrage ist öffentlich. Die angezeigten Angebote und Preise stammen jeweils aus dem aktuellen Inseratebestand.

Sicherheit und Kontrolle

MotoSale trennt öffentlich lesbare Fahrzeugdaten von Aktionen, die ein Benutzerkonto voraussetzen.

  • Private Händlerdaten und Änderungen sind auf das eigene Konto beschränkt. Kalender- und Nachrichtenrechte werden je Anwendung freigegeben.
  • Neue Inserate werden zunächst als Entwurf angelegt; die Veröffentlichung verlangt eine ausdrückliche Bestätigung.
  • Nur vom Händler freigeschaltete Zeitfenster können sofort gebucht werden. Eine Buchung benötigt Anmeldung und ausdrückliche Zustimmung; Anfragen bleiben unverbindlich.
  • Importierte Fotos bleiben privat beim eigenen Konto. Für die Veröffentlichung werden sie im MotoSale-Editor aufbereitet und geprüft.

Häufige Fragen

Kann ChatGPT automatisch auf MotoSale zugreifen?

Nicht automatisch. Die öffentliche API ist abrufbar, aber MCP-Werkzeuge müssen von der jeweiligen KI-Anwendung unterstützt und eingebunden werden.

Brauche ich ein MotoSale-Konto?

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.

Sind Testfahrttermine sofort verbindlich?

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.

Bereit für die nächste Verbindung?

Entdecke die aktuellen Motorradangebote oder erfahre, wie du als Händler mit MotoSale arbeiten kannst.