Strojově čitelné API
Astrology Positions API
Tato stránka popisuje jednoduchý JSON endpoint pro výpočet astrologických poloh planet pro jeden okamžik v UTC. Je určený i pro AI nástroje, které neumí samy spolehlivě počítat efemeridy, ale mohou použít přesnou kalkulačku.
Endpoint vrací čistý JSON pro jeden okamžik v UTC: tropickou ekliptikální délku, šířku, denní rychlost délky, retrograditu, znamení a volitelně i domy.
Endpoint
GET /api/positions.php?dt=2026-05-17T12:00:00Z&bodies=So,Mo,Me,Ve,Ma,Ju,Sa,Ur,Ne,Pl,Nn,Ll,Wa,Se&lon=14.417&lat=50.083&house=PVýstup a statický archiv
Význam zkratek, souřadnicový model a názvy polí jsou sladěné se statickým archivem pro AI. Odpověď živého endpointu obsahuje navíc pole record, které má stejný tvar jako jeden JSONL záznam archivu. Pole positions zůstává jako pohodlný přehled pro jednorázové volání API.
MCP pro AI klienty
Samostatný veřejný MCP server umožňuje kompatibilním AI klientům číst polohy bez zatěžování živého výpočtu hlavní aplikace. Je pouze pro čtení a používá předpočítaný desetiminutový archiv pro období 1900–2050 UTC.
https://mcp.on-lineastrology.com/mcpDostupné nástroje:
get_planet_positions: poloha vybraných nebo všech podporovaných těles pro jeden přesný časget_transit_window: omezená časová řada kolem začátku události
MCP vrací geocentrické tropické ekliptikální polohy. Neobsahuje domy, Ascendent ani MC, protože ty vyžadují zeměpisné souřadnice a samostatný živý výpočet.
Parametry
| dt | ISO 8601 datum a čas. Doporučené je UTC, například 2026-05-17T12:00:00Z. |
|---|---|
| bodies | Čárkami oddělené zkratky, například So,Mo,Me,Ve,Ma,Ju,Sa,Ur,Ne,Pl,Nn,Ll,Lt,Wa,Se. Hodnota all vrátí všechna podporovaná tělesa. |
| lon, lat | Volitelné zeměpisné souřadnice pro domy. lon je délka, lat je šířka. |
| house | Volitelný systém domů, například P pro Placidus. Počítá se jen při zadání lon i lat. |
Podporované zkratky
So Sun, Mo Moon, Me Mercury, Ve Venus, Ma Mars, Ju Jupiter, Sa Saturn, Ur Uranus, Ne Neptune, Pl Pluto, Nn mean North Node, Nt true Node, Ll mean Lilith, Lt true Lilith, Ch Chiron, Ph Pholus, Ce Ceres, Pa Pallas, Jo Juno, Va Vesta, Wa Waldemath, Se Selena/White Moon.
Použití pro AI
Endpoint je veřejný a zdarma použitelný pro jednotlivé výpočty poloh, například když AI potřebuje ověřit astrologické pozice pro jeden okamžik. Není určený pro hromadné efemeridy, smyčky, scraping ani dlouhé časové řady. Pro větší automatizované výpočty použijte vlastní lokální kopii výpočetního kódu nebo exportovaná data místo opakovaného volání tohoto serveru.
Pro větší použití počítejte lokálně
Pokud chce AI nástroj, skript nebo jiný web počítat častěji, nejšetrnější cesta je stáhnout PHP balíček a spouštět výpočty u sebe. Veřejný endpoint tak zůstane dostupný pro ruční ověření a jednotlivé dotazy, zatímco větší zátěž se rozloží mimo tento server.
K dispozici je také samostatný statický archiv předpočítaných efemerid pro roky 1900–2050 UTC, určený pro AI a hromadné čtení bez volání živého endpointu.
Balíček používá Swiss Ephemeris .se1 soubory. ZIP kvůli licenčním pravidlům neobsahuje kompletní efemeridová data; uživatel vlastní instalace si musí zajistit odpovídající .se1 soubory a respektovat licenci Swiss Ephemeris.
Strojové popisy
OpenAPI schema llms.txt sitemap.xml
Jednotlivé výsledkové URL vrací hlavičku X-Robots-Tag: noindex, aby se neindexovaly kombinace dat a těles. Při vyšší zátěži může být výpočetní endpoint dočasně omezen kvůli ochraně serveru. Indexovat se má dokumentace, ne výsledková URL.