atcmarket-mcp

Remote MCP server (Streamable HTTP) nad verejnym katalogem atcmarket.cz (AT Computers). Bez loginu, bez state — cte verejne dostupne stranky katalogu a parsuje je (zadne JSON API na zdrojovem webu neexistuje).

Nastroje

• hledej_produkt(dotaz) — fulltextove hledani v celem katalogu. Vraci nazev, kod, cenu s/bez DPH a dostupnost. Siroke — muze vratit nesouvisejici produkty z jinych kategorii (napr. "Gigabyte zakladni deska" vrati i notebooky a CPU chladice znacky Gigabyte).

• hledej_v_kategorii(kategorie, filtry?, pouze_skladem?, strana?) — presne hledani omezene na jednu kategorii, volitelne filtrovane podle vyrobce/typu (napr. kategorie: "zakladni_desky", filtry: ["Gigabyte"]). Pouziva reverse-engineerovany filtrovaci mechanismus webu (viz nize) — nevraci sum z jinych kategorii.

• podporovane_filtry() — vypise podporovane kategorie a jejich filtry. Zavolat pred pouzitim hledej_v_kategorii s konkretnim filtrem, aby se predeslo chybe "neznamy filtr".

• detail_produktu(kod) — detail podle objednaciho kodu: nazev, vyrobce, kod vyrobce, zaruka, dostupnost, obe ceny a tabulka technickych parametru.

• porovnej_produkty(kody) — srovná 2 až 5 produktů podle objednacích kódů (např. dva notebooky nebo dvě desky). Stáhne detaily paralelně, sjednotí parametry do jedné tabulky (chybějící hodnota u produktu, který daný parametr nemá, se ukáže jako —). Funguje i napříč kategoriemi, i když to pak nemusí dávat věcný smysl.

Podporovane kategorie (stav k nasazeni)

Klíč	Název	Příklady filtrů
notebooky	Notebooky	intel, amd, windows_11_home, windows_11_pro
zakladni_desky	Zakladni desky	asus, gigabyte, am5, lga1851
procesory	Procesory a chladice	amd, intel, am5, lga1700
pameti	Pameti	ddr4, ddr5, kingston, crucial
skrine_a_zdroje	Skříně a zdroje	corsair, midi_tower, atx_3_1, 80plus_gold
graficke_karty_a_tv_tunery	Grafické karty a TV tunery	nvidia, rtx_5070, amd, rx_9070_xt
disky	Disky	ssd, m_2_pcie_4_0_nvme, wd, seagate
monitory_a_lfd	Monitory a LFD	ips, oled, vyskove_nastavitelny_stojan, usb_c
tiskarny_multifunkce_a_plotry	Tiskárny, multifunkce a plotry	multifunkce, laserova, wifi, duplex
klavesnice_mysi_herni_ovladace	Klávesnice, myši, herní ovladače	logitech, hyperx, hp, asus
sluchatka	Sluchátka	logitech, hyperx, hp, endorfy

Omezení: kategorie procesory sdružuje procesory a chladiče. ATC Market je rozlišuje pouze podkategorií, kterou současný model hledej_v_kategorii neserializuje; pro praktické zúžení použij filtr výrobce (Intel/AMD → CPU, Arctic/Scythe/Endorfy → chladiče) nebo socket/patici (am4/am5/lga1700/lga1851), který CPU vrací čistě.

Kompletní seznam filtrů pro danou kategorii vrátí nástroj podporovane_filtry().

V kazde kategorii lze kombinovat vice filtru najednou (napr. notebooky

• ["Intel", "Lenovo"] = jen Intel notebooky znacky Lenovo).

Jak filtrovaci mechanismus funguje (pro rozsireni na dalsi kategorie)

Web nema JSON API, ale ma funkcni server-side filtr pouzivany strankou "Komfortni hledani" (/adv-search/{kat}/{templateId}). Zjistil jsem dva mechanismy:

1. Kategorie-specificky numericky filtr — kazda hodnota v UI ma data-pid (ID parametru) a data-vid (ID hodnoty). Vysledky se pak nactou z /itemspage/zbozi?kat={kat}&templateId={templateId} &sort=1&page=1&skladem=0&c={pid}I{vid}. Vice filtru se retezi pres P: c=371I26531P1117I5067.

2. Univerzalni filtr vyrobce — kdyz ma hodnota data-pid="brands", pouziva se misto toho samostatny parametr vyr={vid} (ne c=).

Postup pro pridani nove kategorie:

1. Najdi kategorii v katalogu, ziskej jeji kat a templateId z odkazu /adv-search/{kat}/{templateId}.
2. Na strance /adv-search/{kat}/{templateId} najdi pozadovanou hodnotu v DOM (napr. pres DevTools), precti jeji data-pid a data-vid.
3. Pokud data-pid="brands", pouzij typ "vyr" s dane vid. Jinak pouzij typ "c" s danym pid+vid.
4. Pridej zaznam do CATEGORIES v route.ts.

Poznamka: nektere facety (napr. "Pamet RAM (GB)" na noteboocich, "Kapacita pameti (GB)" na pametech, "Velikost pameti VGA (GB)" u grafickych karet) jsou rozsahove slidery, ne diskretni hodnoty — ty nejsou v teto verzi podporovane (vyzaduji jiny zpusob automatizace). Overeno: grafické karty nemají ani obecnější facet na úrovni generace (jen konkrétní modely jako rtx_5070).

Lokalni spusteni

npm install
npm run dev
# http://localhost:3000/api/mcp

Deploy na Vercel

vercel --prod

nebo pres vercel.com/drop — nahraj zip bez node_modules a .next.

Pripojeni klienta

{
  "mcpServers": {
    "atcmarket": { "url": "https://<tvuj-projekt>.vercel.app/api/mcp" }
  }
}

Pro stdio-only klienty pres mcp-remote proxy (viz README u ares-mcp).

Zname omezeni

• Jen verejny katalog. Ceny a dostupnost jsou ty, co vidi neprihlaseny navstevnik — ne partnerske ceny z atcomp.cz. Server pro atcomp.cz (prihlaseny B2B ucet) je samostatny projekt.
• HTML scraping, ne API. Parser je navazany na aktualni CSS tridy webu. Redesign webu ho muze rozbit.
• atcmarket.cz posila neuplny TLS certifikatovy retezec (chybi mezilehly CA certifikat — bezne u IIS/ASP.NET serveru). Bezne prohlizece to tolerovaly (AIA-fetching/cachovana duveryhodna uloziste), ale Node fetch to odmital chybou "unable to get local issuer certificate". Server proto pouziva node:https s vypnutou strict verifikaci certifikatu (rejectUnauthorized: false) POUZE pro volani na atcmarket.cz — ne globalne. Kompromis: prijima riziko MITM na tomto jednom odchozim spojeni vymenou za funkcnost; jde jen o cteni verejnych katalogovych dat, zadne credentials se neposilaji.
• atcomp.cz odkaz. Každá položka a detail nese kromě odkazu na atcmarket.cz i odkaz na B2B portál https://www.atcomp.cz/ItemDetail/ Index/{kod} — sestavený jen ze stejného objednacího kódu, žádný další scraping. Odkaz je za loginem (potvrzeno uživatelem, že stejné ID platí na obou systémech).
• Neexistujici kod se pozna podle <title> obsahujiciho "Nenalezeno" — web nevraci jasny HTTP chybovy stavovy kod.
• Rozsahove filtry (RAM GB, cena, frekvence) nejsou podporovane — jen diskretni hodnoty (vyrobce, typ pameti, CPU vyrobce...).