Notas de ingeniería.
Sobre la precisión de las efemérides, la arquitectura de cálculo, el protocolo MCP y todos los pequeños detalles que no caben en los docs.
Documentación hecha para agentes de IA, no solo para personas
La documentación clásica está hecha para ojos humanos: HTML cuidado, resaltado de código, navegación. Pero hoy la mitad del tráfico a la documentación son agentes y asistentes, que necesitan texto plano y no el renderizado. Repasamos lo que hemos añadido: un gemelo .md de cada página, llms.txt, especificaciones legibles por máquinas, un desplegable "abrir en ChatGPT / Claude" y try-it inline.
Leer →Numerología en API: 5 sistemas de cálculo en una sola ruta
La mayoría de los API o no tienen numerología, o ofrecen una sola sistema pitagórico. Nosotros tenemos 5 sistemas completos (pitagórico, caldeo, dos cabalísticos, védico) con 10 cálculos cada uno, en una única ruta parametrizada. Además Matriz del Destino para 22 arcanos.
Leer →Estructura de salida tipizada de MCP: ¿por qué 600+ herramientas tienen outputSchema
La mayoría de los servidores MCP devuelven a los agentes un JSON no tipizado - la modelo debe adivinar la forma de la respuesta. Publicamos una estricta outputSchema para 600+ herramientas. Exploramos cómo funciona, qué error lo abrió en los clientes de modo estricto y cómo lo arreglamos a través de esquemas abiertos.
Leer →Mapa del catálogo: cómo se organizan los más de 700 endpoints de AstroWay
La API ha crecido hasta más de 700 endpoints en 57 grupos, desde la carta natal hasta BaZi, la geomancia y el renderizado de cartas en SVG. Repasamos cómo se divide el catálogo en dominios, el patrón único que siguen todas las llamadas y cómo encontrar rápido el endpoint que necesitas.
Leer →Cómo mantenemos la precisión bajo control: CI frente a swetest y la NASA
En una API de astrología la precisión se degrada con facilidad por una sola refactorización de las efemérides. Repasamos la protección: un único núcleo Swiss Ephemeris para la aplicación y la API, cientos de snapshots congelados sobre cartas de referencia y la triangulación de cada PR frente a swetest CGI, Kerykeion, Prokerala y el catálogo de eclipses de la NASA.
Leer →Tres SDK oficiales: TypeScript, Python, PHP en lugar de curl sin procesar
El HTTP crudo funciona, pero un cliente tipado ahorra horas: autocompletado de rutas, tipos de solicitud y respuesta, reintento incorporado en 408/409/429/5xx y jerarquía de errores estilo Stainless. Analizamos los tres SDK oficiales - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - y cómo se generaron a partir de un único contrato OpenAPI.
Leer →Free Astrology API: Which One Has the Best Free Tier in 2026?
A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.
Leer →Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
Leer →