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.
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.czUká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_cheapestProdukty s nejnižší cenou za jednotku v dané kategorii.
search_productsVyhledávání v celém katalogu, které snese překlepy.
list_categoriesVšechny kategorie s aktuálním počtem produktů a nejnižší cenou.
get_productDetail 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/v1GET /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_centss 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é poleaffiliate_disclosurejako 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.