Per gli acquirenti
Trova una moto e prenota subito un orario di prova messo a disposizione dal concessionario, su MotoSale o con un assistente IA collegato. Puoi sempre inviare una richiesta.
INTERFACCE APERTE
MotoSale apre il proprio mercato svizzero ad applicazioni e assistenti IA tramite un’API REST documentata e un server MCP.
La ricerca pubblica è disponibile. Le operazioni personali richiedono un account MotoSale e un collegamento autorizzato.
search_motorcycles
{ brand: "BMW", price_max: 15000 }
"brand": "BMW"
"currency": "CHF"
"url": "https://motosale.ch/..."
NOVITÀ · ONLINE E CON IA
I concessionari pubblicano gli orari disponibili su MotoSale. Scegli un orario e prenota subito dopo la conferma, su MotoSale o con un assistente IA collegato.
Cerca tra gli annunci o usa un assistente IA collegato.
Sono proposti solo gli orari resi disponibili dal concessionario.
Accedi e conferma: l’appuntamento è prenotato.
Esempio · calendario prove
Libero
Libero
Occupato
Libero
Prenotazione immediata solo per annunci dei concessionari con orari disponibili. Per altri orari è sempre possibile inviare una richiesta.
Anche tramite MCP
Gli assistenti compatibili collegati a MotoSale possono consultare le disponibilità e prenotare dopo la tua conferma esplicita.
Acquirenti, concessionari e sviluppatori possono utilizzare gli stessi annunci aggiornati tramite interfacce standard.
Trova una moto e prenota subito un orario di prova messo a disposizione dal concessionario, su MotoSale o con un assistente IA collegato. Puoi sempre inviare una richiesta.
Trova i tuoi annunci e bozze, leggi le statistiche e importa foto. Con permessi aggiuntivi gestisci calendario e richieste; ogni pubblicazione richiede la tua approvazione.
Consulta i dati pubblici tramite REST e OpenAPI o integra MCP in assistenti compatibili, senza duplicare il catalogo.
Dal dialogo all’annuncio, con conferme esplicite.
Collega un’applicazione o un assistente compatibile
Cerca le offerte o prepara un’azione con il tuo account
Visualizza il risultato su MotoSale e conferma le operazioni protette
Model Context Protocol (MCP) offre strumenti strutturati agli assistenti compatibili. Un indirizzo MCP non garantisce che ogni servizio IA lo utilizzi automaticamente.
Senza accesso: cercare moto e consultare gli orari di prova disponibili.
https://mcp.motosale.ch/mcpLeggere i propri annunci, statistiche e dati personali o eseguire azioni: servono accesso e verifica dei permessi.
https://mcp.motosale.ch/mcp/accountOAuth è attivo. La pubblicazione e il cambio di stato richiedono un’approvazione singola su motosale.ch. Il supporto MCP dipende dall’assistente IA.
Sei strumenti leggono offerte, cataloghi e disponibilità pubbliche. Ogni lettura personale o modifica richiede una connessione autorizzata; calendario e messaggi anche un permesso per applicazione.
search_motorcyclesCercare moto, scooter, ciclomotori, quad/ATV, UTV e trike per tipo di veicolo, marca, raggio, prezzo e caratteristiche
get_vehicle_taxonomyScoprire i tipi di veicolo e le sottocategorie disponibili
get_vehicle_brandsEsplorare i produttori presenti nel catalogo MotoSale
get_brand_modelsConsultare i modelli conosciuti di un produttore
get_motorcycleVisualizzare il dettaglio di un annuncio
request_test_rideInviare una richiesta per un orario non disponibile
get_test_ride_availabilityConsultare gli orari disponibili per una prova prenotabile subito, nel fuso orario svizzero
book_test_ridePrenotare immediatamente un orario libero dopo conferma esplicita (account verificato necessario)
cancel_test_rideAnnullare una propria prenotazione futura come acquirente dopo la conferma
create_listing_draftCreare una bozza non pubblicata per una tipologia di veicolo supportata
import_listing_photosAggiungere foto da indirizzi HTTPS alle proprie bozze o agli annunci inattivi, in privato e conservando le foto esistenti
update_listingModificare le proprie bozze e gli annunci inattivi; gli annunci attivi si modificano nell’editor MotoSale
publish_listingPubblicare un annuncio dopo conferma e autorizzazione una tantum su MotoSale
set_listing_statusSegnare un proprio annuncio come venduto o inattivo dopo autorizzazione una tantum
list_my_listingsLeggere e contare i propri annunci, incluse le bozze, e trovarli per titolo o modello
get_my_listingLeggere un proprio annuncio con dati salvati, foto, stato e link all’editor
get_dealer_statisticsConsultare inventario, visualizzazioni e richieste ricevute per annuncio e periodo
list_dealer_test_ridesLeggere le proprie prenotazioni per stato, veicolo e periodo, con autorizzazione del calendario
get_dealer_calendarConsultare i propri orari liberi, prenotati, bloccati o in conflitto
create_test_ride_slotsCreare disponibilità per un proprio annuncio attivo, anche con ripetizione settimanale
bulk_create_test_ride_slotsCreare disponibilità ricorrenti per più annunci e giorni della settimana
update_test_ride_slotSpostare, bloccare o sbloccare un proprio orario non prenotato
remove_test_ride_slotEliminare un proprio orario non prenotato
cancel_dealer_test_rideAnnullare una specifica prenotazione dopo l’approvazione e avvisare l’acquirente
list_my_conversationsTrovare le richieste dei propri annunci, comprese quelle degli ospiti e i messaggi non letti
get_my_conversationLeggere una propria conversazione senza modificarne lo stato di lettura
mark_conversation_readSegnare come letti i messaggi a te indirizzati in una conversazione
reply_to_conversationRispondere dopo l’approvazione di destinatario e testo: messaggistica per gli iscritti, e-mail per gli ospiti
get_dealer_accessVerificare i permessi dell’applicazione collegata e ottenere il link per gestirli
L’API 1.4.0 aggiunge 15 strumenti per concessionari. Un account concessionario collegato e verificato può leggere il proprio inventario e le statistiche aggregate. Calendario e messaggi richiedono autorizzazioni per ciascuna applicazione.
Leggi tutti i tuoi annunci o filtra per draft, active, inactive e sold. q cerca in titolo, marca e modello; model filtra il modello. meta.total conta tutti i tuoi annunci corrispondenti, su tutte le pagine. is_published indica se un annuncio è effettivamente pubblicato; gli annunci non pubblicati hanno un link all’editor.
Inventario, visualizzazioni e attività degli interessati sono disponibili per annuncio o nel totale. lifetime_views copre tutta la durata; recorded_views conta gli eventi nel periodo, non i visitatori unici. I giorni seguono Europe/Zurich. La somma dei prezzi richiesti non è un fatturato; unread_messages indica i messaggi attualmente non letti.
Leggi prenotazioni e orari liberi, prenotati o bloccati, crea disponibilità singole o ricorrenti e modifica gli orari non prenotati. Senza filtro temporale compaiono i prossimi 31 giorni. Le prenotazioni confermate sono protette: per spostarle serve un annullamento esplicitamente autorizzato con notifica e una nuova prenotazione dell’acquirente.
Leggi le richieste di iscritti e ospiti; segnarle come lette è un’azione separata. Le risposte richiedono la tua approvazione del destinatario e del testo esatto. Gli iscritti le ricevono nella messaggistica MotoSale, gli ospiti via e-mail all’indirizzo della richiesta originale. Per riprovare usa la stessa chiave di idempotenza e lo stesso testo. pending, sending, failed e uncertain non confermano l’invio; solo sent con sent:true conferma l’invio dell’e-mail.
Controlla i permessi con get_dealer_access. In « Applicazioni collegate » autorizzi o revochi la lettura o la gestione di calendario e messaggi. Le connessioni esistenti richiedono un’autorizzazione manuale per queste funzioni; inventario e statistiche sono già accessibili. Gestire include leggere. Gli scope di identità email e profile pubblicati da MCP restano invariati; l’assistente non può autorizzarsi da solo.
Gestire i permessi delle applicazioni collegatelist_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=R1200GSIl catalogo include moto, scooter, ciclomotori, quad/ATV, UTV/Side-by-Side e trike. La tassonomia restituisce tipi e sottocategorie validi con nomi in tedesco, francese e italiano. Marche e modelli si consultano separatamente.
Consultare tipi di veicolo e sottocategorieOltre a marca, modello e prezzo, sono disponibili potenza (CV), cilindrata, carburante, condizioni, tagliando/collaudo, cantone e raggio da 10 a 200 km. Per quad e UTV: trazione 2x4/4x4/6x6, omologazione stradale, posti, verricello, gancio traino e portata. Le combinazioni non valide vengono respinte.
GET /api/v1/motorcycles
?vehicle_type=quad_atv
&drive_type=4x4
&has_winch=true
&limit=5Un assistente collegato può copiare immagini da indirizzi HTTPS su MotoSale e aggiungerle alle tue bozze o agli annunci inattivi. Gli originali rimangono privati. Le foto esistenti vengono conservate; quelle nuove vengono aggiunte nell’ordine indicato.
Fino a 10 foto in totale per annuncio. L’importazione supporta JPEG, PNG e WebP statico, con un massimo di 25 MiB e 50 megapixel per immagine.
Se un’immagine non viene importata, l’operazione si interrompe per conservare l’ordine. Viene indicato il risultato di ogni immagine. Per riprovare, usa lo stesso elenco e la stessa chiave di idempotenza; le foto già importate non vengono aggiunte due volte.
POST /api/v1/listings/{id}/photos/import
{
"image_urls": [
"https://dealer.example/foto.jpg"
],
"idempotency_key":
"11111111-1111-4111-8111-111111111111"
}L’importazione non pubblica annunci. Apri la bozza nell’editor MotoSale, verifica le foto e preparale per la pubblicazione.
I nuovi annunci vengono creati soltanto come bozze. Le azioni protette richiedono un account MotoSale autorizzato. Per pubblicare o cambiare lo stato, il concessionario deve autorizzare la singola operazione tramite il link MotoSale fornito dall’assistente: la conferma in chat non basta. Gli annunci attivi o venduti si modificano nell’editor MotoSale. Le foto importate vengono preparate nell’editor prima della pubblicazione.
L’API REST v1 restituisce JSON per offerte e cataloghi pubblici e per i propri annunci, statistiche, calendari e conversazioni. OpenAPI documenta filtri, campi ed endpoint protetti. Letture personali e modifiche richiedono un token utente valido.
Consultare i modelli conosciuti di un produttoreApri la documentazione OpenAPIUna richiesta pubblica restituisce annunci attivi in JSON con prezzi in CHF e link diretti.
GET /api/v1/motorcycles
?brand=BMW
&price_max=15000
&limit=5Esempio: cerca moto BMWLa richiesta è pubblica. Annunci e prezzi riflettono il catalogo al momento della consultazione.
MotoSale separa i dati pubblici dalle operazioni che richiedono un account.
No. L’API pubblica è accessibile, ma gli strumenti MCP devono essere supportati e collegati dall’applicazione IA.
Non per cercare moto e vedere orari disponibili. Per prenotare serve un account MotoSale, un’e-mail verificata e la conferma dell’orario.
Sì, se il concessionario ha messo a disposizione un orario libero: dopo la conferma del cliente la prenotazione è immediata. Le altre richieste restano da concordare.
Esplora gli annunci oppure scopri i vantaggi per concessionari.