Használja az Atlas adatait.

Gyors kezdés

Állítsa be az alap URL-t egyszer, majd futtassa az alábbi példák bármelyikét.

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

Hitelesítés

Névtelen kérések minden nyilvános olvasási endpointot használhatnak. Egy kulcs megnöveli a kérési limitet, és kötelező a szolgáltatói írási műveletekhez. A szolgáltatói munkaterületek tulajdonosai és adminisztrátorai a bejelentkezett munkaterületen hozhatnak létre kulcsot az API kulcsok alatt. Ha szolgáltatói munkaterület nélküli olvasási kulcsra vagy tömeges hozzáférésre van szüksége, írjon a(z) david@essentialcode.eu címre.

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

Kérési limitek

Minden nyilvános művelet percenként 60 névtelen kérést engedélyez címenként, vagy 600-at olvasási kulcsonként. A válaszok limit, remaining és reset fejléceket tartalmaznak. A limit feletti kérés HTTP 429-et ad vissza:

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."}}

Nyilvános olvasási endpointok

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"
}

Lapozás

A nyilvános rekordlista next_cursor-t ad vissza, ha van másik oldal. Küldje ezt a pontos átlátszatlan értéket ugyanazokkal a szűrőkkel. Ne dekódolja és ne szerkessze.

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"

Nyilvános rekordok nyelvei

A nyilvános rekordoldalak csak az Atlas saját címkéit és az E-Label Standard Format által meghatározott kódokat honosítják, beleértve a bortípust, borjellemaőket, országkódokat, tápérték-kulcsokat és mértékegységeket. Minden szolgáltató által írt szöveg pontosan úgy marad, ahogy megadták, beleértve az összetevő-neveket és -kategóriákat, valamint minden szolgáltató által írt csomagolási vagy ártalmatlanítási szöveget.

A languages első kódja mindig a rekord elsődleges nyelve, még akkor is, ha az Atlas nem tudja a felületét azon a nyelven megjeleníteni. Az oldal felajánlja az elsődleges tartalmat és a szolgáltatói fordításokkal rendelkező támogatott nyelveket. Link a választáshoz a ?lang=de vagy ?lang=hr segítségével. Paraméter nélkül az Atlas az Accept-Language-t használja, ha létezik egyező tartalom, és átirányít a helyes megosztható URL-re.

Részesítse előnyben a strukturált ingredients[]-t, hogy megmaradjanak az allergén és bio jelölések. Az ingredients_text-et csak akkor használja, ha a szolgáltató teljes prózai nyilatkozattal rendelkezik. A szolgáltatók translations.{language} értékeket adhatnak az ingredients_text-hez, a designation_of_origin-hez és minden packaging[].disposal utasításhoz. A packaging tömb követi az elsődleges lista hosszát és sorrendjét; használjon null-t olyan utasításhoz, amely visszaesik az elsődleges értékre. A hiányzó fordítások visszaesnek a legfelső szintű elsődleges értékre. A REST és MCP visszaadja ezt az opcionális térképet, a JSON-LD pedig a nyelvcímkézett értékeket használja. Ez a szolgáltató által megadott térkép az egyetlen módja annak, hogy a szolgáltató szövege nyelvek között változzon.

A szolgáltatói kérés törzse az E-Label Standard Formatot követi.

A nyilvános oldalakon az Atlas a saját Standard kódjait (productType, color, sweetness, packagingGas, packagingType, materialType és collection) az oldal nyelvén jeleníti meg a Standard közzétett szókészletéből. Minden más szolgáltatói érték pontosan úgy marad, ahogy megadták.

MCP

A Model Context Protocol, vagy MCP, a szabványos módja annak, ahogy egy AI kliens külső eszközöket hív. Az e-label Atlas névtelen Streamable HTTP szervert kínál a https://www.elabel-atlas.eu/mcp címen.

A szerver a search_elabels, lookup_elabel_by_gtin, get_elabel és list_elabels_updated_since eszközöket teszi elérhetővé.

Telepítse az Atlast egy ügynökbe

Válassza ki a kliensét. A Claude Code plugin és a Codex beállítás egyaránt tartalmazza az Atlas skill útmutatót és az élő MCP eszközöket. Más kliensek ugyanahhoz a csak olvasható MCP szerverhez csatlakoznak.

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"
    }
  }
}