Sfoglia gli annunciPubblica annuncio

Account

Accedi

Sprache / Langue / Lingua

INTERFACCE APERTE

Trova la tua moto. Anche con un assistente IA.

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.

MotoSale / API
01 · MCP

search_motorcycles

{ brand: "BMW", price_max: 15000 }

02 · JSON

"brand": "BMW"

"currency": "CHF"

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

motosale.ch

NOVITÀ · ONLINE E CON IA

Trova la moto. Prenota subito la prova.

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.

1. Trova la moto

Cerca tra gli annunci o usa un assistente IA collegato.

2. Scegli un orario libero

Sono proposti solo gli orari resi disponibili dal concessionario.

3. Conferma la prenotazione

Accedi e conferma: l’appuntamento è prenotato.

Esempio · calendario prove

Europe/Zurich
10:00

Libero

11:30

Libero

14:00

Occupato

15:30

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.

Una piattaforma. Più possibilità.

Acquirenti, concessionari e sviluppatori possono utilizzare gli stessi annunci aggiornati tramite interfacce standard.

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.

Per i concessionari

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.

Per gli sviluppatori

Consulta i dati pubblici tramite REST e OpenAPI o integra MCP in assistenti compatibili, senza duplicare il catalogo.

Come funziona il collegamento

Dal dialogo all’annuncio, con conferme esplicite.

  1. 01

    Collega un’applicazione o un assistente compatibile

  2. 02

    Cerca le offerte o prepara un’azione con il tuo account

  3. 03

    Visualizza il risultato su MotoSale e conferma le operazioni protette

Model Context Protocol

MCP – per assistenti IA compatibili

Model Context Protocol (MCP) offre strumenti strutturati agli assistenti compatibili. Un indirizzo MCP non garantisce che ogni servizio IA lo utilizzi automaticamente.

Ricerca pubblica

Senza accesso: cercare moto e consultare gli orari di prova disponibili.

https://mcp.motosale.ch/mcp

Operazioni personali

Leggere i propri annunci, statistiche e dati personali o eseguire azioni: servono accesso e verifica dei permessi.

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

OAuth è attivo. La pubblicazione e il cambio di stato richiedono un’approvazione singola su motosale.ch. Il supporto MCP dipende dall’assistente IA.

29 strumenti MCP · API 1.4.0

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_motorcycles

Cercare moto, scooter, ciclomotori, quad/ATV, UTV e trike per tipo di veicolo, marca, raggio, prezzo e caratteristiche

get_vehicle_taxonomy

Scoprire i tipi di veicolo e le sottocategorie disponibili

get_vehicle_brands

Esplorare i produttori presenti nel catalogo MotoSale

get_brand_models

Consultare i modelli conosciuti di un produttore

get_motorcycle

Visualizzare il dettaglio di un annuncio

request_test_ride

Inviare una richiesta per un orario non disponibile

get_test_ride_availability

Consultare gli orari disponibili per una prova prenotabile subito, nel fuso orario svizzero

book_test_ride

Prenotare immediatamente un orario libero dopo conferma esplicita (account verificato necessario)

cancel_test_ride

Annullare una propria prenotazione futura come acquirente dopo la conferma

create_listing_draft

Creare una bozza non pubblicata per una tipologia di veicolo supportata

import_listing_photos

Aggiungere foto da indirizzi HTTPS alle proprie bozze o agli annunci inattivi, in privato e conservando le foto esistenti

update_listing

Modificare le proprie bozze e gli annunci inattivi; gli annunci attivi si modificano nell’editor MotoSale

publish_listing

Pubblicare un annuncio dopo conferma e autorizzazione una tantum su MotoSale

set_listing_status

Segnare un proprio annuncio come venduto o inattivo dopo autorizzazione una tantum

list_my_listings

Leggere e contare i propri annunci, incluse le bozze, e trovarli per titolo o modello

get_my_listing

Leggere un proprio annuncio con dati salvati, foto, stato e link all’editor

get_dealer_statistics

Consultare inventario, visualizzazioni e richieste ricevute per annuncio e periodo

list_dealer_test_rides

Leggere le proprie prenotazioni per stato, veicolo e periodo, con autorizzazione del calendario

get_dealer_calendar

Consultare i propri orari liberi, prenotati, bloccati o in conflitto

create_test_ride_slots

Creare disponibilità per un proprio annuncio attivo, anche con ripetizione settimanale

bulk_create_test_ride_slots

Creare disponibilità ricorrenti per più annunci e giorni della settimana

update_test_ride_slot

Spostare, bloccare o sbloccare un proprio orario non prenotato

remove_test_ride_slot

Eliminare un proprio orario non prenotato

cancel_dealer_test_ride

Annullare una specifica prenotazione dopo l’approvazione e avvisare l’acquirente

list_my_conversations

Trovare le richieste dei propri annunci, comprese quelle degli ospiti e i messaggi non letti

get_my_conversation

Leggere una propria conversazione senza modificarne lo stato di lettura

mark_conversation_read

Segnare come letti i messaggi a te indirizzati in una conversazione

reply_to_conversation

Rispondere dopo l’approvazione di destinatario e testo: messaggistica per gli iscritti, e-mail per gli ospiti

get_dealer_access

Verificare i permessi dell’applicazione collegata e ottenere il link per gestirli

La tua attività di concessionario tramite MCP

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.

Trovare annunci e bozze

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.

Interpretare le statistiche

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.

Gestire calendario e prenotazioni

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.

Rispondere agli interessati

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.

Autorizzare ogni applicazione

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 collegate

Esempi per il tuo inventario

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

Tipi di veicolo e sottocategorie

Il 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 sottocategorie

Filtri di ricerca avanzati

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

Preparare annunci completi di foto

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

Gestione sicura degli annunci tramite MCP

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.

REST / JSON

API REST – per siti e applicazioni

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 OpenAPI
HTTP / JSON

Esempio: cerca moto BMW

Una richiesta pubblica restituisce annunci attivi in JSON con prezzi in CHF e link diretti.

GET /api/v1/motorcycles
  ?brand=BMW
  &price_max=15000
  &limit=5
Esempio: cerca moto BMW

La richiesta è pubblica. Annunci e prezzi riflettono il catalogo al momento della consultazione.

Sicurezza e controllo

MotoSale separa i dati pubblici dalle operazioni che richiedono un account.

  • Dati privati e modifiche sono limitati all’account del concessionario. I permessi di calendario e messaggi vengono concessi per applicazione.
  • Gli annunci nascono come bozze e la pubblicazione richiede una conferma esplicita.
  • Solo gli orari liberati dal concessionario sono prenotabili subito dopo conferma esplicita. Le richieste di altri orari non sono prenotazioni.
  • Le foto importate rimangono private nel tuo account. Vengono preparate e verificate nell’editor MotoSale prima della pubblicazione.

Domande frequenti

ChatGPT usa MotoSale automaticamente?

No. L’API pubblica è accessibile, ma gli strumenti MCP devono essere supportati e collegati dall’applicazione IA.

Serve un account MotoSale?

Non per cercare moto e vedere orari disponibili. Per prenotare serve un account MotoSale, un’e-mail verificata e la conferma dell’orario.

Le prove sono subito confermate?

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.

Pronto a scoprire MotoSale?

Esplora gli annunci oppure scopri i vantaggi per concessionari.