Parcourir les annoncesPublier une annonce

Compte

Se connecter

Sprache / Langue / Lingua

INTERFACES OUVERTES

Trouvez votre moto. Aussi avec un assistant IA.

MotoSale ouvre sa place de marché suisse aux applications et assistants IA grâce à une API REST documentée et à un serveur MCP.

La recherche publique est disponible. Les actions privées nécessitent un compte MotoSale et une connexion autorisée.

MotoSale / API
01 · MCP

search_motorcycles

{ brand: "BMW", price_max: 15000 }

02 · JSON

"brand": "BMW"

"currency": "CHF"

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

motosale.ch

NOUVEAU · EN LIGNE ET VIA IA

Choisissez une moto. Réservez votre essai.

Les concessionnaires publient leurs disponibilités dans MotoSale. Choisissez un créneau et confirmez votre réservation immédiatement, sur MotoSale ou avec un assistant IA connecté.

1. Trouvez une moto

Parcourez les annonces ou demandez à un assistant IA connecté.

2. Choisissez un créneau

Seuls les horaires ouverts par le concessionnaire sont proposés.

3. Confirmez la réservation

Connectez-vous et confirmez : le rendez-vous est réservé.

Exemple · calendrier d’essai

Europe/Zurich
10:00

Libre

11:30

Libre

14:00

Réservé

15:30

Libre

Réservation immédiate uniquement pour les annonces professionnelles avec créneaux disponibles. Une demande d’essai reste possible pour les autres horaires.

Également via MCP

Les assistants compatibles connectés à MotoSale peuvent consulter les disponibilités et réserver après votre accord explicite.

Une plateforme. Plus de possibilités.

Acheteurs, professionnels et développeurs peuvent utiliser les mêmes annonces à jour au moyen d’interfaces standardisées.

Pour les acheteurs

Trouvez une moto et réservez immédiatement un créneau d’essai ouvert par le concessionnaire, sur MotoSale ou avec un assistant IA connecté. Vous pouvez aussi envoyer une simple demande.

Pour les concessionnaires

Retrouvez vos annonces et brouillons, consultez les statistiques et importez des photos. Avec des autorisations supplémentaires, gérez calendrier et demandes ; chaque publication reste à valider.

Pour les développeurs

Interrogez les offres publiques via REST et OpenAPI ou intégrez MCP dans des assistants compatibles, sans recopier le stock des annonces.

Comment fonctionne la connexion

Du dialogue à l’annonce, avec des validations claires.

  1. 01

    Connectez votre application ou assistant compatible

  2. 02

    Recherchez les offres ou préparez une action avec votre compte

  3. 03

    Consultez le résultat sur MotoSale et validez les actions protégées

Model Context Protocol

MCP – pour les assistants IA compatibles

Model Context Protocol (MCP) propose des outils structurés aux assistants compatibles. La présence d’une adresse MCP ne signifie pas que tous les services IA l’utilisent automatiquement.

Recherche publique

Sans connexion : consulter les annonces et les créneaux d’essai disponibles.

https://mcp.motosale.ch/mcp

Actions personnelles

Consulter ses annonces, statistiques et données personnelles ou exécuter une action : connexion et autorisation nécessaires.

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

OAuth est activé. Publier ou modifier le statut d’une annonce exige une validation ponctuelle sur motosale.ch. La compatibilité MCP dépend de votre assistant IA.

29 outils MCP · API 1.4.0

Six outils lisent les offres, catalogues et créneaux publics. Toute lecture personnelle ou modification exige une connexion autorisée ; calendrier et messages nécessitent aussi une autorisation par application.

search_motorcycles

Rechercher motos, scooters, cyclomoteurs, quads/ATV, UTV et trikes par type de véhicule, marque, distance, prix et caractéristiques

get_vehicle_taxonomy

Découvrir les types de véhicules et sous-catégories officiels

get_vehicle_brands

Découvrir les constructeurs du catalogue MotoSale

get_brand_models

Lister les modèles connus d’un constructeur

get_motorcycle

Consulter une annonce en détail

request_test_ride

Proposer un horaire si aucun créneau libre ne convient

get_test_ride_availability

Consulter les créneaux disponibles et immédiatement réservables pour un véhicule, à l’heure suisse

book_test_ride

Réserver immédiatement un créneau libre après confirmation explicite (compte vérifié requis)

cancel_test_ride

Annuler sa propre future réservation en tant qu’acheteur après confirmation

create_listing_draft

