API et MCP gratuits
Tout ce que Vuntum publie sur les robots (fiches, affirmations sourcées, prix, disponibilités, comparaisons, changements) peut être lu par un programme ou par une IA, sans clé ni inscription et sans rien payer. Chaque valeur arrive avec sa source, son niveau de preuve et sa date.
L’essentiel
- Gratuit : pas de clé ni de compte pour l’usage courant. Un accès pro, par clé, existe pour l’usage commercial et les gros volumes.
- Licence CC BY-NC 4.0 : réutilisation libre des données factuelles hors usage commercial, avec attribution obligatoire (voir les conditions).
- API REST :
https://vuntum.com/api/v1, en lecture seule, JSON, 120 requêtes par minute et 300 requêtes par jour et par adresse IP. Description OpenAPI 3.1 : openapi.json. - Serveur MCP :
https://vuntum.com/mcp(HTTP Streamable), en lecture seule, 20 outils, 60 requêtes par minute et 100 appels d’outils par jour par adresse IP. Rien à installer. - Deux langues : les textes sont en français par défaut, en anglais avec
?lang=en(API) oulocale: "en"(MCP, accepté par tous les outils, qui donnent alors aussi des adresses de pages anglaises). Les descriptions des outils MCP sont en anglais, comme la convention du protocole.
Exemples de requêtes API
Chaque exemple se copie tel quel dans un terminal. Les réponses ont toutes la même forme : data (le résultat), meta (date, licence, attribution) et, pour les listes, un curseur de pagination. Ajoutez limit= pour réduire la liste.
Trouver des robots
Les robots-jouets
curl 'https://vuntum.com/api/v1/robots?segment=toy&limit=5'Les humanoïdes
curl 'https://vuntum.com/api/v1/robots?category=humanoide&limit=5'Les robots de ménage
curl 'https://vuntum.com/api/v1/robots?utility=menage&limit=5'Les robots qui montent les escaliers (affirmation validée)
curl 'https://vuntum.com/api/v1/robots?capability=escaliers&limit=5'Les robots programmables (SDK public, Python, ROS)
curl 'https://vuntum.com/api/v1/robots?programmable=true&limit=5'Recherche par mot
curl 'https://vuntum.com/api/v1/search?q=unitree&type=robot&limit=5'
Lire une fiche et ses preuves
La fiche complète d’un robot
curl 'https://vuntum.com/api/v1/robots/unitree-g1'Toutes ses affirmations, avec source, citation et niveau de preuve
curl 'https://vuntum.com/api/v1/robots/unitree-g1/claims'La fiche d’un fabricant
curl 'https://vuntum.com/api/v1/manufacturers/unitree'
Comparer
Deux robots côte à côte
curl 'https://vuntum.com/api/v1/compare?robots=unitree-g1,unitree-h1'Jusqu’à quatre robots
curl 'https://vuntum.com/api/v1/compare?robots=unitree-g1,unitree-h1,unitree-r1-air'
Prix et disponibilité
Les prix observés sur le marché américain
curl 'https://vuntum.com/api/v1/prices?market=US&limit=10'La disponibilité sur le marché américain
curl 'https://vuntum.com/api/v1/availability?market=US&limit=10'Les prix publics officiels, avec leur source
curl 'https://vuntum.com/api/v1/claims?predicate=price.msrp&limit=10'
Suivre ce qui change
Le journal des publications, corrections et changements de prix
curl 'https://vuntum.com/api/v1/changes?limit=20'Les statistiques de l’observatoire
curl 'https://vuntum.com/api/v1/observatory'
Tous les points d’accès, leurs paramètres et leurs codes d’erreur sont décrits dans openapi.json. Les réponses portent un ETag et acceptent les requêtes conditionnelles ; les erreurs suivent la RFC 9457.
Le serveur MCP
MCP (Model Context Protocol) est la prise standard qui permet à un assistant IA d’interroger une source de données. Une fois Vuntum ajouté comme connecteur, l’assistant répond à partir de nos données sourcées plutôt que de sa mémoire, et indique la fiche à consulter. L’adresse à fournir est toujours la même : https://vuntum.com/mcp, sans authentification.
Questions à poser à votre assistant
Quelques exemples, par thème, qui font appel aux outils du serveur.
- Trouver
- Quels robots peuvent monter des escaliers, et qui l’affirme ?
- Quels robots pour la maison puis-je programmer en Python ou avec ROS 2 ?
- Quels projets open source de robotique humanoïde Vuntum référence-t-il ?
- Comparer
- Compare l’Unitree G1 et l’Unitree H1 : qu’est-ce qui diffère, et qu’est-ce qui n’est pas communiqué ?
- Entre ces trois robots, lequel a la meilleure preuve pour son autonomie ?
- Prix et disponibilité
- Combien coûte l’Unitree G1 aux États-Unis et en Chine, et à quelle date ce prix a-t-il été relevé ?
- Ce robot est-il vendu en Europe aujourd’hui ?
- Vérifier
- D’où vient ce chiffre d’autonomie, et est-il annoncé par le fabricant ou mesuré par un tiers ?
- Explique-moi comment Vuntum classe ses niveaux de preuve.
- Suivre
- Qu’est-ce qui a changé dans la base cette semaine ?
- Quels articles récents de Vuntum parlent de robots humanoïdes ?
Clients MCP : ce que nous avons testé
Nous distinguons ce que nous avons fait tourner nous-mêmes de ce que nous recopions de la documentation du client. Les essais ont été faits depuis un serveur, les 3 et 28 octobre 2026, contre l’adresse publique du serveur (pas contre une copie locale).
Testés par nous
Claude Code
Testé : fonctionne. Le serveur a été ajouté à Claude Code, qui a appelé l’outil de prix sur l’Unitree G1 et répondu avec les deux prix (Chine et États-Unis) et leur date. Une commande suffit :
claude mcp add --transport http vuntum https://vuntum.com/mcpOu, pour un projet, dans le fichier .mcp.json :
{
"mcpServers": {
"vuntum": {
"type": "http",
"url": "https://vuntum.com/mcp"
}
}
}Codex CLI (OpenAI)
Configuration testée : acceptée. Codex enregistre le serveur comme serveur HTTP Streamable, l’affiche comme actif et sans authentification à fournir. Nous avons aussi rejoué à la main la poignée de main du protocole et un appel d’outil contre le serveur public, sans erreur ; nous n’avons pas fait répondre un modèle Codex. Une commande suffit :
codex mcp add vuntum --url https://vuntum.com/mcpOu, à la main, dans ~/.codex/config.toml :
[mcp_servers.vuntum]
url = "https://vuntum.com/mcp"Gemini CLI (Google)
Testé : fonctionne. Gemini CLI se connecte au serveur et le déclare « Connected » (gemini mcp list). Il refuse les serveurs d’un dossier qu’il ne considère pas comme fiable : lancez-le dans un dossier de confiance. Une commande suffit :
gemini mcp add --scope user --transport http vuntum https://vuntum.com/mcpOu, à la main, dans ~/.gemini/settings.json :
{
"mcpServers": {
"vuntum": {
"url": "https://vuntum.com/mcp",
"type": "http"
}
}
}Claude Desktop, par le fichier de configuration (passerelle mcp-remote)
Passerelle testée : fonctionne. Claude Desktop lit ce fichier pour lancer un programme local ; la passerelle mcp-remote relie ce programme au serveur distant. Nous avons essayé la passerelle elle-même (16 outils listés, un appel réussi), mais pas l’application Claude Desktop. Il faut Node.js. Dans l’application, ouvrez Settings > Developer > Edit Config (libellés anglais) et ajoutez :
{
"mcpServers": {
"vuntum": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://vuntum.com/mcp"
]
}
}
}Votre propre programme (SDK officiel)
Testé : fonctionne. Avec le SDK TypeScript officiel (@modelcontextprotocol/sdk), vingt lignes suffisent pour lister les outils et en appeler un. Un exemple et un contrôle prêts à lancer sont dans le dépôt public du serveur.
Configuration documentée, pas encore testée par nous
Nous ne pouvons pas ouvrir ces applications depuis notre serveur. Les réglages ci-dessous suivent leur documentation ; si l’un d’eux ne marche pas chez vous, écrivez-nous et nous corrigerons la page.
claude.ai et Claude Desktop (connecteur personnalisé)
Dans Personnaliser > Connecteurs, choisissez Ajouter un connecteur personnalisé, collez l’adresse https://vuntum.com/mcp, laissez l’authentification vide, puis validez. Dans une conversation, activez-le depuis le menu +, rubrique Connecteurs. Sur les offres Team et Enterprise, un propriétaire de l’organisation l’ajoute d’abord.
ChatGPT
Les serveurs MCP distants demandent le mode développeur (Paramètres > Sécurité et connexion > Mode développeur, sur les offres qui le proposent). Créez ensuite une application avec l’adresse https://vuntum.com/mcp et Pas d’authentification. Les noms de menus changent souvent chez OpenAI : suivez son guide du mode développeur.
Cursor
Dans ~/.cursor/mcp.json (ou .cursor/mcp.json dans un projet) :
{
"mcpServers": {
"vuntum": {
"url": "https://vuntum.com/mcp"
}
}
}VS Code
Dans .vscode/mcp.json :
{
"servers": {
"vuntum": {
"type": "http",
"url": "https://vuntum.com/mcp"
}
}
}Limites à connaître
- Au-delà de 60 requêtes par minute et par adresse IP, le serveur MCP répond 429 avec
Retry-After: 60; l’API est limitée à 120 par minute et à 300 par jour et par adresse (2 000 pour les connecteurs d’assistants IA, les moteurs de recherche et les services de badges), avec des en-têtesRateLimit-*explicites ; au-delà du quota du jour, elle répond 429 avecRetry-Afterjusqu’à minuit UTC et le lien de l’accès pro. Une session de client compte aussi l’ouverture et la liste des outils dans cette limite par minute. - L’accès gratuit au serveur MCP compte aussi 100 appels d’outils par jour et par adresse IP (journée UTC). L’ouverture d’une session et la liste des outils n’y entrent pas. Au-delà, le serveur répond 429 avec un message qui donne le lien de l’accès pro, jusqu’à minuit UTC.
- Seules les données publiées sont servies. Une valeur absente veut dire que nous n’avons pas encore trouvé de source fiable, pas que la réponse est « non ».
- Pour un usage en volume, préférez l’export complet (JSON Lines ou CSV) à des milliers de requêtes.
Licence et attribution
Les données factuelles sont publiées sous licence CC BY-NC 4.0 : vous pouvez les copier, les transformer et les redistribuer hors usage commercial, à condition de citer la source. L’usage commercial demande l’accès pro. Les articles, guides et analyses restent protégés.
Citation attendue : Source : Vuntum (https://vuntum.com), licence CC BY-NC 4.0, avec un lien vers la fiche concernée.
Conditions d’utilisation
- Attribution obligatoire. Chaque réponse du serveur MCP porte un champ
attribution, par exemple « Source : Vuntum, https://vuntum.com/fr/robots/g1, CC BY-NC 4.0 », et chaque réponse de l’API un champmeta.attribution. Il accompagne les données partout où elles sont montrées, avec son lien. - Pas d’usage commercial sans l’accès pro. Le champ
licensede chaque réponse MCP le rappelle (commercialUse), comme le champmeta.commercialUsede l’API. Un assistant IA qui cite nos données à quelqu’un, avec l’attribution, est le bienvenu et reste dans l’accès gratuit. - Versions antérieures. Les versions du jeu de données publiées avant le 24 octobre 2026 restent sous licence CC BY 4.0 : ces conditions valent pour les données servies depuis cette date.
- Jeu de données mensuel. Pour travailler hors ligne ou citer une version précise, un instantané mensuel des principales caractéristiques est publié sur Hugging Face, sous la même licence, avec un journal des changements et une citation prête à copier.
Accès pro
Pour un usage commercial ou en volume, le serveur MCP et l’API REST acceptent une clé : quota du jour fixé pour chaque clé (20 000 appels d’outils par défaut), 600 requêtes par minute et licence d’usage commercial des données, indiquée dans le champ license de chaque réponse. La clé s’envoie dans l’en-tête Authorization: Bearer <clé> ou X-Vuntum-Key. Une clé inconnue ou révoquée est refusée (403), jamais ramenée en silence à l’accès gratuit. L’export complet en temps réel de l’API (/export/full.jsonl et /export/robots.csv) est réservé aux clés pro ; en accès gratuit, le jeu ouvert hebdomadaire de Hugging Face le remplace.
Pour obtenir une clé, remplissez le formulaire de la page entreprise ou écrivez à contact@vuntum.com, en décrivant l’usage prévu. Une clé n’est montrée qu’une fois, à sa création : nous n’en gardons qu’une empreinte et ne pouvons pas la retrouver. Une clé perdue est révoquée puis remplacée.
Alertes par webhook (clé pro)
Une clé pro peut recevoir une alerte à chaque changement de prix ou de disponibilité d’une liste de robots. Il n’existe pas de point d’accès pour s’abonner : l’abonnement (liste de robots, adresse https de réception, secret de signature propre à l’abonnement) est créé par Vuntum à votre demande, et le secret vous est remis une seule fois. Sans abonnement actif sur une clé pro active, rien n’est envoyé ; une clé révoquée arrête les envois.
Chaque envoi est une requête POST en JSON portant un changement tel que le décrit get_change_history : id, entityType (robot), entityId, kind (price_changed ou availability_changed), robot (slug et name), summary (phrase en français), summaryEn (phrase en anglais) et createdAt (date ISO 8601). Les en-têtes Vuntum-Event (la nature du changement) et Vuntum-Delivery (identifiant de l’envoi) l’accompagnent. Répondez par un code 2xx pour accuser réception.
Vérifier la signature : l’en-tête Vuntum-Signature vaut t=<secondes>,v1=<hex>. Recalculez HMAC-SHA256(secret, "<secondes>.<corps brut reçu>") en hexadécimal sur le corps exact reçu (avant tout décodage JSON), comparez-le à v1 en temps constant (crypto.timingSafeEqual en Node, hmac.compare_digest en Python) et refusez l’envoi si t s’écarte de plus de 5 minutes de votre horloge.
Délai d’attente de 5 secondes par envoi, aucune redirection suivie, adresse en https sur le port 443 uniquement, adresses privées ou locales refusées. En cas d’échec, 5 essais au total (1, 5, 30 puis 120 minutes d’intervalle), puis l’envoi est abandonné. Un même changement peut arriver deux fois en cas de réponse perdue : utilisez id pour dédoublonner.
Pour le reste (exports, llms.txt, jeu de données) : Données et API. Le serveur MCP est aussi inscrit au registre officiel du protocole sous le nom com.vuntum/mcp, et son dépôt public contient les exemples de code.