API y servidor MCP

Los datos de CompoAtlas pueden consultarse directamente, en modo de solo lectura, con una clave concedida previa solicitud: mediante una API JSON o un servidor MCP que los asistentes de IA (Claude, ChatGPT y otros) pueden utilizar como conector. Las respuestas son las de las páginas, con fuentes oficiales fechadas.

Los textos, análisis, correspondencias de nombres, resúmenes de dictámenes y páginas de CompoAtlas forman una base de datos perteneciente a Verity Score, protegida por el derecho del fabricante de bases de datos (Código de la Propiedad Intelectual francés, artículos L341-1 y siguientes; Directiva 96/9/CE). La cita breve con un enlace a la página es libre. Se permite el rastreo por robots de buscadores y asistentes de IA para indexar las páginas, responder a sus usuarios y entrenar sus modelos, dentro de los límites del archivo robots.txt. Cualquier otra extracción o reutilización de una parte sustancial, incluso mediante un programa, requiere un acuerdo escrito (contact@compoatlas.com). Los datos públicos originales conservan su licencia (página Fuentes); la tabla de cosméticos registrados a partir de Open Beauty Facts, con la correspondencia de sus ingredientes, y la tabla separada de complementos de Open Food Facts con componentes reconocidos se distribuyen bajo la ODbL (página Datos abiertos). Las retiradas canadienses conservan OGL-Canada 2.0: contiene información sujeta a la Licencia de Gobierno Abierto de Canadá.

Acceso

Los datos de la API y el servidor MCP requieren una clave personal, concedida previa solicitud y gratuita por ahora. Envíala en la cabecera Authorization: Bearer <key> (o X-Api-Key). Cada clave tiene una cuota diaria. Sin una clave válida se devuelve un error 401; al superar la cuota, un error 429.

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

Solicitar acceso

API JSON

GET /api/v1/ingredients/{slug}: situación de un ingrediente. Ejemplo: /api/v1/ingredients/phenoxyethanol
GET /api/v1/products/{barcode}: composición registrada y fechada de un cosmético o complemento alimenticio (DSLD, Open Food Facts), con análisis de ingredientes; las fichas de producto están en francés
GET /api/v1/alerts?barcode=… (o substance=, brand=): alertas Safety Gate de la UE sobre productos cosméticos. Ejemplo: /api/v1/alerts?substance=hydroquinone
POST /api/v1/report con {"products": [{"gtin": …, "ingredients": …}]}: informe reglamentario para hasta 200 productos (ingrediente prohibido, alerta Safety Gate, lista ausente; una restricción no implica falta de conformidad); no se almacena nada
GET /api/v1/search?q=… y POST /api/v1/analyze con {"text": "Aqua, Glycerin, …"}
Descripción OpenAPI: /api/v1/openapi.json

Servidor MCP

Dirección: https://compoatlas.com/mcp (Streamable HTTP, con la misma clave que la API), compatible con la versión de protocolo 2026-07-28 y con las versiones de 2025 que todavía utilizan el intercambio initialize. 9 herramientas de solo lectura: get_upcoming_changes, get_supplement_declaration, search, get_ingredient, get_product, search_alerts, get_supplement_nutrient, get_supplement_ingredient, analyze_ingredient_list. Las respuestas de texto están en francés, o en inglés con lang: "en" para las herramientas que lo ofrecen.

Privacidad

El servidor no conserva las preguntas realizadas, salvo la dirección de una solicitud fallida, conservada durante 7 días para corregir el sitio (véase el aviso legal).