Lego ne propose pas d’API publique pour son catalogue ni pour les prix de sa boutique. Brickfact comble ce manque côté achats : le plugin Brickfact pour ChatGPT et notre serveur MCP public permettent à un assistant d’IA de chercher des sets Lego et de comparer les offres actuelles des marchands, frais de port compris, dans neuf pays. Ni l’un ni l’autre ne demande de compte Brickfact ou de clé.
Ce guide explique comment ajouter le plugin à ChatGPT, comment connecter le serveur MCP à d’autres assistants et ce que renvoient les outils. Les exemples portent sur la France et sont exprimés en euros. Brickfact exploite ce service lui-même : nous en décrivons les limites aussi franchement que les fonctions.
Ajouter le plugin Brickfact à ChatGPT
Le plus simple est de passer par le plugin Brickfact dans l’annuaire des plugins de ChatGPT. Il n’y a rien à télécharger : le plugin s’installe dans ChatGPT et fonctionne sur le web, dans l’application de bureau et sur mobile.
- Ouvrez la page du plugin Brickfact en étant connecté à ChatGPT. Vous pouvez aussi sélectionner Plugins dans la barre latérale de ChatGPT et rechercher Brickfact.
- Regardez ce que comprend le plugin, puis installez-le.
- Lancez une conversation avec une question d’achat qui précise le pays, par exemple « Compare les offres pour le set Lego 75192 livré en France ». ChatGPT utilise les plugins installés quand ils correspondent à votre demande. Pour appeler Brickfact directement, tapez @Brickfact, ou sélectionnez + et saisissez son nom.
L’annuaire n’affiche que les plugins autorisés par votre abonnement et votre espace de travail. Dans un espace de travail d’entreprise, c’est l’administrateur qui décide des plugins que les membres peuvent installer. Le plugin ne demande aucune connexion à Brickfact, puisqu’il ne lit que le catalogue public.
Ce que couvre Brickfact
Brickfact suit les offres des marchands : prix de l’article, frais de port déclarés et total dans la devise du pays de livraison choisi. Le plugin et le serveur MCP s’appuient sur le même service, à l’adresse https://mcp.brickfact.com/mcp : recherche de sets, caractéristiques, offres, comparaisons, historique des prix relevés chez les marchands, évaluation d’une offre et sets similaires. Le service fonctionne en lecture seule. Les routes JSON qui se trouvent derrière ne sont pas publiques : elles exigent une clé que Brickfact ne distribue pas au public.
L’absence de clé ne signifie ni un usage illimité ni la promesse d’un service gratuit pour toujours. Le service est partagé : les requêtes sont limitées par client et globalement. Quand une limite est atteinte, le serveur répond par HTTP 429 avec un en-tête Retry-After, et le client doit patienter pendant ce délai avant de réessayer.
| Marché | Code | Devise |
|---|---|---|
| France | FR | EUR |
| Allemagne | DE | EUR |
| Autriche | AT | EUR |
| Suisse | CH | CHF |
| Royaume-Uni | GB | GBP |
| États-Unis | US | USD |
| Pays-Bas | NL | EUR |
| Espagne | ES | EUR |
| Italie | IT | EUR |
Chaque appel d’outil exige l’un de ces marchés : il détermine les marchands pris en compte et la devise des prix. Les autres pays, la Belgique par exemple, sont refusés au lieu d’être remplacés par un voisin. Le paramètre facultatif language ne change que les noms et les libellés. Une réponse en anglais sur le marché français affiche toujours des euros, des marchands français et un lien vers la page de comparaison française.
Ce que renvoient les outils
Si vous demandez des sets dans un budget donné, l’assistant appelle search_sets. L’outil filtre par nom ou numéro de set, thème, budget, nombre de pièces, tranches d’âge telles que 18+ et statut de retrait, trie par prix, remise ou nouveauté et renvoie jusqu’à 20 sets par page. list_themes fournit les identifiants de thème. Un paramètre inconnu est refusé au lieu d’être ignoré : un filtre mal compris n’élargit donc pas la recherche en silence.
Lors de nos tests, la recherche textuelle trouvait les noms anglais, allemands, espagnols et italiens, mais pas les noms français : « orchidée » ne donnait aucun résultat, « orchid » si. Le numéro de set reste la recherche la plus fiable : demandez par exemple « Lego 10311 » plutôt que le nom français, qui s’affiche ensuite dans la réponse.
Pour un seul set, get_set_offers liste chaque offre avec le prix de l’article, le port, le total, la devise, l’heure de mise à jour du flux (feed_updated_at) et l’état du stock. Les offres dont le total livré est connu passent en tête, et le résultat indique le total connu le plus bas et le prix d’article le plus bas. Quand Brickfact ne connaît pas les frais de port d’une boutique, le port et le total restent vides (null). Lisez-le comme « inconnu », jamais comme « gratuit ».
L’état du stock (stock_status) vaut toujours not_verified. Un prix dans un flux ne prouve pas que le set est en stock, et les frais de port indiqués valent pour un seul set. Seuils de livraison gratuite, codes promo et règles du panier peuvent modifier le montant final ; seul le récapitulatif de commande du marchand fait foi.
get_set_details ajoute le prix conseillé, l’âge indiqué, le nombre de minifigurines, les dimensions et une date de retrait estimée. compare_sets met deux à quatre sets côte à côte.
Prix de l’article ou prix livré ?
Par défaut, price_basis vaut "item". Dans ce mode, le budget et le tri portent sur le seul prix du set, item_price est renseigné et total_price reste à null. Un set à 45 € avec 6,99 € de port entre ainsi dans un budget de 50 €, alors qu’il vous coûtera plus de 50 € une fois livré.
Avec "delivered", Brickfact utilise le total frais de port compris vers le marché choisi. Les offres dont le port est inconnu sont écartées avant le filtre de prix, le comptage et la pagination : total et chaque page ne comptent donc que des sets au total livré connu, sans trou entre les pages. La contrepartie : une boutique qui n’indique pas ses frais de port disparaît totalement de ces résultats.
Pour acheter, le prix livré est généralement le plus honnête. Un prix d’article bas dans une boutique étrangère cesse souvent d’être une affaire une fois ajoutés les frais d’envoi vers la France, et les collectionneurs raisonnent d’ailleurs le plus souvent port compris. Gardez le mode article pour les vues de catalogue où la livraison ne compte pas.
Deux sortes d’historique de prix
Brickfact tient deux historiques distincts, et les confondre mène à de mauvaises réponses.
L’historique des prix marchands (outil get_retail_price_history) enregistre chaque jour le prix livré le plus bas connu chez les marchands suivis d’un marché, dans sa devise. Amazon en est exclu, tout comme les jours où le port est inconnu ou estimé. Les jours passés sont calculés avec les règles de livraison actuelles pour le pays. Le résultat indique observation_days et first_observed_day. Cette série n’a commencé que le 12 octobre 2026 : demander une longue période ne garantit pas un long historique. Vérifiez la couverture avant de conclure.
L’historique de valeur sur le marché (outil get_price_history) est une autre série : l’estimation des sets neufs scellés, en euros, même pour le marché suisse ou américain. Elle indique ce que vaut un set scellé au fil du temps, le type de valeur qu’analyse notre étude sur l’évolution des prix Lego. Ce n’est pas un historique des prix pratiqués par les boutiques.
L’évaluation d’offre (outil assess_deal) compare l’offre livrée actuelle la moins chère, issue d’un flux de moins de 48 heures, au plus bas relevé chez les marchands. Elle répond at_or_below_recorded_low ou above_recorded_low, avec l’écart en pourcentage. S’il manque au moins deux jours relevés, ou si l’historique a plus de 48 heures, la réponse est insufficient_history, et sans offre exploitable no_delivered_offer. L’offre actuelle peut venir d’Amazon, même si l’historique l’exclut. Un résultat au plus bas relevé n’est pas un plus bas historique absolu et ne dit rien du prix du mois prochain.
Connecter le serveur MCP à d’autres assistants
Le Model Context Protocol est un standard ouvert qui relie des applications d’IA à des systèmes externes. L’assistant découvre les outils de Brickfact et les appelle quand votre question demande des données à jour : vous n’avez aucune requête à écrire vous-même.
| Paramètre | Valeur |
|---|---|
| URL du serveur | https://mcp.brickfact.com/mcp |
| Transport | Streamable HTTP (requêtes POST sans état) |
| Authentification | Aucune |
| Outils | 11, tous en lecture seule |
Tout client compatible avec les serveurs distants en Streamable HTTP se connecte avec cette URL. Les clients purement locaux qui ne parlent que stdio ont besoin d’une passerelle.
Dans ChatGPT, vous pouvez aussi connecter le serveur vous-même au lieu d’installer le plugin, par exemple si votre espace de travail autorise les serveurs MCP personnalisés mais pas le plugin de l’annuaire, ou s’il manque à votre plugin un outil de la liste ci-dessous. Le guide de connexion d’OpenAI décrit la marche à suivre : ouvrez ChatGPT Plugins, cliquez sur le bouton + puis sur Add custom MCP server, donnez un nom et une description, saisissez l’URL avec /mcp, sélectionnez « aucune authentification », validez l’avertissement de risque et choisissez Create as a plugin.
Les onze outils :
| Outil | Usage |
|---|---|
search_sets | Recherche par nom, numéro, thème, budget, pièces, âge ou retrait |
get_set_details | Caractéristiques, date de retrait estimée et offres |
get_set_offers | Offres d’un set avec frais de port |
compare_sets | Deux à quatre sets côte à côte |
list_themes | Noms et identifiants des thèmes |
get_retail_price_history | Prix marchands relevés, port compris |
assess_deal | Offre actuelle face au plus bas relevé |
get_price_history | Valeur des sets scellés en euros |
find_alternatives | Sets proches, moins chers ou plus petits |
render_sets | Fiches d’achat ou vue comparative |
get_app_handoff | Étapes pour finaliser une alerte de prix ou un ajout à la liste de suivi dans l’app Brickfact |
Que demander à l’assistant pour vos achats
Le serveur demande à l’assistant de reprendre le pays d’achat de la conversation et de le demander s’il manque : indiquez-le d’emblée. Ces demandes couvrent les principaux outils :
- « Trouve des sets Lego Star Wars à moins de 100 € livrés en France et affiche-les sous forme de fiches. »
- « Aide-moi à choisir un cadeau Lego à moins de 60 € livré en France pour un enfant de 10 ans qui aime les voitures. »
- « Compare les sets Lego 10311 et 10313 livrés en France, avec le nombre de pièces et le prix livré. »
- « Le prix actuel du set Lego 75192 en France est-il bon par rapport aux prix relevés chez les marchands ? Dis-moi sur combien de jours tu t’appuies. »
- « Trouve des alternatives moins chères au set Lego 75192 livrées en France. »
Les hôtes compatibles avec MCP Apps affichent des fiches de sets avec images, une vue comparative et des graphiques de l’historique des prix marchands. Ailleurs, l’assistant répond en texte avec les mêmes données. Si l’hôte permet aux apps de conserver un état, la fiche peut garder une sélection de six numéros de sets au plus. Cette sélection appartient à la fiche dans la conversation, pas à un compte Brickfact, et peut ne pas suivre dans une nouvelle conversation.
Ce que l’assistant ne peut pas faire
Le plugin et le serveur MCP ne lisent que des données publiques du catalogue. Ils ne peuvent rien acheter, ne demandent aucune donnée de paiement, ne voient pas votre collection Brickfact et ne modifient pas votre compte. Demandez à être prévenu quand le set Lego 10311 passe sous 30 €, et vous obtiendrez un relais vers l’app avec "created": false : un lien vers l’app Brickfact et les étapes pour y créer l’alerte. Rien n’est créé tant que vous ne l’avez pas confirmé dans l’app. Pour les alertes elles-mêmes, consultez notre guide pour créer des alertes de prix Lego.
Les prix d’une réponse ne sont jamais plus récents que le flux qui les fournit. Une bonne affaire peut être épuisée quelques minutes après une baisse : ouvrez le lien de comparaison renvoyé et vérifiez la boutique avant d’acheter.
Bonnes pratiques pour des réponses fiables
Quelques habitudes gardent les réponses justes quand les données changent :
- Commencez par un set et un marché, et vérifiez la devise et la base de prix dans chaque réponse avant d’ajouter d’autres pays.
- Considérez un port inconnu comme inconnu, jamais comme gratuit.
- Repérez l’heure de mise à jour du flux (
feed_updated_at) ou notez l’heure de votre question à côté des prix. - Traitez les résultats vides et les historiques courts comme des réponses normales, pas comme des erreurs.
- Après une erreur HTTP 429, respectez
Retry-After, et ne parcourez pas tout le catalogue page par page. - Utilisez le lien de comparaison renvoyé (
comparison_url) plutôt que de construire vous-même les adresses des pages de sets.
Pour comparer les prix à la main, l’explorateur de sets Lego présente les mêmes offres avec des filtres, et la page comment nous comparons les prix détaille les marchands suivis.
Autres sources de données Lego
Brickfact couvre les offres des marchands, pas les pièces ni le marché de l’occasion. Pour les pièces, les couleurs et les inventaires de sets, l’API de Rebrickable est la source habituelle ; l’API Brickset couvre les fiches de sets et les collections, et l’API BrickLink donne accès aux prix de sa place de marché, neuf ou d’occasion. Chacun de ces trois services exige sa propre clé et fixe ses propres règles d’utilisation.
Une API pour programmer des hubs et des moteurs Lego relève de la robotique, pas des données : notre guide pour programmer un robot Lego traite de SPIKE, de Mindstorms et de Python avec Pybricks. Brickfact est indépendant du groupe Lego.
