La documentación clásica está hecha para personas: HTML renderizado, resaltado de sintaxis, barra lateral, búsqueda. Pero cada vez más a menudo quien recorre la documentación no es una persona, sino un agente (Claude, Cursor, ChatGPT), y a él todo ese renderizado solo le estorba. Necesita texto limpio y un contrato legible por máquinas.
Hemos hecho que la documentación sirva para ambos. Esto es lo que hay debajo.
Un gemelo .md de cada página
Sección titulada «Un gemelo .md de cada página»Cada página de la documentación de contenido tiene un gemelo en Markdown en bruto en la misma ruta con el sufijo .md. Si abres /agent-setup, también existe /agent-setup.md: el mismo texto sin el envoltorio HTML, con los imports de MDX eliminados, servido como text/markdown.
Esto alimenta dos acciones del menú de la página: Copy as Markdown (copia el texto limpio al portapapeles para pegarlo en un chat con el modelo) y View as Markdown (abre directamente la versión .md). El agente no necesita parsear el DOM: se lleva el texto ya listo.
Desplegable de acciones en la parte superior de la página
Sección titulada «Desplegable de acciones en la parte superior de la página»En la esquina superior derecha de cada página hay un menú de acciones pensado precisamente para el flujo de trabajo con agentes:
- Copy as Markdown: el texto limpio de la página al portapapeles
- View as Markdown: abrir el gemelo
.md - Open in ChatGPT: pasar la página a ChatGPT con un clic
- Open in Claude: lo mismo para Claude
- Connect MCP: ir a la configuración del servidor MCP
En lugar de “copia la URL, abre el chat, pide que entre en la página”, una sola acción.
llms.txt y llms-full.txt
Sección titulada «llms.txt y llms-full.txt»Siguiendo el estándar de llmstxt.org servimos dos archivos:
/llms.txt: un índice de todas las páginas de la documentación, agrupado en secciones (API Reference, Use Cases, Examples, Products). El mapa que le dice al agente por dónde empezar./llms-full.txt: toda la documentación en un único archivo de texto plano. Para indexarla offline en una base vectorial o para pegarla de una vez en el contexto del modelo.
Si construyes un RAG sobre nuestra API, llms-full.txt es un corpus ya preparado: no hace falta rastrear el sitio.
Especificaciones legibles por máquinas
Sección titulada «Especificaciones legibles por máquinas»El contrato se sirve en varios formatos para distintas herramientas:
/v1/openapi.json: la especificación canónica OpenAPI 3.1 con ejemplos y code samples. Para generar clientes y para cualquier herramienta de OpenAPI.- Alias de Swagger:
/v1/swagger.json,/v1/v3/api-docsy otros redirigen con 301 al canónico, para que las herramientas que buscan las rutas habituales no tropiecen. - Colección de Postman:
/postman/astroway-api.jsonpara importarla en Postman con un clic.
/agent-setup para cada cliente
Sección titulada «/agent-setup para cada cliente»La página /agent-setup/ no es una guía general, sino instrucciones separadas para siete clientes: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline y Codex. Cada una da la configuración exacta y un ejemplo curl de tools/list para comprobar la conexión antes de escribir código.
Try-it inline
Sección titulada «Try-it inline»En las páginas de la referencia de la API, cada operación tiene un widget try-it integrado: pegas una clave sandbox, editas el cuerpo de la petición, pulsas “Send” y ves la respuesta real sin salir de la documentación. El método, la ruta y el cuerpo de ejemplo se toman del snippet curl ya generado, así que el widget no hace peticiones de más a openapi.json.
Para qué sirve todo esto
Sección titulada «Para qué sirve todo esto»La tesis es simple: si tu producto es una API, la documentación tiene que servir no solo para leerla con los ojos, sino también para que la consuma un agente. Hoy la mitad de las integraciones empiezan cuando un desarrollador le pasa el enlace de la documentación a Claude o a Cursor y le pide “conecta esto”. Nos hemos asegurado de que al otro lado haya texto limpio y un contrato para máquinas, no HTML que haya que parsear.
Pruébalo tú mismo: abre cualquier página de la documentación, pulsa el menú de acciones arriba a la derecha y verás “Open in Claude”.
Posiciones al segundo de arco en 4 líneas de código.
Clave gratuita sin tarjeta. 5 000 llamadas al mes antes del primer pago.