České adresy, které sedí na první dobrou.
Zákazník začne psát ulici, vybere z nabídky — a Shikula doplní ulici s číslem popisným i orientačním, PSČ i město. Data z oficiálního registru RÚIAN. Míň překlepů, míň vratek, rychlejší pokladna.
Vyzkoušejte to hned
Napište kousek ulice a vyberte — pole se doplní přesně tak, jak to uvidí i váš zákazník.
Nasadíte za minutu
Jeden řádek do šablony pokladny. Widget si sám najde pole s adresou — nebo mu je určíte.
<script src="https://adresy.shikula.cz/adresy/v1/widget.js" data-street="#ulice" data-zip="#psc" data-city="#mesto"></script>
Země se bere z pokladny automaticky. Máte jen slovenský nebo polský e-shop? Přidejte data-country="sk" (resp. "pl") — nebo si vyberte zemi v ukázce výše a snippet se doplní. Výchozí je cz.
Už brzy: jednoklikové pluginy a doplňky pro Shoptet, WooCommerce i Upgates ke stažení přímo tady. Zatím stačí vložit řádek výše — funguje hned.
Vložte skript
Do šablony pokladny (nebo vlastního HTML/JS bloku) vložíte jeden <script> tag.
Určíte pole
Selektory pro ulici, PSČ a město — nebo použijete přednastavení pro vaši platformu.
Hotovo
Zákazníci dostanou našeptávač. V patičce nabídky je decentní „Shikula“.
Získejte klíč zdarma
Funguje i bez klíče. S klíčem dostanete vyšší limity, statistiky využití a můžete ho zamknout na svoji doménu.
Už máte klíč? Přihlaste se do portálu — zkopírujete, vytvoříte nebo bezpečně otočíte klíče a uvidíte statistiky.
Proč je to zdarma?
Oficiální data
RÚIAN je otevřený registr ČÚZK (licence CC-BY 4.0). Žádný proprietární měřič dotazů, žádná cizí databáze.
Bez klíče a poplatků
Placené brány účtují za každý dotaz. Tady žádný klíč ani poplatek za dotaz není — náklad je jen výpočet.
Od tvůrců Shikuly
Stavíme platformu Shikula pro české e-shopy. Tohle je její část, kterou dáváme zdarma celému českému e-commerce.
Šikula = capable little helper. Dáváme ho zdarma, protože dobrá adresa prospěje každé české pokladně — a při každém našeptání se decentně ukáže „Shikula“. Poznat Shikulu →
Technické detaily
Widget je ~8 KB vanilla JS bez závislostí. Nastavíte ho přes data-* atributy na <script> tagu (nebo window.ShikulaAdresy nastavené před ním).
Konfigurace
data-street, data-zip, data-city jsou CSS selektory (jinak se pole detekují automaticky). Dále data-preset, data-country a data-api.
SPA i krokové pokladny
Pole se hledají v nejbližším <form>, takže fakturační i doručovací blok fungují. Widget přeskenuje DOM (MutationObserver), takže zvládne i pokladny odkrývané po krocích.
Data a aktuálnost
RÚIAN celostátně — 3 019 049 adres, měsíční aktualizace z ČÚZK. Doplní ulici s číslem popisným i orientačním, PSČ a město. Pro adresy mimo RÚIAN je fallback na OpenStreetMap.
Země a formát
Země přes data-country (ISO-2: cz, sk, pl). Výchozí je cz, jinak se bere z pokladny automaticky. Vybraná adresa se vyplní přímo do polí pokladny.
Limity a klíč
Bez klíče 120 dotazů/min na IP (sdílený demo pool). Veřejný pk_… klíč zvedne limit na 600 dotazů/min a přidá zámek na doménu (přes Origin) a statistiky.
Chování při chybě
Když je API pomalé nebo nedostupné, pokladna funguje dál — widget jen dočasně nenabízí návrhy a nikdy neblokuje odeslání objednávky. Odpovědi jsou JSON s CORS *.
Veřejné endpointy (za adresy.shikula.cz):
GET /adresy/v1/widget.js — skript widgetu
GET /adresy/v1/suggest?q=&country=&key= — návrhy (JSON)
POST /adresy/v1/register {email,domain?} — klíč zdarma
GET /adresy/v1/usage?key= — statistiky klíče
Chcete si to „vibecodit" sami?
Klidně — je to skvělý víkendový projekt. Než se do toho pustíte, tady je upřímný odhad, co to obnáší. A jestli do toho jdete, dáme vám i hotový prompt pro vaši AI.
Kolik času to sežere
- Pár hodin — demo, které jakžtakž našeptává z pár tisícovek adres.
- Víkend — do produkční kvality: 3 miliony adres, hledání bez diakritiky, rate-limit, CORS, fallback i widget pro SPA a krokové pokladny (MutationObserver).
- Navždy — měsíční aktualizace z ČÚZK, hosting, dostupnost, opravy. A když se něco rozbije, řešíte to vy.
Hotovo za minutu
- 1 řádek — vložíte jeden <script> do pokladny.
- 0 Kč — bez klíče a bez poplatku za dotaz.
- Hned — 3 019 049 adres už naimportovaných, aktualizují se samy.
- Nikdy — žádný hosting ani údržba na vaší straně.
Hotový prompt pro vaši AI i celé srovnání času a údržby najdete na stránce Shikula vs vibecoding.
Kdo za tím stojí
Shikula Adresy je součást platformy Shikula — nástrojů pro české e-shopy. Tenhle našeptávač dáváme zdarma celému českému e-commerce, protože přesná adresa prospěje každé pokladně.
Vše stojí na oficiálních otevřených datech: RÚIAN (ČÚZK, CC-BY 4.0) a OpenStreetMap (ODbL). Žádná proprietární databáze ani skrytý měřič dotazů.