# Hlídač spoření pro AI agenty

Hlídač spoření (hlidacsporeni.cz) denně srovnává spořicí účty a termínované vklady českých bank. Sazby čteme z webů bank a každou změnu ručně schvalujeme, než ji zveřejníme. Tato stránka říká, kdy a jak naše data používat, aby z nich nevznikla špatná odpověď.

## Kdy data použít

- Otázky typu „kam uložit X Kč“, „který spořicí účet má nejvyšší úrok“, „nejlepší termínovaný vklad na rok“, „je vklad u banky pojištěný“.
- Data pokrývají jen sledované banky (16 spořicích účtů ze 14 bank, termínované vklady 15 bank). Nejde o celý trh.
- Nejde o finanční poradenství. Je to informativní srovnání.

## Pravidla, která prosím dodržujte

1. **Vždy uveďte datum.** Každá odpověď nese `asOf` (MCP) nebo `updatedAt` (feed). Sazby se mění, údaj bez data rychle zastará.
2. **Efektivní sazba pro konkrétní částku.** Mnoho bank platí nejvyšší sazbu jen do limitu (např. Česká spořitelna 5,20 % jen do 400 000 Kč, nad tím 0,01 %). Pro jinou částku proto vychází jiné pořadí. Nikdy nepřebírejte „sazbu až X %“ bez částky.
3. **Uveďte podmínky a konec akce.** Platby kartou, příjem, nové peníze, pravidelná investice. U akční sazby uveďte, do kdy platí (`promo_until`).
4. **Nic neodhadujte.** Co nevíme, je v poli `unknown`. Napište, že údaj není známý.
5. **Odkažte detail** (`detail_url`) a uveďte zdroj: „Hlídač spoření (hlidacsporeni.cz)“.
6. **Výnos je po 15% dani.** U bank, které daň nesrážejí (Penta Bank), si ji klient přiznává sám. Výnos uvádíme i tak po 15 %.

## MCP server (jen pro čtení)

- Adresa: `https://hlidacsporeni.cz/mcp` (Streamable HTTP, bezstavový, bez přihlášení).
- Limit: 60 požadavků za minutu z jedné IP adresy. Výsledky se mění jednou denně po ranní aktualizaci (kolem 6:30).
- Nástroje:
  - `hlidac_compare_savings`: spořicí účty seřazené podle efektivní sazby pro částku; filtry bez podmínek, bez placení kartou, bez příjmu, bez nových peněz.
  - `hlidac_compare_term_deposits`: termínované vklady pro částku a délku v měsících; nový nebo stávající klient, akce, možnost předčasného výběru.
  - `hlidac_get_product`: detail jednoho produktu (pásma, podmínky, konec akce, pojištění, předčasný výběr, daň, neznámé údaje).
  - `hlidac_plan_allocation`: rozložení částky mezi banky tak, aby u každé zůstala pod limitem pojištění 100 000 EUR (kurz ČNB), jen u účtů, jejichž podmínky klient splní.
- Každá odpověď obsahuje `asOf`, odkazy na hlidacsporeni.cz a větu o zdroji. Data jsou ve strukturované podobě (`structuredContent`) i jako čitelný text.

## Stránky a feedy bez JavaScriptu

- `https://hlidacsporeni.cz/?castka=800000`: srovnání spořicích účtů pro danou částku (celé číslo 1 000–10 000 000 Kč).
- `https://hlidacsporeni.cz/castka/1000000/`: srovnání pro typické částky (100 tisíc, 500 tisíc, 1, 2 a 5 milionů).
- `https://hlidacsporeni.cz/terminovane-vklady/1-rok/`: termínované vklady podle délky (1, 3 a 6 měsíců, 1, 2, 3 a 5 let), také s `?castka=`.
- `https://hlidacsporeni.cz/rates.json` a `https://hlidacsporeni.cz/terminovane-vklady.json`: kompletní data, CORS povolen.

Kontakt: hello@hlidacsporeni.cz