Uporabite podatke Atlas.

Hiter začetek

Nastavite osnovni URL enkrat, nato zaženite kateri koli primer spodaj.

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

Avtentikacija

Anonimni zahtevki lahko uporabljajo vsak javni bralni endpoint. Ključ dvigne omejitev zahtevkov in je obvezen za pisanje ponudnikov. Lastniki in administratorji delovnih prostorov ponudnikov lahko ključ ustvarijo v prijavljenem delovnem prostoru pod API ključi. Če potrebujete bralni ključ brez delovnega prostora ponudnika ali množični dostop, pišite na david@essentialcode.eu.

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

Omejitve zahtevkov

Vsaka javna operacija dovoli 60 anonimnih zahtevkov na minuto na naslov ali 600 na minuto na bralni ključ. Odgovori vsebujejo glave limit, remaining in reset. Zahtevek nad omejitvijo vrne 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."}}

Javni bralni endpointi

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

Stranjenje

Javni seznam zapisov vrne next_cursor, ko obstaja naslednja stran. Pošljite to natančno neprosojno vrednost z istimi filtri. Ne dekodirajte je in ne urejajte.

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"

Jeziki javnih zapisov

Strani javnih zapisov lokalizirajo samo lastne oznake Atlas in kode, definirane v E-Label Standard Format, vključno s tipom vina, lastnostmi vina, kodami držav, hranilnimi ključi in enotami. Vsako besedilo, ki ga je napisal ponudnik, ostane točno tako, kot je bilo dostavljeno, vključno z imeni in kategorijami sestavin ter vsakim besedilom o embalaži ali odstranjevanju, ki ga je napisal ponudnik.

Prva koda v languages je vedno primarni jezik zapisa, tudi ko Atlas ne more svojega vmesnika v tem jeziku prikazati. Stran ponuja primarno vsebino in podprte jezike s ponudnikovimi prevodi. Povezujte na izbiro prek ?lang=de ali ?lang=hr. Brez parametra Atlas uporabi Accept-Language, ko obstaja ujemajoča vsebina, in preusmeri na ustrezen URL za deljenje.

Raje uporabite strukturirane ingredients[], da se ohranijo zastavice alergenov in bio. ingredients_text uporabite le, ko ima ponudnik popolno deklaracijo v prozi. Ponudniki lahko dodajo vrednosti translations.{language} za ingredients_text, designation_of_origin in vsako navodilo packaging[].disposal. Matrika packaging sledi dolžini in vrstnemu redu primarnega seznama; za navodilo, ki naj pade na primarno vrednost, uporabite null. Manjkajoči prevodi padejo na primarno vrednost najvišje ravni. REST in MCP vračata to izbirno mapo, JSON-LD pa uporablja z jezikom označene vrednosti. Ta mapa, ki jo dostavi ponudnik, je edini način, da se besedilo ponudnika med jeziki spreminja.

Telo zahtevka ponudnika sledi E-Label Standard Format.

Na javnih straneh Atlas upodobi svoje kode Standarda (productType, color, sweetness, packagingGas, packagingType, materialType in collection) v jeziku strani iz objavljenega besednjaka Standarda. Vsaka druga vrednost ponudnika ostane točno tako, kot je bila dostavljena.

MCP

Model Context Protocol, ali MCP, je standardni način, kako AI odjemalec kliče zunanja orodja. e-label Atlas ponuja anonimen Streamable HTTP strežnik na https://www.elabel-atlas.eu/mcp.

Strežnik razkriva search_elabels, lookup_elabel_by_gtin, get_elabel in list_elabels_updated_since.

Namestite Atlas v agenta

Izberite svojega odjemalca. Vtičnik Claude Code in nastavitev Codex vsebujeta tako vodnik skill Atlas kot živa orodja MCP. Drugi odjemalci se povežejo na isti MCP strežnik samo za branje.

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