Découverte de l'API cachée d'Alphaxiv : notre parcours pour créer un client Python

Alphaxiv.org propose une API, mais y accéder s'est avéré difficile. Jusqu'à récemment, la documentation publique était insuffisante, laissant les développeurs s'appuyer sur les outils de développement du navigateur et l'analyse du trafic en direct pour comprendre son fonctionnement. Nous avons identifié un point de terminaison crucial à api.alphaxiv.org/assistant/v2/chat, qui utilise un flux SSE en réponse aux requêtes POST, alimenté par le modèle aurelle-1. Cette exploration a conduit à la création d'aurelle-py, un package Python conçu pour l'interaction programmatique avec l'assistant AI d'alphaxiv. Les utilisateurs peuvent poser des questions sur des articles arXiv, diffuser des réponses et intégrer l'outil dans leurs flux de recherche. Bien que nous ne soyons pas les premiers à aborder ce sujet, nous avons cherché à offrir une solution bien structurée et documentée. Le package comprend des clients synchrones et asynchrones, un parseur SSE avec des tests unitaires indépendants, Pydantic v2 pour la validation des données et des exceptions personnalisées comme AuthError et RateLimitError. De plus, il inclut un serveur MCP pour l'intégration avec Claude Desktop et Claude Code. L'article détaille notre processus de découverte, les formats de requête et de réponse, les limitations rencontrées et le fonctionnement interne du package. L'installation est simple : pip install aurelle-py.