Класична документація зроблена під людину: рендерений HTML, підсвітка синтаксису, сайдбар, пошук. Але дедалі частіше по docs ходить не людина, а агент - Claude, Cursor, ChatGPT - якому весь цей рендер тільки заважає. Йому потрібен чистий текст і машиночитаний контракт.
Ми зробили документацію придатною для обох. Ось що під капотом.
.md-двійник кожної сторінки
Section titled “.md-двійник кожної сторінки”Кожна сторінка контент-документації має сирий Markdown-двійник за тим самим шляхом із суфіксом .md. Відкрив /agent-setup - є і /agent-setup.md, той самий текст без HTML-обгортки, MDX-імпорти зрізані, віддається як text/markdown.
Це живить дві дії у меню сторінки: Copy as Markdown (кладе чистий текст у буфер, щоб вставити в чат із моделлю) і View as Markdown (відкриває .md-версію напряму). Агенту не треба парсити DOM - він забирає готовий текст.
Dropdown дій угорі сторінки
Section titled “Dropdown дій угорі сторінки”У правому верхньому куті кожної сторінки - меню дій, зроблене саме під агентний воркфлоу:
- Copy as Markdown - чистий текст сторінки в буфер
- View as Markdown - відкрити
.md-двійник - Open in ChatGPT - передати сторінку в ChatGPT одним кліком
- Open in Claude - те саме для Claude
- Connect MCP - перехід до налаштування MCP-сервера
Замість «скопіюй URL, відкрий чат, попроси зайти на сторінку» - одна дія.
llms.txt і llms-full.txt
Section titled “llms.txt і llms-full.txt”За стандартом llmstxt.org ми віддаємо два файли:
/llms.txt- індекс усіх сторінок документації, згрупований у секції (API Reference, Use Cases, Examples, Products). Карта для агента, з чого почати./llms-full.txt- уся документація одним plain-text файлом. Для offline-індексації у векторній базі або одноразового вставлення в контекст моделі.
Якщо будуєш RAG поверх нашого API, llms-full.txt - це готовий корпус, не треба краулити сайт.
Машиночитані специфікації
Section titled “Машиночитані специфікації”Контракт віддається кількома форматами під різні інструменти:
/v1/openapi.json- канонічна OpenAPI 3.1-специфікація з прикладами і code-samples. Для кодогенерації клієнтів і будь-якого OpenAPI-тулінгу.- Swagger-аліаси -
/v1/swagger.json,/v1/v3/api-docsта інші 301-редіректять на канон, щоб інструменти, які шукають звичні шляхи, не спотикались. - Postman-колекція -
/postman/astroway-api.jsonдля імпорту в Postman одним кліком.
/agent-setup під конкретні клієнти
Section titled “/agent-setup під конкретні клієнти”Сторінка /agent-setup/ - не один загальний гайд, а окремі інструкції під сім клієнтів: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex. Кожна дає точний конфіг і curl-приклад tools/list, щоб перевірити підключення до того, як писати код.
Inline try-it
Section titled “Inline try-it”На сторінках API-довідника кожна операція має вбудований віджет try-it: вставляєш sandbox-ключ, редагуєш тіло запиту, тиснеш «Send» - і бачиш реальну відповідь, не виходячи з docs. Метод, шлях і приклад тіла беруться з уже згенерованого curl-сниппета, тому віджет не робить зайвих запитів по openapi.json.
Навіщо це все
Section titled “Навіщо це все”Проста теза: якщо твій продукт - API, документація має бути придатна не тільки для читання очима, а й для споживання агентом. Половина інтеграцій сьогодні починається з того, що розробник кидає посилання на docs у Claude чи Cursor і просить «підключи це». Ми зробили так, щоб на тому кінці був чистий текст і машинний контракт, а не HTML, який треба розпарсити.
Спробуй сам: відкрий будь-яку сторінку docs, натисни меню дій угорі праворуч - і побачиш «Open in Claude».
Той самий Swiss Ephemeris, що й у Solar Fire — у 4 рядках коду.
Безкоштовний ключ без картки. 5 000 викликів на місяць до першої оплати.