KI-Radar in Ihren Agenten einbinden
MCP, RSS, API: drei Wege, dieselben Daten zu lesen – Auswahl, Trends, Tages-, Wochen- und Monatsbericht. Wählen Sie, was zu Ihrem Werkzeug passt. Alles anonym und nur lesend, ohne Registrierung und ohne API-Key.
Anonymes GET, sofort nutzbar
Kein Token nötig; Browser (Cross-Origin), curl und die Standard-HTTP-Clients aller Sprachen können direkt aufrufen. Der Pfad ist /api/v1, maßgeblich für Felder und Fehlercodes ist die OpenAPI-Beschreibung.
curl --compressed 'https://news.joerg-esser.de/api/v1/items?mode=selected&window=24h&limit=20'Nach Kategorie filtern
Fügen Sie der Meldungsanfrage category hinzu, um nur die entsprechende Kategorie zu erhalten; ohne Angabe sind alle Kategorien enthalten. Das category der zurückgegebenen Einträge verwendet ebenfalls die Werte der Tabelle unten.
| Kategorie | Anfrageparameter |
|---|---|
| KI-Modelle | category=ai-models |
| KI-Produkte | category=ai-products |
| Branchennews | category=industry |
| Studien | category=paper |
| Tutorials | category=tip |
| Meinungen | category=opinion |
Sparsam und schneller nutzen
- 01Kompression aktivieren
Bei curl
--compressedangeben, bei anderen Clients gzip oder br aktivieren. Komprimiertes JSON ist nur ein Viertel bis ein Achtel so groß. - 02ETag mitsenden
Speichern Sie den ETag der Antwort und senden Sie ihn beim nächsten Mal als
If-None-Matchmit; bei unverändertem Inhalt kommt 304 ohne Text. - 03Im Takt abrufen
Meldungen und Trends höchstens einmal pro Minute; den Tagesbericht einmal nach täglich um 8 Uhr, Wochen- und Monatsbericht nach Erscheinen; beim Zurückblättern aufhören, sobald ein bekannter Eintrag erreicht ist.
Wie oft sich Inhalte ändern: Neue Meldungen kommen den ganzen Tag über, die Auswahl ändert sich einige bis einige Dutzend Mal täglich; der Tagesbericht erscheint täglich um 8 Uhr, der Wochenbericht montags um 9 Uhr, der Monatsbericht am 1. jedes Monats um 9:30 Uhr.
Schnittstellen im Überblick
| Pfad | Wofür | Wie oft abrufen |
|---|---|---|
| Meldungen | ||
/api/v1/items | Auswahl oder alle Meldungen der letzten 7 Tage, filterbar nach Kategorie, Zeitfenster und Stichwort | Höchstens einmal pro Minute |
| Trends und Ereignisse | ||
/api/v1/hot-topics | Aktuelle Trendliste Top 10 | Höchstens einmal pro Minute |
/api/v1/stories/{publicId} | Berichtszeitleiste, KI-Übersicht und verknüpfte Ereignisse eines Ereignisses | Bei Bedarf |
| Tagesbericht | ||
/api/v1/dailies/latest | Die neueste Ausgabe des Tagesberichts | Einmal nach täglich um 8 Uhr |
/api/v1/dailies/{date} | Tagesbericht eines bestimmten Datums; zurückgezogene Meldungen entfernen die Zitate | Nach Ablauf des Caches vor Nutzung den ETag prüfen |
/api/v1/dailies | Datumsindex der Tagesberichte | Einmal täglich |
| Wochen- und Monatsbericht | ||
/api/v1/weeklies/latest | Die neueste Ausgabe des Wochenberichts: Schlagzeile, Gesamtübersicht und Wochenhighlights nach Rubriken | Einmal nach montags um 9 Uhr |
/api/v1/weeklies/{week} | Eine bestimmte Woche, ISO-Woche wie 2026-W39; zurückgezogene Meldungen entfernen die Zitate | Nach Ablauf des Caches vor Nutzung den ETag prüfen |
/api/v1/weeklies | Index der Wochenberichte | Einmal wöchentlich |
/api/v1/monthlies/latest | Die neueste Ausgabe des Monatsberichts | Einmal nach am 1. jedes Monats um 9:30 Uhr |
/api/v1/monthlies/{month} | Ein bestimmter Monat, etwa 2026-09 | Nach Ablauf des Caches vor Nutzung den ETag prüfen |
/api/v1/monthlies | Index der Monatsberichte | Einmal monatlich |
| Für KI-Assistenten | ||
/api/v1/agent | Anleitung für Agenten; die aufgeführten Adressen liefern aufbereitetes deutsches Markdown | Bei Bedarf |
| Vollständige Synchronisierung der Auswahl | ||
/api/v1/selected/snapshot | Die gesamte aktuelle Auswahl, seitenweise in einem Durchgang | Nur beim ersten Mal |
/api/v1/selected/changes | Spätere Ergänzungen, Änderungen und Rücknahmen | Alle paar Minuten |
Typische Verwendung
# Erstes Mal: ETag aus dem Antwort-Header speichern
curl --compressed -i 'https://news.joerg-esser.de/api/v1/items?mode=selected&window=24h&limit=20'
# Danach höchstens einmal pro Minute, mit ETag; 304 bedeutet unverändert
curl --compressed -i -H 'If-None-Match: <ETag der letzten Antwort>' 'https://news.joerg-esser.de/api/v1/items?mode=selected&window=24h&limit=20'Zum Zurückblättern geben Sie page.nextCursor als cursor zurück und hören auf, sobald ein bekannter Eintrag erreicht ist; blättern Sie nicht jedes Mal alle 7 Tage neu durch.
Was bei Fehlern tun?
- 400
- Falsche Parameter: Anhand von OpenAPI und dem zurückgegebenen code korrigieren, nicht automatisch auf eine breitere Abfrage wechseln. Ungültiger cursor oder einer außerhalb des Zeitfensters liefert invalid_cursor, dann ab der ersten Seite neu beginnen.
- 409
- snapshot_required: Die Änderungen lassen sich nicht sicher fortsetzen, holen Sie den vollständigen Snapshot erneut.
- 429
- Zu viele Anfragen: Gemäß Retry-After warten, nicht parallel wiederholen.
- 5xx
- Exponentielles Backoff, zunächst das letzte erfolgreiche Ergebnis weiterverwenden; der öffentliche Dienst gibt keine SLA-Zusage.
Anonymer Abruf bedeutet nicht, dass jede Nutzung erlaubt ist, siehe Nutzungsbedingungen。