Utilisez les données Atlas.

Démarrage rapide

Définissez l'URL de base une fois, puis exécutez n'importe quel exemple ci-dessous.

ATLAS_API=https://www.elabel-atlas.eu/api/v1

Authentification

Les requêtes anonymes peuvent utiliser chaque endpoint de lecture public. Une clé augmente la limite de débit et est requise pour les opérations d'écriture des fournisseurs. Les propriétaires et administrateurs d'espaces de travail fournisseur peuvent créer une clé dans l'espace de travail connecté, sous Clés API. Si vous avez besoin d'une clé de lecture sans espace de travail fournisseur ou d'un accès en masse, écrivez à david@essentialcode.eu.

curl --fail --silent --show-error \
  -H "Authorization: Bearer $ATLAS_API_KEY" \
  "$ATLAS_API/public-records?limit=1"

Limites de débit

Chaque opération publique permet 60 requêtes anonymes par minute et par adresse, ou 600 par minute et par clé de lecture. Les réponses incluent les en-têtes limit, remaining et reset. Une requête au-delà de la limite renvoie HTTP 429 :

HTTP/1.1 429 Too Many Requests
retry-after: 60
x-ratelimit-limit: 60
x-ratelimit-remaining: 0

{"error":{"code":"rate_limited","message":"The public API rate limit was exceeded."}}

Endpoints de lecture publics

curl --fail --silent --show-error \
  "$ATLAS_API/search?q=Veltliner&limit=1"

{
  "query": "Veltliner",
  "records": [{
    "atlas_record_id": "QXSvIVqvHcRW-LjHtG88I",
    "name": "Grüner Veltliner 2025",
    "provider": { "name": "Demo Wine Cooperative" },
    "gtin": "4006381333931"
  }]
}

curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1"

{
  "records": [{
    "atlas_record_id": "ovPcoHyHMEbzdcGC_Zkm_",
    "name": "Grüner Veltliner Ried Steinberg 2024",
    "provider": { "name": "Glasswise" }
  }],
  "next_cursor": "eyJ1cGRhdGVkQXQiOjE3ODk1MDIxMjQ3MDcsImlkIjoib3ZQY29IeUhNRWJ6ZGNHQ19aa21fIn0"
}

curl --fail --silent --show-error \
  "$ATLAS_API/public-records/4006381333931"

{
  "gtin": "4006381333931",
  "records": [{
    "atlas_record_id": "QXSvIVqvHcRW-LjHtG88I",
    "name": "Grüner Veltliner 2025",
    "provider": { "name": "Demo Wine Cooperative" }
  }]
}

RECORD_ID=$(curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1" | jq -r '.records[0].atlas_record_id')
curl --fail --silent --show-error \
  "$ATLAS_API/public-records/by-id/$RECORD_ID"

{
  "atlas_record_id": "ovPcoHyHMEbzdcGC_Zkm_",
  "name": "Grüner Veltliner Ried Steinberg 2024",
  "provider": { "name": "Glasswise" },
  "atlas_updated_at": "2026-09-15T19:55:24.707Z"
}

Pagination

La liste publique des enregistrements renvoie next_cursor quand une page suivante existe. Renvoyez cette valeur opaque exacte avec les mêmes filtres. Ne la décodez ni ne la modifiez.

CURSOR=$(curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1" | jq -r '.next_cursor')
curl --fail --silent --show-error \
  "$ATLAS_API/public-records?limit=1&cursor=$CURSOR"

Langues des enregistrements publics

Les pages d'enregistrements publics ne localisent que les libellés propres à Atlas et les codes que définit l'E-Label Standard Format, dont le type de vin, les propriétés du vin, les codes pays, les clés de nutrition et les unités. Tout texte rédigé par le fournisseur reste exactement tel que fourni, y compris les noms et catégories d'ingrédients et tout texte d'emballage ou de consigne de tri écrit par le fournisseur.

Le premier code dans languages est toujours la langue principale de l'enregistrement, y compris quand Atlas ne peut pas rendre son interface dans cette langue. Une page propose le contenu principal et les langues prises en charge qui ont des traductions du fournisseur. Liez à une sélection avec ?lang=de ou ?lang=hr. Sans paramètre, Atlas utilise Accept-Language quand un contenu correspondant existe et redirige vers l'URL partageable correspondante.

Préférez les ingredients[] structurés pour préserver les indicateurs d'allergènes et de bio. N'utilisez ingredients_text que lorsque le fournisseur a une déclaration rédigée complète. Les fournisseurs peuvent ajouter des valeurs translations.{language} pour ingredients_text, designation_of_origin et chaque instruction packaging[].disposal. Le tableau packaging suit la longueur et l'ordre de la liste principale ; utilisez null pour une instruction qui doit se replier. Les traductions manquantes se replient sur la valeur principale de premier niveau. REST et MCP renvoient cette carte optionnelle, et JSON-LD utilise des valeurs balisées par langue. Cette carte fournie par le fournisseur est le seul moyen de faire varier un texte rédigé par le fournisseur entre les langues.

Le corps de requête du fournisseur suit l'E-Label Standard Format.

Sur les pages publiques, Atlas rend les propres codes du Standard (productType, color, sweetness, packagingGas, packagingType, materialType et collection) dans la langue de la page depuis le vocabulaire Standard publié. Toute autre valeur du fournisseur reste exactement telle que fournie.

MCP

Model Context Protocol, ou MCP, est une façon standard pour un client d'IA d'appeler des outils externes. e-label Atlas fournit un serveur Streamable HTTP anonyme à https://www.elabel-atlas.eu/mcp.

Le serveur expose search_elabels, lookup_elabel_by_gtin, get_elabel et list_elabels_updated_since.

Installer Atlas dans un agent

Choisissez votre client. Le plugin Claude Code et la configuration Codex incluent à la fois le guide de skill Atlas et les outils MCP en direct. Les autres clients se connectent au même serveur MCP en lecture seule.

claude plugin marketplace add https://www.elabel-atlas.eu/claude/marketplace.json && \
  claude plugin install elabel-atlas@elabel-atlas

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=e-label%20Atlas&connectorUrl=https%3A%2F%2Fwww.elabel-atlas.eu%2Fmcp

mkdir -p "$HOME/.agents/skills/elabel-atlas"
curl --fail --location   https://www.elabel-atlas.eu/api/v1/SKILL.md   --output "$HOME/.agents/skills/elabel-atlas/SKILL.md"
codex mcp add elabel-atlas --url https://www.elabel-atlas.eu/mcp

{
  "mcpServers": {
    "elabel-atlas": {
      "url": "https://www.elabel-atlas.eu/mcp"
    }
  }
}

{
  "mcpServers": {
    "elabel-atlas": {
      "httpUrl": "https://www.elabel-atlas.eu/mcp"
    }
  }
}