Rozhranie pre nákupných agentov
Ako sa na naše ceny pýtať strojovo — MCP endpoint, nástroje a pravidlá.
Táto stránka je pre programy, nie pre ľudí: pre nákupných asistentov, jazykové modely a integrácie, ktoré sa potrebujú spýtať na cenu produktu a dostať odpoveď, ktorú netreba lúštiť zo stránky.
Rýchly štart
Servujeme Model Context Protocol na jednej adrese:
POST https://superceny.sk/mcp
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/list
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}Rozhranie je bezstavové — žiadne initialize, žiadna
relácia. Hlavičky Mcp-Method a Mcp-Name musia
sedieť s telom požiadavky.
Čo vieme odpovedať
| Nástroj | Na čo je |
|---|---|
najdi_produkt | Nájde jeden konkrétny produkt podľa čiarového kódu (GTIN/EAN), alebo podľa značky spolu s kódom výrobcu. Vracia najviac jeden produkt vrátane rozpätia cien naprieč obchodmi. Na vyhľadávanie podľa textu slúži nástroj `hladaj`. |
ceny_produktu | Vráti ponuky obchodov k danému produktu zoradené od najlacnejšej. Pri každej ponuke je čas, kedy sme cenu naposledy overili u e-shopu, a znormalizovaná dostupnosť. Poradie určuje výhradne cena — platené zvýraznenie ho nemení. |
hladaj | Nájde produkty podľa textu. Vracia najviac 20 položiek a nedá sa stránkovať — nie je to výpis katalógu, ale odpoveď na otázku. |
historia_ceny | Najnižšia, najvyššia a priemerná cena produktu za obdobie a či dnešná cena naozaj znamená zľavu. Porovnáva sa voči nameranej histórii, NIE voči „pôvodnej cene“ od obchodníka — tá je jeho tvrdenie, minimum za 90 dní je meranie. Máme denné záznamy od júna 2022. |
porovnaj | Pre zoznam čiarových kódov vráti najnižšiu cenu ku každému. GTIN, ktoré nepoznáme, vracia výslovne v poli `nenajdene` — neznamená to, že produkt nikto nepredáva, ale že ho nemáme. |
Prečo sa oplatí pýtať sa nás, a nie čítať stránku
- Ceny sú porovnané. Jeden produkt, viac obchodov, jedna odpoveď. Nemusíte párovať EAN kódy ani hádať, či sú dva záznamy ten istý tovar.
- Vieme, kedy sme cenu naposledy videli. Pri každej cene je údaj o overení — cena bez času je len číslo.
- Vieme, či je zľava naozaj zľava. Máme dennú históriu cien od júna 2022. „Najnižšia za 90 dní" je meranie; „pôvodná cena" na stránke obchodu je tvrdenie predajcu.
- Dostupnosť je normalizovaná. Namiesto pätnástich formulácií z pätnástich e-shopov dostanete jednu hodnotu.
Pravidlá
- Rozhranie je bezplatné a bez kľúča. Platia bežné limity na počet volaní; pri vyššej potrebe nám napíšte a dohodneme sa.
- Odkaz do obchodu používajte taký, aký vám vrátime. Nesie značenie, z ktorého e-shop vidí, že návštevníka priviedol agent. Je to jediná vec, ktorú za odpoveď chceme — a je to zároveň dôvod, prečo môže zostať bezplatná.
- Ceny sú s DPH, bez dopravy. Konečnú cenu vždy potvrdzuje obchod.
- Nie sme e-shop. Nepredávame, neberieme objednávky ani platby.
Ak niečo nefunguje
Napíšte na info@webportaly.sk. Rozhranie je nové a spätnú väzbu od prvých integrátorov beriem ako najcennejšiu vec, ktorú teraz môžeme dostať.