API e server MCP
I dati di CompoAtlas possono essere interrogati direttamente, in sola lettura, con una chiave concessa su richiesta: tramite un’API JSON o un server MCP che gli assistenti di IA (Claude, ChatGPT e altri) possono usare come connettore. Le risposte sono quelle delle pagine, con fonti ufficiali datate.
Testi, analisi, corrispondenze di nomi, sintesi di pareri e pagine di CompoAtlas formano una banca dati appartenente a Verity Score, protetta dal diritto del costitutore di banche dati (Codice della proprietà intellettuale francese, articoli L341-1 e seguenti; direttiva 96/9/CE). La breve citazione con un link alla pagina è libera. È consentita la scansione da parte dei robot dei motori di ricerca e degli assistenti di IA per indicizzare le pagine, rispondere agli utenti e addestrare i modelli, nei limiti del file robots.txt. Ogni altra estrazione o riutilizzo di una parte sostanziale, anche tramite un programma, richiede un accordo scritto (contact@compoatlas.com). I dati pubblici originali conservano la propria licenza (pagina Fonti); la tabella dei cosmetici registrati da Open Beauty Facts, con l’abbinamento dei relativi ingredienti, e la tabella separata degli integratori Open Food Facts con componenti riconosciuti sono distribuite sotto ODbL (pagina Dati aperti). I richiami canadesi conservano OGL-Canada 2.0: contiene informazioni concesse in licenza ai sensi della licenza di governo aperto del Canada.
Accesso
I dati dell’API e il server MCP richiedono una chiave personale, concessa su richiesta, per ora gratuita. Inviala nell’intestazione Authorization: Bearer <key> (oppure X-Api-Key). Ogni chiave ha una quota giornaliera. Senza una chiave valida viene restituito un errore 401; oltre la quota, un errore 429.
curl -H "Authorization: Bearer <key>" https://compoatlas.com/api/v1/ingredients/phenoxyethanolAPI JSON
GET /api/v1/ingredients/{slug}: stato di un ingrediente. Esempio:/api/v1/ingredients/phenoxyethanolGET /api/v1/products/{barcode}: composizione registrata e datata di un cosmetico o integratore alimentare (DSLD, Open Food Facts), con analisi degli ingredienti; le schede prodotto sono in franceseGET /api/v1/alerts?barcode=…(oppuresubstance=,brand=): allerte Safety GateSistema di allerta rapida dell’UE per i prodotti pericolosi non alimentari. dell’UE sui prodotti cosmetici. Esempio:/api/v1/alerts?substance=hydroquinonePOST /api/v1/reportcon{"products": [{"gtin": …, "ingredients": …}]}: rapporto normativo per un massimo di 200 prodotti (ingrediente vietato, allerta Safety Gate, elenco mancante; una restrizione non è una non conformità); nulla viene memorizzatoGET /api/v1/search?q=…ePOST /api/v1/analyzecon{"text": "Aqua, Glycerin, …"}- Descrizione OpenAPI: /api/v1/openapi.json
Server MCP
Indirizzo: https://compoatlas.com/mcp (Streamable HTTP, con la stessa chiave dell’API), compatibile con la versione del protocollo 2026-07-28 e con le versioni del 2025 che usano ancora lo scambio initialize. 9 strumenti di sola lettura: get_upcoming_changes, get_supplement_declaration, search, get_ingredient, get_product, search_alerts, get_supplement_nutrient, get_supplement_ingredient, analyze_ingredient_list. Le risposte testuali sono in francese oppure in inglese con lang: "en" per gli strumenti che lo offrono.
Privacy
Il server non conserva le domande, salvo l’indirizzo di una richiesta fallita, conservato per 7 giorni per correggere il sito (vedi le note legali).