Postavil som si CLI, ktoré za mňa nakupuje na Alze
Každý mesiac objednávam na Alze to isté: kávové kapsuly, prací prášok a drogériu. Pri takom nákupe nepotrebujem listovať ponukou, sú to stále tie isté produkty, ten istý checkout a ten istý AlzaBox. Napriek tomu som zakaždým otvoril web, vyhľadal, preklikal sa piatimi stránkami a potvrdil.
Tak som si postavil CLI, cez ktoré môj AI asistent vyhľadá tovar na Alze, porovná možnosti a pripraví objednávku. Ja ju len potvrdím.
Ako to vyzerá
Hľadanie vráti zoznam produktov s cenou a dostupnosťou.
$ alza search "nespresso capsules" -n 5
1. [5765432] Nespresso Vertuo Pop Barista Variety Pack
Price: 5,49 € | In stock
2. [5834521] Starbucks by Nespresso Blonde Espresso Roast
Price: 4,29 € | In stock
3. [5612098] Nespresso Original Ispirazione Roma
Price: 3,99 € | In stock
...
Príkaz alza product ukáže detail s hodnotením a parametrami a potom produkt buď pridám do košíka, alebo použijem QuickBuy. QuickBuy preskočí košík aj celý checkout a objednávku vytvorí rovno s uloženou kartou a mojím AlzaBoxom. S prepínačom --quote len ukáže cenu a nič neobjedná, až s -y sa z karty stiahnu peniaze.
$ alza quickbuy 5612098 --quote
✅ QUOTE CREATED
Total: 3,99 €
Asistent preto nikdy neobjedná naslepo. Najprv vytvorí quote, ukáže mi presný produkt, cenu a spôsob doručenia a čaká, kým to výslovne potvrdím. Keď hľadanie vráti viac podobných produktov, zastaví sa a opýta sa, ktorý myslím. Plnú autonómiu nechcem, chcem len, aby nudnú časť spravil za mňa.
Ako ho používam
Keď v chate napíšem „objednaj kávové kapsuly, tie moje obvyklé“, asistent pozrie históriu objednávok cez alza orders, nájde produkt, ktorý zvyčajne kupujem, a cez quote zistí aktuálnu cenu. Potom ma požiada o potvrdenie a až potom objednávku odošle. Pri nových produktoch hľadá, porovná hodnotenia a ceny a dá mi na výber, takže prieskum spraví on a rozhodnem ja.
alza orders --query "detergent" --format=json
alza search "persil washing powder" -n 5 --format=json
alza product 7816725 --format=json
alza reviews 7816725 --stats --format=json
alza quickbuy 7816725 --quote --format=json
# ... caka na moje potvrdenie ...
alza quickbuy 7816725 -y --no-coupon
Prečo CLI a nie prehliadač
Najprv som skúsil automatizáciu prehliadača, kde agent preklikáva skutočný web. Fungovala, ale bola pomalá, rozbila sa pri každej zmene UI a ťažko sa kontrolovala. Pozeral som, ako robot kliká po tlačidlách, a dúfal, že trafí tie správne.
CLI volá priamo API, na ktorom beží web Alzy. Je rýchlejšie a každý krok sa dá dohľadať, a keď sa niečo pokazí, API vráti chybu namiesto screenshotu nesprávnej stránky. Agent môže rýchlo za sebou volať hľadanie, detail aj recenzie a dostane štruktúrovaný JSON bez čakania na stránky, pop-upy a cookie lišty. Platím za to tým, že CLI funguje len na Alze, ale pri pravidelných nákupoch v jednom obchode mi to stačí.
Ako som ho postavil
Alza nemá verejné API, tak som otvoril Chrome DevTools, prešiel nákupným procesom a zmapoval endpointy. Najväčšia prekážka bol Cloudflare, lebo bežné HTTP klienty sa k API Alzy vôbec nedostali. Pomohla až knižnica v Go na TLS fingerprinting, ktorá napodobňuje TLS handshake Chromu dosť verne na to, aby kontrolou prešla.
Prihlásenie sa vezie na mojej session v Chrome. CLI prečíta session cookies, vymení ich za API token, ktorý vyprší asi po 90 minútach, a ten si na pozadí sám obnovuje. Heslo si nikdy nepýta.
Vyhľadávanie a detail produktu som zmapoval ľahko, najťažší bol checkout. Pri QuickBuy som musel zmapovať vyše 30 polí v požiadavke, z ktorých veľa vyzerá bezvýznamne, napríklad IsTretinka alebo ShowPaymentCards, ale bez nich požiadavka neprejde. Prepínač --format=json som spočiatku pridal len tak mimochodom a ukázalo sa, že bez neho to s agentom nejde, lebo JSON číta spoľahlivo a formátovaný výstup z terminálu nie. Každý príkaz má preto čitateľný výstup pre mňa a JSON pre agenta.
Celé to stojí na reverse engineeringu, takže Alza to môže kedykoľvek rozbiť. API sa však mení oveľa menej často ako UI. Používam to od konca roka 2025 a hlavné endpointy sa zatiaľ nezmenili. E-shopy takúto automatizáciu zjavne nechcú, inak by nebolo treba TLS fingerprinting a vyťahovanie cookies, takže je to šedá zóna: technicky to ide, oficiálne to podporované nie je.
Čo si z toho beriem
Časť rutinných nákupov už vybavujem cez chat. K praciemu prášku nepotrebujem produktové fotky ani odporúčania, potrebujem to, čo kupujem vždy, za dobrú cenu a v mojom AlzaBoxe. Keď kupujem slúchadlá alebo darček, stále chcem prehliadať, porovnávať a čítať recenzie.
Pri stavbe ďalších nástrojov pre agentov sa držím troch vecí. Kde sa dá, volám API namiesto automatizácie prehliadača. Každý príkaz má čitateľný výstup aj --format=json. A čokoľvek, čo míňa peniaze alebo sa nedá vrátiť, má najprv quote alebo dry-run.
Kód je open source na github.com/kuringer/alza-cli. Je to hobby projekt na môj postup, funguje len s Alza.sk, na prihlásenie potrebuje Chrome a môže sa pokaziť, keď Alza zmení backend. Ak ste niečo podobné postavili pre iný e-shop alebo nákupy cez agentov riešite ako predajca, napíšte mi na hi@andrejkostal.sk.