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.

Related MCP server: Web Search MCP Remote Server

Podporovane kategorie (stav k nasazeni)

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...).