.md duplicit každé stránky
Sekce “.md duplicit každé stránky”Každá stránka s obsahem dokumentace má syrový Markdown duplicitu se stejnou cestou a příponou .md. Otevřeš /agent-setup - existuje i /agent-setup.md, stejný text bez HTML obalování, MDX importy jsou oříznuty, vrací se jako text/markdown.
To živí dvě akce v menu stránky: Copy as Markdown (klade čistý text do schránky pro vložení do chatu s modelem) a View as Markdown (přímo otevírá .md verzi). Agent nemusí parsovat DOM - bere si hotový text.
Dropdown akcí v horní části stránky
Sekce “Dropdown akcí v horní části stránky”V pravém horním rohu každé stránky je menu akcí, udělané přesně pro agentní workflow:
- Copy as Markdown - čistý text stránky do schránky
- View as Markdown - otevřít
.mdduplicitu - Open in ChatGPT - předat stránku do ChatGPT jedním kliknutím
- Open in Claude - to samé pro Claude
- Connect MCP - přechod k nastavení MCP serveru
Místo “zkopíruj URL, otevři chat, požádej o návštěvu stránky” - jedna akce.
llms.txt a llms-full.txt
Sekce “llms.txt a llms-full.txt”Podle standardu llmstxt.org vydáváme dva soubory:
/llms.txt- index všech stránek dokumentace, seskupený do sekcí (API Reference, Use Cases, Examples, Products). Mapa pro agenta, kde začít./llms-full.txt- celá dokumentace jako jeden plain-text soubor. Pro offline indexaci v vektorové databázi nebo pro jednorázové vložení do kontextu modelu.
Pokud stavíš RAG přes naše API, llms-full.txt - to je hotový korpus, nemusíš královit web.
strojově čitelné specifikace
Sekce “strojově čitelné specifikace”Kontrakt je vydáván v několika formátech pro různé nástroje:
/v1/openapi.json- kanonická OpenAPI 3.1 specifikace s příklady a code-samply. Pro code-generaci klientů a jakéhokoli OpenAPI toolingu.- Swagger-aliasy -
/v1/swagger.json,/v1/v3/api-docsa další 301 redirectují na kanon, aby nástroje, které hledají obvykle cesty, nespadly. - Postman-kolekce -
/postman/astroway-api.jsonpro import do Postman jedním kliknutím.
/agent-setup pro konkrétní klienty
Sekce “/agent-setup pro konkrétní klienty”Stránka /agent-setup/ - ne jeden obecný průvodce, ale samostatné instrukce pro sedm klientů: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex. Každá dává přesný konfig a curl-příklad tools/list, abys zkontroloval připojení, než začneš psát kód.
Inline try-it
Sekce “Inline try-it”Na stránkách API-dokumentace každá operace má vestavěný widget try-it: vložíš sandbox-klíč, upravíš tělo požadavku, stiskneš “Send” - a uvidíš skutečnou odpověď, aniž bys opustil docs. Metoda, cesta a příklad těla se berou z již vygenerovaného curl-snippetu, takže widget nedělá zbytečné požadavky přes openapi.json.
K čemu to všechno
Sekce “K čemu to všechno”Jednoduchá teze: pokud je tvůj produkt API, dokumentace musí být použitelná nejen pro čtení očima, ale i pro spotřebu agentem. Polovina integrací dnes začíná tím, že vývojář hodí odkaz na docs do Claude nebo Cursoru a požádá “připoj to”. Udělali jsme tak, aby na druhém konci byl čistý text a strojní kontrakt, ne HTML, které je třeba parsovat.
Vyzkoušej sám: otevři jakoukoliv stránku docs, stiskni menu akcí vpravo nahoře - a uvidíš “Open in Claude”.
Stejný Swiss Ephemeris jako v Solar Fire - ve 4 řádcích kódu.
Zdarma klíč bez karty. 5 000 volání za měsíc do první platby.