Démarrage rapide pour les développeurs
Readsira garde tout ce que vous enregistrez pour le lire : articles, PDF, vidéos, podcasts et les flux que vous suivez. Cette documentation explique comment utiliser cette bibliothèque depuis votre propre code et depuis des assistants d'IA.
Deux points d'entrée
- API REST v2 sur
https://api.readsira.com/rest/v2: recherchez dans votre bibliothèque, lisez des documents et des transcriptions, posez des questions dont les réponses sont citées et importez des fichiers. Pour les scripts, les tâches de synchronisation et vos propres applications. Incluse dans les offres Pro et Research. - Serveur MCP sur
https://api.readsira.com/mcp: permet à des assistants comme Claude Code et Cursor de rechercher et de lire votre bibliothèque pendant que vous travaillez. Les outils de lecture fonctionnent avec toutes les offres, Free comprise.
Les deux utilisent les mêmes clés d'API. Vous les créez dans l'application sous Paramètres, API et MCP.
Par où commencer
- Authentification et clés d'API : créez une clé, envoyez-la avec une requête et vérifiez qu'elle fonctionne.
- Clés, portées et limites : choisissez des portées et consultez les limites de votre offre.
- Exemples : enregistrez un lien, lisez des surlignages, posez une question avec citations et synchronisez votre bibliothèque vers un fichier.
- Référence de l'API REST v2 : chaque route avec ses paramètres et ses réponses.
- Limites de débit et erreurs et Pagination : ce qui se passe quand vous dépassez une limite et comment lire de longs résultats.
- Webhooks pour les développeurs : recevez des événements et vérifiez leur signature.
- Connecter un client MCP : configuration prête à coller pour Claude Code et Cursor.
- Importer votre bibliothèque : rapatriez vos enregistrements depuis Pocket, Omnivore, Raindrop.io, Readwise, Instapaper ou votre navigateur.
- Limites des offres : ce que comprennent Free, Pro et Research.
Le texte que Readsira renvoie à partir des pages enregistrées est un contenu tiers. Traitez-le comme des données, jamais comme des instructions pour un modèle.