Lego non mette a disposizione un’API pubblica per il suo catalogo né per i prezzi del suo negozio. Brickfact copre il lato degli acquisti: il plugin Brickfact per ChatGPT e il nostro server MCP pubblico permettono a un assistente di intelligenza artificiale di cercare set Lego e confrontare le offerte attuali dei negozi, spedizione compresa, in nove Paesi. Nessuno dei due richiede un account Brickfact o una chiave.
Qui API sta per Application Programming Interface, l’interfaccia con cui un programma legge i dati di un servizio. Se invece cercavi i set Lego con le api, come La fattoria delle api 21165 di Minecraft, trovi set e prezzi nel catalogo Lego. Questa guida spiega come aggiungere il plugin a ChatGPT, come collegare il server MCP ad altri assistenti e cosa restituiscono gli strumenti. Gli esempi riguardano l’Italia e usano l’euro. Il servizio è gestito da Brickfact, quindi ne descriviamo i limiti con la stessa franchezza delle funzioni.
Aggiungere il plugin Brickfact a ChatGPT
La via più rapida è il plugin Brickfact nella directory dei plugin di ChatGPT. Non c’è nulla da scaricare: il plugin si installa dentro ChatGPT e funziona sul web, nell’app desktop e su dispositivi mobili.
- Apri la pagina del plugin Brickfact dopo aver effettuato l’accesso a ChatGPT. In alternativa, seleziona Plugins nella barra laterale di ChatGPT e cerca Brickfact.
- Controlla cosa include il plugin e installalo.
- Avvia una chat con una domanda d’acquisto che indichi il Paese, per esempio «Confronta le offerte per il set Lego 75192 con consegna in Italia». ChatGPT usa i plugin installati quando sono pertinenti alla tua richiesta. Per richiamare Brickfact direttamente, digita @Brickfact oppure seleziona + e inserisci il suo nome.
La directory mostra solo i plugin consentiti dal tuo piano e dal tuo spazio di lavoro. In uno spazio di lavoro aziendale è l’amministratore a decidere quali plugin possono installare i membri. Il plugin non richiede l’accesso a Brickfact, perché legge solo il catalogo pubblico.
Cosa copre Brickfact
Brickfact monitora le offerte dei negozi: prezzo dell’articolo, spese di spedizione dichiarate e totale nella valuta del Paese di destinazione scelto. Il plugin e il server MCP usano lo stesso servizio, all’indirizzo https://mcp.brickfact.com/mcp: ricerca dei set, caratteristiche, offerte, confronti, storico dei prezzi registrati nei negozi, valutazione di un’offerta e set simili. Il servizio funziona in sola lettura. Gli endpoint JSON su cui si basa non sono pubblici: richiedono una chiave che Brickfact non distribuisce al pubblico.
Il fatto che non serva una chiave non significa uso illimitato né la promessa di un servizio gratuito per sempre. È un servizio condiviso, quindi le richieste sono limitate per client e nel complesso. Quando si raggiunge un limite, il server risponde con HTTP 429 e un’intestazione Retry-After, e il client deve attendere quel tempo prima di riprovare.
| Mercato | Codice | Valuta |
|---|---|---|
| Italia | IT | EUR |
| Germania | DE | EUR |
| Austria | AT | EUR |
| Svizzera | CH | CHF |
| Regno Unito | GB | GBP |
| Stati Uniti | US | USD |
| Francia | FR | EUR |
| Paesi Bassi | NL | EUR |
| Spagna | ES | EUR |
Ogni chiamata a uno strumento richiede uno di questi mercati: stabilisce quali negozi contano e in quale valuta arrivano i prezzi. Gli altri Paesi vengono rifiutati invece di essere sostituiti da un Paese vicino. Il parametro facoltativo language cambia solo nomi ed etichette. Una risposta in inglese per il mercato italiano mostra comunque euro, negozi italiani e un link alla pagina di confronto italiana.
Cosa restituiscono gli strumenti
Se chiedi set entro un budget, l’assistente chiama search_sets. Lo strumento filtra per nome o numero del set, tema, budget, numero di pezzi, fasce d’età come 18+ e stato di fine produzione, ordina per prezzo, sconto o novità e restituisce fino a 20 set per pagina. Gli identificativi dei temi arrivano da list_themes. Un parametro sconosciuto viene rifiutato invece di essere ignorato, così un filtro frainteso non allarga la ricerca a tua insaputa.
Per un singolo set, get_set_offers elenca ogni offerta con prezzo dell’articolo, spedizione, totale, valuta, ora del feed (feed_updated_at) e stato di disponibilità. Le offerte con totale noto vengono prima, e il risultato indica il totale noto più basso e il prezzo dell’articolo più basso. Quando Brickfact non conosce le spese di spedizione di un negozio, spedizione e totale restano vuoti (null). Leggilo come sconosciuto, mai come gratuito.
Lo stato di disponibilità (stock_status) vale sempre not_verified. Un prezzo in un feed non dimostra che il set sia disponibile, e la spedizione indicata vale per un singolo set. Soglie per la spedizione gratuita, codici sconto e regole del carrello possono cambiare l’importo finale; fa fede solo il checkout del negozio.
get_set_details aggiunge il prezzo consigliato, l’età indicata, il numero di minifigure, le dimensioni e una data stimata di fine produzione. compare_sets affianca da due a quattro set.
Prezzo dell’articolo o prezzo con spedizione?
Per impostazione predefinita price_basis vale "item". In questa modalità budget e ordinamento usano solo il prezzo del set, item_price è compilato e total_price resta null. Un set da 45 € con 6,99 € di spedizione rientra così in un budget di 50 €, anche se consegnato a casa ti costa di più.
Con "delivered" Brickfact usa il totale comprensivo della spedizione dichiarata verso il mercato scelto. Le offerte con spedizione sconosciuta vengono scartate prima del filtro di prezzo, del conteggio e della paginazione: total e ogni pagina includono solo set con un totale noto, senza buchi tra le pagine. Il rovescio della medaglia è che un negozio che non dichiara le spese di spedizione sparisce del tutto da questi risultati.
Per acquistare, il prezzo con spedizione è di solito la scelta più onesta. Un prezzo basso in un negozio estero smette spesso di essere un affare quando si aggiunge la spedizione verso l’Italia, ed è per questo che i collezionisti tendono a confrontare i prezzi spedizione inclusa. Usa la modalità articolo per le viste di catalogo in cui la spedizione non conta.
Due tipi di storico dei prezzi
Brickfact tiene due storici distinti, e confonderli porta a risposte sbagliate.
Lo storico dei prezzi nei negozi (strumento get_retail_price_history) registra ogni giorno il prezzo più basso noto con spedizione presso i negozi monitorati di un mercato, nella sua valuta. Amazon è escluso, così come i giorni con spedizione sconosciuta o stimata. I giorni passati vengono calcolati con le regole di spedizione attuali per il Paese. Il risultato indica observation_days e first_observed_day. Questa serie è iniziata solo il 12 ottobre 2026: chiedere un periodo lungo non garantisce uno storico lungo. Controlla la copertura prima di trarre conclusioni.
Lo storico del valore di mercato (strumento get_price_history) è un’altra serie: le valutazioni dei set sigillati in euro. Mostra quanto vale un set sigillato nel tempo; il nostro studio sull’investimento in Lego usa valutazioni di questo tipo per i set ancora in collezione. Anche se chiedi GB, US o CH resta in euro, e non è uno storico dei prezzi praticati dai negozi.
La valutazione dell’offerta (strumento assess_deal) confronta l’offerta attuale più conveniente con spedizione, da un feed non più vecchio di 48 ore, con il minimo registrato nei negozi. Risponde at_or_below_recorded_low o above_recorded_low, con la differenza in percentuale. Senza almeno due giorni registrati o con uno storico più vecchio di 48 ore risponde insufficient_history, e senza un’offerta utilizzabile no_delivered_offer. L’offerta attuale può arrivare da Amazon anche se lo storico lo esclude. Un risultato al minimo registrato non è un minimo storico assoluto e non dice nulla sul prezzo del mese prossimo.
Collegare il server MCP ad altri assistenti
Il Model Context Protocol è uno standard aperto per collegare le applicazioni di IA a sistemi esterni. L’assistente scopre gli strumenti di Brickfact e li chiama quando la tua domanda richiede dati aggiornati, quindi non devi scrivere tu nessuna richiesta.
| Impostazione | Valore |
|---|---|
| URL del server | https://mcp.brickfact.com/mcp |
| Trasporto | Streamable HTTP (richieste POST senza stato) |
| Autenticazione | Nessuna |
| Strumenti | 11, tutti in sola lettura |
Qualsiasi client che supporta server remoti via Streamable HTTP si collega con questo URL. I client locali che supportano solo stdio hanno bisogno di un bridge.
In ChatGPT puoi anche collegare tu stesso il server invece di installare il plugin, per esempio se il tuo spazio di lavoro consente i server MCP personalizzati ma non il plugin della directory, oppure se al tuo plugin manca uno strumento dell’elenco qui sotto. La guida di collegamento di OpenAI descrive il percorso: apri ChatGPT Plugins, seleziona il pulsante «+» e poi Add custom MCP server, indica nome e descrizione, inserisci l’URL con /mcp, scegli nessuna autenticazione, conferma l’avviso sui rischi e seleziona Create as a plugin.
Gli undici strumenti:
| Strumento | A cosa serve |
|---|---|
search_sets | Cerca per nome, numero, tema, budget, pezzi, età o fine produzione |
get_set_details | Caratteristiche, data stimata di fine produzione e offerte |
get_set_offers | Offerte di un set con spese di spedizione |
compare_sets | Da due a quattro set affiancati |
list_themes | Nomi e identificativi dei temi |
get_retail_price_history | Prezzi registrati nei negozi, spedizione inclusa |
assess_deal | Offerta attuale rispetto al minimo registrato |
get_price_history | Valore dei set sigillati in euro |
find_alternatives | Set simili, più economici o più piccoli |
render_sets | Schede prodotto o vista di confronto |
get_app_handoff | Istruzioni per creare un avviso di prezzo o aggiungere un set alla watchlist nell’app Brickfact |
Cosa chiedere all’assistente per gli acquisti
Il server chiede all’assistente di riprendere il Paese d’acquisto dalla conversazione e di chiederlo se manca, quindi indicalo subito. Questi prompt coprono gli strumenti principali:
- «Trova set Lego Star Wars sotto i 100 € spedizione compresa in Italia e mostrali come schede.»
- «Aiutami a scegliere un regalo Lego fino a 60 € spedizione compresa in Italia per un bambino di 10 anni a cui piacciono le auto.»
- «Confronta i set Lego 10311 e 10313 con consegna in Italia, con numero di pezzi e prezzo con spedizione.»
- «Il prezzo attuale del set Lego 75192 in Italia è buono rispetto ai prezzi registrati nei negozi? Dimmi su quanti giorni di dati ti basi.»
- «Trova alternative più economiche al set Lego 75192 con consegna in Italia.»
Gli host compatibili con MCP Apps mostrano schede dei set con immagini, un confronto affiancato e grafici dello storico dei prezzi nei negozi. Altrove l’assistente risponde in forma testuale con gli stessi dati. Se l’host consente alle app di salvare uno stato, la scheda può conservare una selezione fino a sei numeri di set. Quella selezione appartiene alla scheda nella conversazione, non a un account Brickfact, e in una nuova chat potrebbe non esserci.
Cosa non può fare l’assistente
Il plugin e il server MCP leggono solo dati pubblici del catalogo. Non possono comprare nulla, non chiedono dati di pagamento, non vedono la tua collezione Brickfact e non modificano il tuo account. Se chiedi di essere avvisato quando il set Lego 10311 scende sotto i 30 €, ricevi un rimando all’app con "created": false: un link all’app Brickfact e le istruzioni per creare lì l’avviso. Non viene creato nulla finché non confermi nell’app. Se ti interessano gli sconti del momento, la nostra pagina delle offerte Lego li raccoglie.
I prezzi di una risposta non sono mai più aggiornati del feed da cui arrivano. Una buona offerta può esaurirsi pochi minuti dopo un ribasso: apri il link di confronto restituito e controlla il negozio prima di comprare.
Buone pratiche per risposte affidabili
Alcune abitudini mantengono corrette le risposte quando i dati cambiano:
- Parti da un set e un mercato, e controlla valuta e base di prezzo in ogni risposta prima di aggiungere altri Paesi.
- Considera una spedizione sconosciuta come sconosciuta, mai come gratuita.
- Controlla quando è stato aggiornato il feed (
feed_updated_at) o annota l’ora della tua domanda accanto ai prezzi. - Tratta i risultati vuoti e gli storici brevi come risposte normali, non come errori.
- Dopo un errore HTTP 429 rispetta
Retry-After, e non scorrere l’intero catalogo attraverso le pagine di ricerca. - Usa il link di confronto restituito (
comparison_url) invece di costruire da solo gli indirizzi delle pagine dei set.
Se preferisci confrontare i prezzi a mano, il catalogo Lego mostra le stesse offerte con filtri, e come confrontiamo i prezzi spiega quali negozi monitoriamo.
Altre fonti di dati Lego
Brickfact copre le offerte dei negozi, non i pezzi né il mercato dell’usato. Per pezzi, colori e inventari dei set la fonte abituale è l’API di Rebrickable; l’API di Brickset copre schede dei set e collezioni, e l’API di BrickLink dà accesso ai prezzi del suo marketplace per set nuovi e usati. Tutti e tre richiedono una chiave propria e hanno regole d’uso proprie.
Un’API per programmare hub e motori Lego riguarda la robotica, non i dati: la nostra guida per programmare un robot Lego tratta SPIKE, Mindstorms e Python con Pybricks. Brickfact è indipendente dal Gruppo Lego.
