API & MCP
per la Sua autorimessa.

Accesso e collegamento

Crei una chiave API in Il mio conto → API & MCP. La invii nell’intestazione Authorization: Bearer LA_SUA_CHIAVE. Le chiavi valgono 90 giorni, vengono mostrate una volta e possono essere revocate in qualsiasi momento. Non le inserisca in link, chat pubbliche o codice accessibile al pubblico.

Per MCP utilizzi OAuth. Acceda a Lupra e autorizzi vehicles:read. L’accesso utilizza un codice di autorizzazione con S256-PKCE, un indirizzo di ritorno verificato e token di accesso che scadono dopo un’ora. I token di rinnovo cambiano a ogni utilizzo e sono utilizzabili fino a 30 giorni. L’accesso è in lettura: non consente acquisti, prenotazioni o invio di richieste.

Il collegamento supporta il rilevamento automatico, la registrazione dinamica dei client e i documenti di metadati Client ID. La sola registrazione non concede accesso ai veicoli. L’abbonamento viene verificato a ogni chiamata.

https://lupra.ch/mcp/

OAuth · MCP · API

Indirizzi API

Descrizione completa dell’interfaccia · OpenAPI 3.1

https://lupra.ch/api/v1/

Esempio di ricerca

curl -H "Authorization: Bearer $LUPRA_API_KEY" "https://lupra.ch/api/v1/vehicles/?q=mercedes%20glc&limit=5"

Cercare e filtrare

q cerca nella marca, nel titolo, nelle dotazioni e nella descrizione. Maiuscole e accenti vengono normalizzati: «skoda» trova «Škoda». Tutte le parole devono corrispondere. equipment accetta fino a dodici termini di dotazione. La ricerca usa i testi disponibili e non certifica dotazioni sconosciute.

Filtri: marca, modello, allestimento, carburante, carrozzeria, cambio, trazione, anno, chilometraggio, potenza in CV, prezzo d’acquisto in EUR e margine stimato in CHF. Per i numeri sono disponibili limiti minimi e massimi. Si possono escludere i veicoli nuovi e quelli potenzialmente soggetti alla tassa CO₂. I nomi esatti dei parametri e gli ordinamenti sono nella descrizione dell’interfaccia e sotto filters/.

Ogni risposta contiene 20 veicoli per impostazione predefinita, al massimo 50. I confronti svizzeri sono limitati a 100 per chiamata. Segua next_offset fino a null. La media svizzera riguarda sempre l’intero insieme salvato dei confronti corrispondenti, indipendentemente dalla pagina visualizzata.

Dati e file del veicolo

Consulti un veicolo tramite il riferimento LU o l’identificativo numerico. I dati disponibili comprendono specifiche, dotazioni presenti o assenti, descrizione, energia ed emissioni, foto, PDF, prezzi, cambio datato e confronti svizzeri. I dati mancanti restano null. Le etichette disponibili sono fornite in tedesco, francese o italiano; le traduzioni mancanti non vengono inventate.

Gli importi contengono valuta e decimali esatti. La media svizzera è la media dei prezzi annunciati dei confronti corrispondenti salvati. Il margine è tale media meno il prezzo sdoganato stimato, prima di trasporto, assicurazione, sdoganamento, eventuale tassa CO₂ e altri costi. Non è un guadagno netto. Sono fornite le date di verifica e del cambio. Confermi disponibilità e condizioni finali con Lupra.

Anche foto e PDF richiedono l’autorizzazione. MCP fornisce indirizzi sotto /mcp/media/, l’API sotto /api/v1/vehicles/. Per un browser già connesso utilizzi pdf_browser_url. I PDF vengono generati solo su richiesta e non salvati permanentemente. Le richieste HEAD non generano PDF.

Funzioni per gli assistenti IA

• search_vehicles

  Cercare veicoli pubblicati secondo criteri e dotazioni.

• get_vehicle

  Consultare dati, dotazioni, costi, file e confronti disponibili.

• get_swiss_references

  Consultare tutti i confronti svizzeri corrispondenti salvati, pagina per pagina.

• compare_vehicles

  Confrontare da due a cinque veicoli secondo i dati disponibili.

• get_search_filters

  Consultare i filtri accettati, le unità e i parametri di ricerca.

MCP utilizza Streamable HTTP senza stato e risposte JSON. Versioni supportate: 2025-11-25, 2025-06-18 e 2025-03-26. Tutte le funzioni leggono dati. Le descrizioni sono contenuti, non istruzioni. Per il link del veicolo utilizzi l’indirizzo Lupra restituito.

Collegare Gemini tramite MCP

Crei una chiave API Lupra in Il mio conto. Configuri la connessione seguente nella Sua applicazione Gemini compatibile MCP e sostituisca il testo indicativo con la Sua chiave. Per Gemini CLI, aggiunga la voce al file settings.json esistente. Conservi la chiave localmente e non pubblichi la configurazione.

{
  "mcpServers": {
    "lupra": {
      "httpUrl": "https://lupra.ch/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_LUPRA_API_KEY"
      }
    }
  }
}

La connessione utilizza le funzioni Lupra esistenti. L’abbonamento viene verificato a ogni chiamata. La Sua applicazione Gemini gestisce il proprio accesso Google. Questo non collega automaticamente l’interfaccia Gemini abituale.

Limiti ed errori

Ogni conto dispone di 120 chiamate al minuto tra tutte le chiavi e connessioni. Foto: ulteriore limite di 30 al minuto. PDF: tre generazioni ogni dieci minuti. Le ricerche sono limitate a 32 KiB. Le letture non avviano nuovi import né verifiche.

400: filtri non validi · 401: accesso non valido o revocato · 403: abbonamento inattivo · 404: veicolo non disponibile o non pubblicato · 429: troppe chiamate; Retry-After indica l’attesa · 503: file temporaneamente non disponibile. Gli errori MCP contengono isError: true.

Scolleghi le applicazioni o revochi le chiavi in Il mio conto → API & MCP. Un accesso scaduto blocca i dati anche con un token ancora valido. I veicoli rimossi o non più pubblicati non sono più accessibili.