Zum Hauptinhalt springen

Schnellstart für Entwickler

Readsira bewahrt alles auf, was du zum Lesen speicherst: Artikel, PDFs, Videos, Podcasts und die Feeds, denen du folgst. Diese Dokumentation erklärt, wie du diese Bibliothek aus deinem eigenen Code und aus KI-Assistenten nutzt.

Zwei Wege hinein​

  • REST API v2 unter https://api.readsira.com/rest/v2: Durchsuche deine Bibliothek, lies Dokumente und Transkripte, stelle Fragen, die mit Quellenangaben beantwortet werden, und lade Dateien hoch. Für Skripte, Sync-Jobs und deine eigenen Apps. Teil der Tarife Pro und Research.
  • MCP-Server unter https://api.readsira.com/mcp: Damit können Assistenten wie Claude Code und Cursor deine Bibliothek durchsuchen und lesen, während du arbeitest. Lese-Tools funktionieren in jedem Tarif, auch in Free.

Beide nutzen dieselben API-Schlüssel. Du erstellst sie in der App unter Einstellungen, API und MCP.

Wo du anfängst​

  1. Authentifizierung und API-Schlüssel: Erstelle einen Schlüssel, sende ihn mit einer Anfrage und prüfe, dass er funktioniert.
  2. Schlüssel, Scopes und Limits: Wähle Scopes und sieh dir die Limits deines Tarifs an.
  3. Beispiele: Speichere einen Link, lies Markierungen, stelle eine Frage mit Quellenangaben und synchronisiere deine Bibliothek in eine Datei.
  4. REST-API-v2-Referenz: Jede Route mit Parametern und Antworten.
  5. Ratenlimits und Fehler und Paginierung: Was dich erwartet, wenn du ein Limit überschreitest, und wie du lange Ergebnisse liest.
  6. Webhooks für Entwickler: Empfange Ereignisse und prüfe ihre Signatur.
  7. Einen MCP-Client verbinden: Einrichtung zum Einfügen für Claude Code und Cursor.
  8. Deine Bibliothek importieren: Hole deine Speicherungen aus Pocket, Omnivore, Raindrop.io, Readwise, Instapaper oder deinem Browser.
  9. Tariflimits: Was Free, Pro und Research enthalten.

Text, den Readsira aus gespeicherten Seiten zurückgibt, ist Inhalt Dritter. Behandle ihn als Daten, nie als Anweisungen an ein Modell.