Spuštění AstroWay API: kompletní stack astrologických výpočtů s přesností Swiss Ephemeris

Dnes oznamujeme AstroWay API – výpočetní backend pro vývojáře, kteří vytvářejí astrologické aplikace, horoskopové produkty, funkce kompatibility pro seznamování a AI agenty, kteří mají uvažovat o narozeninových kartách.

V tomto článku – co se ve skutečnosti nachází uvnitř API, jaká neobvyklá řešení jsme přijali, co jsme vědomě nechali za závorkami a jak jsme se sem dostali. Bez zbytečného balastu.

🕓 Záznam z 2026-04-22, aktualizováno 2026-05-09. Některá čísla jsou zastaralá. Aktuální stav: 758 endpointů (a ne 87 v době launch), 873 CI snapshot-testů (a ne 183), MCP-server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk nyní všichni žijí na public registries. Čerstvý status – na /faq a changelog.

REST API založené na Swiss Ephemeris (LGPL), zkompilované do WASM a nasazené jako Node.js služba – nyní také s AI-interpretacemi (failover řetězec GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) nad reálnými výpočty. Ten samý engine, který profesionální astrologové používají už více než 30 let v Solar Fire, Kepler, Astro Gold a Janus – přesnost na zlomek úhlové sekundy, ověřená vůči efemeridě NASA JPL a oficiálnímu swetest reference od Astrodienst (Astro.com).

Čísla:

• 758 endpoint: západní natalní astrologie, synastrie, tranzity, progresie, direkce, návraty, harmonie, pevné hvězdy, arabské body, astrokartografie plus kompletní sada Human Design
• 183 snapshot-testy v CI proti reálnému výstupu swetest CGI a katalogu zatmění NASA – běží na každém PR
• p50 < 100 ms, p95 < 500 ms pro typické výpočetní endpointy
• MCP-server @astroway/mcp + tři SDK na public registries: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) – stejné API ve třech jazycích
• MCP-server: @astroway/mcp – poskytuje API jako nástroje pro Claude, GPT, Cursor a další LLM agenty
• Ceny na bázi kreditů: bezplatný plán (10 000 kreditů / měsíc, bez karty), placené – od $5 / měsíc

Kompletní dokumentace: api.astroway.info/docs/api/. Živý stav: api.astroway.info/status.

Před třemi lety jsme začali budovat spotřebitelské astrologické aplikace. Výpočetní vrstva se ukázala být nejnáročnější částí – výrazně složitější než UI nebo obsah. Existující služby buď:

1. Měly povrchní pokrytí (10–30 endpointů, převážně jen natal)
2. Byly drahé při škálování ($0.02–$0.10 za požadavek bez velkoobchodních slev)
3. Používaly uzavřené enginy, jejichž přesnost nelze ověřit
4. Orientovaly se na védskou astrologii a západní podávaly jako sekundární

Tak jsme si sami vytvořili vlastní verzi Swiss Ephemeris a napsali vlastní výpočetní vrstvu – nejprve pro spotřebitelský produkt app.astroway.info, pak pro marketingový web astroway.info, který vydává denní horoskopy stovkám tisíc návštěvníků měsíčně.

Za tři roky provozu tohoto kódu v produkci jsme dospěli ke dvěma závěrům:

1. Ten samý výpočetní engine musí být dostupný ostatním vývojářům: ne proto, že by ho nedokázali napsat sami, ale protože stack knihovna + WASM + cachování + CI na přesnost představuje půl roku práce, kterou nikdo nemá opakovat.
2. Naše pokrytí Human Design (12 endpointů: karta, typ, autorita, profil, brány, kanály, kontury, planetární aktivace, incarnation cross, definition) je skutečně unikátní. Žádný konkurent nenabízí kompletní HD stack přes API.

To je ten start.

Máme /nakshatras, /ashtakavarga a endpointy pro divisional mapy, ale chybí Dasha, Panchang, Ashtakoota, KP. Důvod: ve védské astrologii jsou nevyřešené rozpory mezi školami (války ayanamsa, spory o kuspydy KP, výběr školy dasha). Vydaná védská část proti Prokerala a VedicAstroAPI by jen získala kritiku.

Rozhodnutí je pevně dané: védský balíček – samostatná fáze 3, až bude stabilní poptávka po západní a bude čas validovat proti Jagannatha Hora a Parashara’s Light. Lepší neuvést vůbec než uvést špatně.

Jeden volání /chart stojí přibližně 50‑krát méně výpočtů než 365‑denní /forecast-calendar. Jednotná cena za požadavek by buď odřezala lehké uživatele, nebo subvencovala těžké. Kredity mapují cenu na reálnou práci – viz tabulka endpointů na stránce tarifů.

Odpovědi v bezplatném plánu obsahují pole _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Nám to nic nestojí a bezplatným uživatelům to dává malý podnět k upgradu. V plánu Hobby+ se odstraňuje v nastavení klíče. Vzor jsme převzali od Zapier a RevenueCat.

/rectification (výběr času narození podle životních událostí pomocí likelihood‑grid vyhledávání) – výpočetně náročný: jeden volání trvá 10–60 sekund a provádí desítky tisíc mezivýpočtů Swiss Ephemeris. Omezili jsme ho plánem Pro ($59 / měsíc) a nastavili vysokou kreditovou cenu, protože zneužití by zatížilo společnou infrastrukturu pro všechny ostatní.

Endpointy /interpret/* jsou směrovány přes náš soukromý AI-gateway, který leží nad best‑of‑breed modely trhu (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) s automatickým failoverem. Neuzamykáme tě v našich promptech – každá odpověď s interpretací obsahuje výchozí výpočty, takže můžeš přepsat vlastní LLM, pokud ti náš hlas nevyhovuje. Úplné prompty a výstupy logujeme do audit‑tabulky pro B2B‑compliance (uchovávání 90 dnů).

• Védský balíček: fáze 3, po prvních potvrzeních poptávky (viz výše)
• Webhooky na dosažení prahů: realizovány, ale UI je surové; dolaďujeme
• Veřejné widgety (<script src="api.astroway.info/widget/natal.js">) – fáze 7
• Plugin pro hlavní marketingový web: samostatný projekt, plánovaný v rámci ekosystému astroway.info

1. Přečti si dokumentaci, pokud chceš pochopit „proč“: api.astroway.info/overview
2. Rychlý start za 5 minut s kódem: Astrology API Quick Start
3. Tarify, včetně tabulky kreditů na endpoint: api.astroway.info/pricing
4. Zaregistruj se: zdarma, bez karty: api.astroway.info/dashboard/sign-up

Pokud postavíš něco na API – nebo najdeš bug, nebo budeš chtít endpoint, který ještě nemáme – napiš nám. Raději uslyšíme sto vývojářů, kteří o něco žádají, než spouštět funkce, které nikdo nepoužívá.

Otázky, požadavky, podivné edge‑případy: hello@astroway.info.

Roadmapa je veřejná – PRODUCT-PLAN.md – co je hotové, co je další, co je odloženo a proč.

Vítej.