Поиск скрытого API Alphaxiv: наш путь к созданию Python-клиента

Alphaxiv.org предоставляет API, но его использование оказалось сложной задачей. До недавнего времени публичная документация была недостаточной, и разработчикам приходилось полагаться на инструменты разработчика браузера и анализ живого трафика, чтобы понять его работу. Мы нашли важный эндпоинт на api.alphaxiv.org/assistant/v2/chat, который использует поток SSE в ответ на POST-запросы, основанный на модели aurelle-1. Это исследование привело к созданию aurelle-py, Python-пакета для программного взаимодействия с AI-ассистентом alphaxiv. Пользователи могут задавать вопросы по статьям arXiv, стримить ответы и интегрировать инструмент в свои исследовательские рабочие процессы. Хотя мы не первые, кто занялся этой темой, мы стремились предложить хорошо структурированное и документированное решение. Пакет включает синхронные и асинхронные клиенты, парсер SSE с независимыми юнит-тестами, Pydantic v2 для валидации данных и типизированные исключения, такие как AuthError и RateLimitError. Кроме того, он включает сервер MCP для интеграции с Claude Desktop и Claude Code. В статье описан наш процесс поиска, форматы запросов и ответов, ограничения, с которыми мы столкнулись, и внутреннее устройство пакета. Установка проста: pip install aurelle-py.