Créer une annonce professionnelle non publiée pour un type de véhicule pris en charge

import_listing_photos

Ajouter des photos depuis des adresses HTTPS à ses brouillons ou annonces inactives, en privé et en conservant les photos existantes

update_listing

Modifier ses brouillons et annonces inactives ; les annonces actives restent modifiables dans l’éditeur MotoSale

publish_listing

Publier son annonce après accord et autorisation ponctuelle sur MotoSale

set_listing_status

Marquer son annonce comme vendue ou inactive après autorisation ponctuelle

list_my_listings

Lire et compter ses annonces, brouillons compris, et les retrouver par titre ou modèle

get_my_listing

Lire une de ses annonces avec ses champs enregistrés, photos, statut et lien vers l’éditeur

get_dealer_statistics

Consulter le stock, les vues et les demandes reçues par annonce et période

list_dealer_test_rides

Lire ses réservations d’essai par statut, véhicule et période, avec autorisation du calendrier

get_dealer_calendar

Consulter ses créneaux libres, réservés, bloqués ou en conflit

create_test_ride_slots

Créer des disponibilités pour une de ses annonces actives, avec répétition hebdomadaire possible

bulk_create_test_ride_slots

Créer des disponibilités récurrentes pour plusieurs annonces et jours de la semaine

update_test_ride_slot

Déplacer, bloquer ou débloquer un de ses créneaux non réservés

remove_test_ride_slot

Supprimer un de ses créneaux non réservés

cancel_dealer_test_ride

Annuler une réservation client précise après accord et avertir l’acheteur

list_my_conversations

Retrouver les demandes liées à ses annonces, y compris celles d’invités et les messages non lus

get_my_conversation

Lire une de ses conversations sans modifier l’état de lecture

mark_conversation_read

Marquer comme lus les messages qui vous sont adressés dans une conversation

reply_to_conversation

Répondre après validation du destinataire et du texte : messagerie pour les inscrits, e-mail pour les invités

get_dealer_access

Vérifier les droits de l’application connectée et obtenir le lien pour les gérer

Votre activité de concessionnaire via MCP

L’API 1.4.0 ajoute 15 outils professionnels. Un compte concessionnaire connecté et vérifié peut consulter son stock et ses statistiques agrégées. Le calendrier et les messages demandent des autorisations propres à chaque application.

Retrouver annonces et brouillons

Consultez toutes vos annonces ou filtrez par draft, active, inactive et sold. q recherche dans le titre, la marque et le modèle ; model cible le modèle. meta.total compte toutes vos annonces correspondantes, sur toutes les pages. is_published indique leur publication effective ; les annonces non publiées ont un lien vers l’éditeur.

Comprendre les statistiques

Stock, vues et activité des prospects sont disponibles par annonce ou au total. lifetime_views couvre toute la durée ; recorded_views compte les événements de la période, pas des visiteurs uniques. Les jours suivent Europe/Zurich. La somme des prix demandés n’est pas un chiffre d’affaires ; unread_messages représente les messages actuellement non lus.

Gérer calendrier et réservations

Consultez réservations et créneaux libres, réservés ou bloqués, créez des horaires ponctuels ou récurrents et modifiez les créneaux non réservés. Sans filtre de dates, les 31 prochains jours sont affichés. Une réservation confirmée est protégée : la déplacer exige une annulation explicitement autorisée avec notification, puis une nouvelle réservation par l’acheteur.

Répondre aux personnes intéressées

Lisez les demandes des inscrits et des invités ; les marquer comme lues est une action distincte. Chaque réponse exige votre accord sur le destinataire et le texte exact. Les inscrits la reçoivent dans la messagerie MotoSale, les invités par e-mail à l’adresse de leur demande. Pour réessayer, conservez la même clé d’idempotence et le même texte. pending, sending, failed et uncertain ne confirment aucun envoi ; seul sent avec sent:true confirme l’envoi de l’e-mail.

Autoriser chaque application

Vérifiez les droits avec get_dealer_access. Dans « Applications connectées », autorisez ou retirez la lecture ou la gestion du calendrier et des messages. Les connexions existantes nécessitent une autorisation manuelle pour ces fonctions ; le stock et les statistiques sont déjà accessibles. La gestion inclut la lecture. Les scopes d’identité email et profile publiés par MCP restent inchangés ; l’assistant ne peut pas s’autoriser lui-même.

Gérer les autorisations des applications connectées

Exemples pour votre propre stock

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

Types de véhicules et sous-catégories

