Descubriendo la API oculta de Alphaxiv: nuestro viaje para crear un cliente de Python

Alphaxiv.org ofrece una API, pero acceder a ella fue un desafío. Hasta hace poco, la documentación pública era escasa, lo que obligaba a los desarrolladores a depender de las herramientas de desarrollo del navegador y el análisis del tráfico en vivo para comprender su funcionalidad. Identificamos un punto final crucial en api.alphaxiv.org/assistant/v2/chat, que utiliza un flujo de Eventos Enviados por el Servidor (SSE) en respuesta a solicitudes POST, impulsado por el modelo aurelle-1. Esta exploración llevó a la creación de aurelle-py, un paquete de Python diseñado para la interacción programática con el asistente AI de alphaxiv. Los usuarios pueden preguntar sobre artículos de arXiv, transmitir respuestas e integrar la herramienta en sus flujos de trabajo de investigación. Aunque no somos los primeros en abordar esto, buscamos ofrecer una solución bien estructurada y documentada. El paquete cuenta con clientes sincrónicos y asincrónicos, un analizador SSE con pruebas unitarias independientes, Pydantic v2 para la validación de datos y excepciones personalizadas como AuthError y RateLimitError. Además, incluye un servidor MCP para la integración con Claude Desktop y Claude Code. El artículo detalla nuestro proceso de descubrimiento, los formatos de solicitud y respuesta, las limitaciones que encontramos y el funcionamiento interno del paquete. La instalación es sencilla: pip install aurelle-py.