Přejít na obsah

Pro agenty a vývojáře

Nech svého AI agenta číst ceny doplňků stravy

Průběžně skenujeme 21 obchodů a každou cenu přepočítáváme na cenu za jednotku. Dej Claude, ChatGPT nebo vlastnímu AI agentovi přímý přístup přes MCP nebo naše JSON API k nejnižší ceně za jednotku v každé kategorii: normalizované, aktuální a připravené k citaci.

21
naskenovaných e-shopů
16 503
produktů s cenou
před 4 min
poslední aktualizace

MCP server

Endpoint Streamable HTTP, anonymní a jen pro čtení. Funguje s Claude (Desktop i Code), ChatGPT, Grok a jakýmkoli jiným MCP klientem. Připoj ho přes tuto URL:

https://mcp.supplementscanner.cz

Ukázková konfigurace MCP klienta:

{
  "mcpServers": {
    "supplementscanner": {
      "type": "http",
      "url": "https://mcp.supplementscanner.cz"
    }
  }
}

Grok

V aplikaci Grok: otevři pluginy, přidej nový vlastní konektor a vlož endpoint výše. Nic dalšího není potřeba.

Grok Bot přidá stejný server, když ho o to požádáš s touto URL.

Přes API xAI ho přidej jako vzdálený MCP nástroj:

{
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://mcp.supplementscanner.cz",
      "server_label": "supplementscanner"
    }
  ]
}
  • find_cheapest

    Produkty s nejnižší cenou za jednotku v dané kategorii.

  • search_products

    Vyhledávání v celém katalogu, které snese překlepy.

  • list_categories

    Všechny kategorie s aktuálním počtem produktů a nejnižší cenou.

  • get_product

    Detail a vývoj ceny jednoho produktu.

JSON API

Pro agenty a frameworky, které používají obyčejné HTTP. Stejná data jako MCP server.

https://api.supplementscanner.cz/v1
GET /search?q=syrov%C3%A1tkov%C3%BD+protein&limit=10
GET /categories
GET /categories/{slug}/cheapest?limit=10
GET /products/{id}

Strojově čitelné: Specifikace OpenAPI · llms.txt

Představ svou integraci

Každá integrace musí v hlavičce požadavku uvést, kdo ji provozuje, v JSON API i na MCP endpointu.

curl \
  -H "Client-Name: Acme Labs" \
  -H "Client-Domain: example.com" \
  "https://api.supplementscanner.cz/v1/categories"
  • Client-Name: povinná. Firma, organizace nebo osoba, která integraci provozuje. Uveď provozovatele, ne každého z jeho uživatelů; u osobního projektu stačí název projektu nebo přezdívka.
  • Client-Domain: doporučená. Holá doména webu provozovatele, například example.com: bez https://, cesty a portu.

Podmínky použití API a MCP serveru

  • Posílej Client-Name s každým požadavkem a uváděj provozovatele pravdivě. Client-Domain doporučujeme.
  • Používej obyčejné ASCII znaky, méně než 100 na hlavičku. Obě uvádíš sám a nejsou to přihlašovací údaje: nedávají přístup a nezvyšují limity. Nikdy do nich nedávej klíče, tokeny, e-mailové adresy ani údaje o svých uživatelích.
  • Požadavky bez Client-Name, s nepravdivě uvedeným provozovatelem nebo nad limity můžeme bez upozornění zpomalit nebo zablokovat.
  • Klient, který neumí nastavit vlastní hlavičky, třeba konektor chatovacího asistenta přidaný někým pro vlastní potřebu, je výjimkou. MCP klienti, kteří přijímají další HTTP hlavičky, a volání z prohlížeče je posílat musí.

Dobré vědět

  • Částky jsou v celých haléřích (*_cents) a text ve formátu cs-CZ, který můžeš zobrazit beze změny, např. „12,48 Kč za kg“.
  • Produkty porovnávej podle pole unit_price_cents s normalizovanou cenou za jednotku.
  • Každý produkt obsahuje pole buy_url: zobraz ho jako odkaz k nákupu. Je to affiliate odkaz, proto vedle něj uveď i dodané pole affiliate_disclosure jako upozornění.
  • Oba kanály mají limit požadavků na IP adresu; klíč není potřeba.

Chceš se nejdřív porozhlédnout? Procházet kategorie.