Le catalogue couvre motos, scooters, cyclomoteurs, quads/ATV, UTV/Side-by-Side et trikes. La taxonomie fournit les types et sous-catégories valides avec leurs noms en allemand, français et italien. Marques et modèles disposent de requêtes dédiées.

Consulter les types et sous-catégories de véhicules

Filtres de recherche avancés

Recherche par puissance (ch), cylindrée, carburant, état, entretien/expertise, canton et rayon de 10 à 200 km, en plus de la marque, du modèle et du prix. Pour les quads et UTV : transmission 2x4/4x4/6x6, homologation routière, sièges, treuil, attelage et charge utile. Les combinaisons invalides sont rejetées.

GET /api/v1/motorcycles
  ?vehicle_type=quad_atv
  &drive_type=4x4
  &has_winch=true
  &limit=5

Préparer des annonces avec leurs photos

Un assistant connecté peut copier des images depuis des adresses HTTPS vers MotoSale et les ajouter à vos brouillons ou annonces inactives. Les originaux restent privés. Les photos existantes sont conservées ; les nouvelles sont ajoutées dans l’ordre fourni.

Jusqu’à 10 photos au total par annonce. L’import accepte JPEG, PNG et WebP statique, avec un maximum de 25 Mio et 50 mégapixels par image.

En cas d’erreur sur une image, l’import s’interrompt pour préserver l’ordre. Le résultat est indiqué pour chaque image. Pour réessayer, utilisez la même liste et la même clé d’idempotence ; les photos déjà importées ne sont pas ajoutées deux fois.

POST /api/v1/listings/{id}/photos/import
{
  "image_urls": [
    "https://dealer.example/foto.jpg"
  ],
  "idempotency_key":
    "11111111-1111-4111-8111-111111111111"
}

L’import ne publie aucune annonce. Ouvrez le brouillon dans l’éditeur MotoSale, vérifiez les photos et préparez-les pour la publication.

Gestion sécurisée des annonces via MCP

Toute nouvelle annonce commence comme brouillon. Les opérations protégées exigent un compte MotoSale autorisé. Pour publier ou modifier le statut, le concessionnaire doit accorder une autorisation ponctuelle via le lien MotoSale fourni par son assistant ; la confirmation dans le chat ne suffit pas. Les annonces actives ou vendues restent modifiables dans l’éditeur MotoSale. Les photos importées y sont préparées avant publication.

REST / JSON

API REST – pour sites et applications

L’API REST v1 fournit du JSON pour les offres et catalogues publics ainsi que pour ses annonces, statistiques, calendriers et conversations. OpenAPI décrit filtres, champs et routes protégées. Les lectures personnelles et modifications nécessitent un jeton utilisateur valide.

Lister les modèles connus d’un constructeurOuvrir la documentation OpenAPI
HTTP / JSON

Exemple : rechercher des motos BMW

Une requête publique renvoie des annonces actives au format JSON, avec des prix en CHF et un lien vers l’offre.

GET /api/v1/motorcycles
  ?brand=BMW
  &price_max=15000
  &limit=5
Exemple : rechercher des motos BMW

Cette requête est publique. Les prix et annonces reflètent les données disponibles au moment de la consultation.

Sécurité et contrôle

MotoSale sépare les données publiques des opérations nécessitant un compte.

  • Les données privées et modifications sont limitées au compte du concessionnaire. Calendrier et messages sont autorisés par application.
  • Les annonces sont d’abord des brouillons et requièrent une confirmation explicite pour être publiées.
  • Seuls les créneaux publiés par le concessionnaire sont réservables immédiatement, après confirmation explicite du client. Les demandes restent sans engagement.
  • Les photos importées restent privées dans votre compte. Elles sont préparées et vérifiées dans l’éditeur MotoSale avant publication.

Questions fréquentes

ChatGPT utilise-t-il MotoSale automatiquement ?

Non. L’API publique est accessible, mais les outils MCP doivent être compatibles avec et intégrés dans l’application IA choisie.

Faut-il un compte MotoSale ?

Non pour consulter les motos et créneaux libres. Oui pour réserver : compte MotoSale, adresse e-mail vérifiée et confirmation du créneau requis.

Les essais sont-ils immédiatement réservés ?

Oui, si le concessionnaire a ouvert un créneau libre : la réservation est confirmée dès votre accord. Une demande pour un autre horaire reste non confirmée.

Prêt à découvrir MotoSale ?

Parcourez les motos disponibles ou découvrez les avantages réservés aux concessionnaires.