.md-doppio di ogni pagina
Sezione intitolata “.md-doppio di ogni pagina”Ogni pagina della documentazione ha un duplicato Markdown grezzo allo stesso percorso con suffisso .md. Apri /agent-setup - trovi anche /agent-setup.md, lo stesso testo senza l’HTML wrapper, gli import MDX sono tagliati, viene servito come text/markdown.
Questo alimenta due azioni nel menu della pagina: Copy as Markdown (mette il testo puro negli appunti da inserire in una chat con il modello) e View as Markdown (apre la versione .md direttamente). All’agente non serve parsare il DOM - prende il testo già pronto.
Menu a tendina di azioni in alto alla pagina
Sezione intitolata “Menu a tendina di azioni in alto alla pagina”In alto a destra di ogni pagina c’è un menu di azioni, creato appositamente per il workflow dell’agente:
- Copy as Markdown - testo puro della pagina negli appunti
- View as Markdown - apre direttamente la versione
.md - Open in ChatGPT - invia la pagina a ChatGPT con un solo clic
- Open in Claude - lo stesso per Claude
- Connect MCP - vai alla configurazione del server MCP
Invece di “copia l’URL, apri la chat, chiedi di andare alla pagina” - un’unica azione.
llms.txt e llms-full.txt
Sezione intitolata “llms.txt e llms-full.txt”Secondo lo standard llmstxt.org forniamo due file:
/llms.txt- indice di tutte le pagine della documentazione, raggruppate in sezioni (API Reference, Use Cases, Examples, Products). Una mappa per l’agente, per sapere da dove iniziare./llms-full.txt- tutta la documentazione in un unico file di testo semplice. Per l’indicizzazione offline in un database vettoriale o per l’inserimento una tantum nel contesto del modello.
Se costruisci un RAG sul nostro API, llms-full.txt è un corpus già pronto, non è necessario fare il crawling del sito.
Specifiche leggibili dalla macchina
Sezione intitolata “Specifiche leggibili dalla macchina”Il contratto viene fornito in diversi formati per vari strumenti:
/v1/openapi.json- specifica OpenAPI 3.1 canonica con esempi e code-samples. Per la generazione del codice del client e qualsiasi strumento OpenAPI.- Alias Swagger -
/v1/swagger.json,/v1/v3/api-docse altri 301-redirezionano al canonico, così gli strumenti che cercano percorsi familiari non inciampano. - Collezione Postman -
/postman/astroway-api.jsonper l’importazione unica clic in Postman.
/agent-setup per client specifici
Sezione intitolata “/agent-setup per client specifici”La pagina /agent-setup/ - non è una guida generale, ma istruzioni separate per sette client: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex. Ogni fornisce una configurazione esatta e un esempio curl tools/list per verificare la connessione prima di scrivere codice.
Try-it integrato
Sezione intitolata “Try-it integrato”Nelle pagine di riferimento API, ogni operazione ha un widget “try-it” integrato: inserisci la chiave sandbox, modifichi il corpo della richiesta, premi “Send” - e vedi la risposta reale senza uscire dai docs. Metodo, percorso e esempio di corpo sono presi dal curl snippet già generato, quindi il widget non fa richieste extra a openapi.json.
Perché tutto questo
Sezione intitolata “Perché tutto questo”Una semplice tesi: se il tuo prodotto è un API, la documentazione deve essere adatta non solo per la lettura con gli occhi, ma anche per il consumo da parte di un agente. Metà delle integrazioni oggi inizia con uno sviluppatore che lancia un link dei docs in Claude o Cursor e chiede “connetti questo”. Abbiamo fatto sì che dall’altra parte ci sia testo pulito e contratto macchina, non HTML che deve essere parsato.
Prova tu stesso: apri qualsiasi pagina dei docs, clicca il menu azioni in alto a destra - e vedrai “Open in Claude”.
Lo stesso Swiss Ephemeris di Solar Fire - in 4 righe di codice.
Chiave API gratuita senza carta. 5 000 chiamate al mese fino al primo pagamento.