Използвайте данните на Atlas.

Бърз старт

Задайте базовия URL веднъж и след това изпълнете който и да е пример по-долу.

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

Удостоверяване

Анонимните заявки могат да използват всеки публичен endpoint за четене. Ключът повишава лимита на заявките и е задължителен за операции за запис на доставчици. Собствениците и администраторите на работни пространства на доставчици могат да създадат ключ във влезлото работно пространство под API ключове. Ако ви трябва ключ за четене без работно пространство на доставчик или масов достъп, пишете на david@essentialcode.eu.

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

Лимити на заявките

Всяка публична операция позволява 60 анонимни заявки в минута на адрес или 600 в минута на ключ за четене. Отговорите включват хедъри limit, remaining и reset. Заявка над лимита връща 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 за четене

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

Страниране

Публичният списък със записи връща next_cursor, когато съществува следваща страница. Изпратете тази точна непрозрачна стойност със същите филтри. Не я декодирайте и не я редактирайте.

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"

Езици на публичните записи

Страниците на публичните записи локализират само собствените етикети на Atlas и кодовете, дефинирани в E-Label Standard Format, включително тип вино, свойства на виното, кодове на държави, ключове за хранителни стойности и единици. Всеки текст, написан от доставчика, остава точно такъв, какъвто е доставен, включително имената и категориите на съставките и всеки текст за опаковка или обезвреждане, написан от доставчика.

Първият код в languages винаги е основният език на записа, дори когато Atlas не може да покаже интерфейса си на този език. Страницата предлага основното съдържание и поддържаните езици, които имат преводи от доставчика. Връзка към избора чрез ?lang=de или ?lang=hr. Без параметър Atlas използва Accept-Language, когато съществува съвпадащо съдържание, и пренасочва към правилния URL за споделяне.

Предпочитайте структурирани ingredients[], за да се запазят флаговете за алергени и био. Използвайте ingredients_text само когато доставчикът има пълна декларация в проза. Доставчиците могат да добавят стойности translations.{language} за ingredients_text, designation_of_origin и всяка инструкция packaging[].disposal. Масивът packaging следва дължината и реда на основния списък; използвайте null за инструкция, която трябва да се върне към основната стойност. Липсващите преводи се връщат към основната стойност от най-високо ниво. REST и MCP връщат тази опционална карта, а JSON-LD използва маркираните с език стойности. Тази предоставена от доставчика карта е единственият начин текстът на доставчика да се променя между езиците.

Тялото на заявката на доставчика следва E-Label Standard Format.

На публичните страници Atlas рендира собствените си кодове на Стандарта (productType, color, sweetness, packagingGas, packagingType, materialType и collection) на езика на страницата от публикувания речник на Стандарта. Всяка друга стойност на доставчика остава точно такава, каквато е доставена.

MCP

Model Context Protocol или MCP е стандартният начин, по който AI клиент извиква външни инструменти. e-label Atlas предлага анонимен Streamable HTTP сървър на https://www.elabel-atlas.eu/mcp.

Сървърът излага search_elabels, lookup_elabel_by_gtin, get_elabel и list_elabels_updated_since.

Инсталирайте Atlas в агент

Изберете своя клиент. Плъгинът Claude Code и настройката Codex включват както ръководството за skill на Atlas, така и работещи MCP инструменти. Други клиенти се свързват със същия MCP сървър само за четене.

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