Používejte data Atlas.

Rychlý start

Nastavte základní URL jednou a pak spusťte libovolný příklad níže.

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

Autentizace

Anonymní požadavky mohou používat každý veřejný čtecí endpoint. Klíč zvyšuje limit požadavků a je vyžadován pro zapisovací operace poskytovatelů. Vlastníci a administrátoři pracovních prostorů poskytovatelů mohou klíč vytvořit v přihlášeném pracovním prostoru pod API klíče. Pokud potřebujete čtecí klíč bez pracovního prostoru poskytovatele nebo hromadný přístup, napište na david@essentialcode.eu.

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

Limity požadavků

Každá veřejná operace povoluje 60 anonymních požadavků za minutu na adresu nebo 600 za minutu na čtecí klíč. Odpovědi obsahují hlavičky limit, remaining a reset. Požadavek nad limitem vrací 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."}}

Veřejné čtecí endpointy

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

Stránkování

Veřejný seznam záznamů vrací next_cursor, pokud existuje další stránka. Pošlete tuto přesnou neprůhlednou hodnotu se stejnými filtry. Nedekódujte ji ani neupravujte.

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"

Jazyky veřejných záznamů

Stránky veřejných záznamů lokalizují pouze vlastní popisky Atlasu a kódy definované ve E-Label Standard Format, včetně typu vína, vlastností vína, kódů zemí, nutričních klíčů a jednotek. Každý text napsaný poskytovatelem zůstává přesně tak, jak byl dodán, včetně názvů a kategorií složek a veškerého textu o balení či likvidaci, který poskytovatel napsal.

První kód v languages je vždy primární jazyk záznamu, včetně případů, kdy Atlas nemůže své rozhraní v tomto jazyce vykreslit. Stránka nabízí primární obsah a podporované jazyky, které mají překlady poskytovatele. Odkazujte na výběr pomocí ?lang=de nebo ?lang=hr. Bez parametru používá Atlas Accept-Language, když existuje odpovídající obsah, a přesměruje na odpovídající sdílitelnou URL.

Preferujte strukturované ingredients[], aby se zachovaly příznaky alergenů a bio. ingredients_text používejte jen tehdy, když má poskytovatel úplnou deklaraci v próze. Poskytovatelé mohou přidat hodnoty translations.{language} pro ingredients_text, designation_of_origin a každou instrukci packaging[].disposal. Pole packaging se řídí délkou a pořadím primárního seznamu; pro instrukci, která má spadnout na primární hodnotu, použijte null. Chybějící překlady padají na primární hodnotu nejvyšší úrovně. REST i MCP vrací tuto volitelnou mapu a JSON-LD používá hodnoty označené jazykem. Tato mapa dodávaná poskytovatelem je jediný způsob, jak se text poskytovatele mění mezi jazyky.

Tělo požadavku poskytovatele se řídí E-Label Standard Format.

Na veřejných stránkách vykresluje Atlas vlastní kódy Standardu (productType, color, sweetness, packagingGas, packagingType, materialType a collection) v jazyce stránky z publikovaného slovníku Standardu. Každá jiná hodnota poskytovatele zůstává přesně tak, jak byla dodána.

MCP

Model Context Protocol, neboli MCP, je standardní způsob, jak AI klient volá externí nástroje. e-label Atlas poskytuje anonymní Streamable HTTP server na https://www.elabel-atlas.eu/mcp.

Server vystavuje search_elabels, lookup_elabel_by_gtin, get_elabel a list_elabels_updated_since.

Nainstalujte Atlas do agenta

Vyberte si klienta. Plugin Claude Code a nastavení Codex obsahují jak vodítko skillu Atlas, tak živé MCP nástroje. Ostatní klienti se připojují ke stejnému MCP serveru jen pro čtení.

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