API und MCP-Server

Die Daten von CompoAtlas können direkt und schreibgeschützt mit einem auf Anfrage vergebenen Schlüssel abgefragt werden: über eine JSON-API oder einen MCP-Server, den KI-Assistenten (Claude, ChatGPT und andere) als Konnektor verwenden können. Die Antworten entsprechen den Seiten und enthalten datierte amtliche Quellen.

Die Texte, Analysen, Namenszuordnungen, Zusammenfassungen von Stellungnahmen und Seiten von CompoAtlas bilden eine Datenbank von Verity Score, geschützt durch das Recht des Datenbankherstellers (französisches Gesetzbuch des geistigen Eigentums, Artikel L341-1 ff.; EU-Richtlinie 96/9/EG). Kurze Zitate mit Link zur Seite sind frei. Crawling durch Suchmaschinen- und KI-Assistenten-Roboter zum Indexieren, Beantworten von Nutzerfragen und Trainieren ihrer Modelle ist im Rahmen von robots.txt erlaubt. Jede andere Entnahme oder Weiterverwendung eines wesentlichen Teils, auch durch ein Programm, erfordert eine schriftliche Vereinbarung (contact@compoatlas.com). Öffentliche Originaldaten behalten ihre Lizenz (Quellenseite); die Tabelle der aus Open Beauty Facts erfassten Kosmetika mit Inhaltsstoffzuordnung und die getrennte Open-Food-Facts-Tabelle der Nahrungsergänzungsmittel mit erkannten Bestandteilen stehen unter ODbL (Seite zu offenen Daten). Kanadische Rückrufe behalten OGL-Canada 2.0: Enthält Informationen, die unter der Open Government Licence Canada lizenziert sind.

Zugang

API-Daten und MCP-Server erfordern einen persönlichen Schlüssel, der auf Anfrage vergeben wird und derzeit kostenlos ist. Senden Sie ihn im Header Authorization: Bearer <key> (oder X-Api-Key). Jeder Schlüssel hat ein Tageskontingent. Ohne gültigen Schlüssel wird Fehler 401 zurückgegeben, bei Überschreitung des Kontingents Fehler 429.

curl -H "Authorization: Bearer <key>" https://compoatlas.com/api/v1/ingredients/phenoxyethanol

Zugang beantragen

JSON-API

GET /api/v1/ingredients/{slug}: Status eines Inhaltsstoffs. Beispiel: /api/v1/ingredients/phenoxyethanol
GET /api/v1/products/{barcode}: erfasste, datierte Zusammensetzung eines Kosmetikums oder Nahrungsergänzungsmittels (DSLD, Open Food Facts), mit Analyse der Inhaltsstoffe; Produktseiten auf Französisch
GET /api/v1/alerts?barcode=… (oder substance=, brand=): EU-Safety-Gate-Warnungen zu Kosmetika. Beispiel: /api/v1/alerts?substance=hydroquinone
POST /api/v1/report mit {"products": [{"gtin": …, "ingredients": …}]}: regulatorischer Bericht für bis zu 200 Produkte (verbotener Inhaltsstoff, Safety-Gate-Warnung, fehlende Liste; eine Einschränkung ist kein Rechtsverstoß); nichts wird gespeichert
GET /api/v1/search?q=… und POST /api/v1/analyze mit {"text": "Aqua, Glycerin, …"}
OpenAPI-Beschreibung: /api/v1/openapi.json

MCP-Server

Endpunkt: https://compoatlas.com/mcp (Streamable HTTP, gleicher Schlüssel wie für die API), kompatibel mit Protokollversion 2026-07-28 und den Versionen von 2025, die noch den initialize-Handshake verwenden. 9 schreibgeschützte Werkzeuge: get_upcoming_changes, get_supplement_declaration, search, get_ingredient, get_product, search_alerts, get_supplement_nutrient, get_supplement_ingredient, analyze_ingredient_list. Textantworten sind auf Französisch oder mit lang: "en" auf Englisch, sofern das Werkzeug dies anbietet.

Datenschutz

Der Server speichert keine gestellten Fragen, mit Ausnahme der Adresse einer fehlgeschlagenen Anfrage, die sieben Tage zur Fehlerbehebung aufbewahrt wird (siehe rechtliche Hinweise).