Zum Inhalt springen
AGENT-ANBINDUNG

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.

Dienst läuftVersion 4.0.0Anonym, nur lesend · kein Key nötig
REST API · 4.0.0

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.

Die erste Anfrage
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.

KategorieAnfrageparameter
KI-Modellecategory=ai-models
KI-Produktecategory=ai-products
Branchennewscategory=industry
Studiencategory=paper
Tutorialscategory=tip
Meinungencategory=opinion

Sparsam und schneller nutzen

  1. 01
    Kompression aktivieren

    Bei curl --compressed angeben, bei anderen Clients gzip oder br aktivieren. Komprimiertes JSON ist nur ein Viertel bis ein Achtel so groß.

  2. 02
    ETag mitsenden

    Speichern Sie den ETag der Antwort und senden Sie ihn beim nächsten Mal als If-None-Match mit; bei unverändertem Inhalt kommt 304 ohne Text.

  3. 03
    Im 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

PfadWofürWie oft abrufen
Meldungen
/api/v1/itemsAuswahl oder alle Meldungen der letzten 7 Tage, filterbar nach Kategorie, Zeitfenster und StichwortHöchstens einmal pro Minute
Trends und Ereignisse
/api/v1/hot-topicsAktuelle Trendliste Top 10Höchstens einmal pro Minute
/api/v1/stories/{publicId}Berichtszeitleiste, KI-Übersicht und verknüpfte Ereignisse eines EreignissesBei Bedarf
Tagesbericht
/api/v1/dailies/latestDie neueste Ausgabe des TagesberichtsEinmal nach täglich um 8 Uhr
/api/v1/dailies/{date}Tagesbericht eines bestimmten Datums; zurückgezogene Meldungen entfernen die ZitateNach Ablauf des Caches vor Nutzung den ETag prüfen
/api/v1/dailiesDatumsindex der TagesberichteEinmal täglich
Wochen- und Monatsbericht
/api/v1/weeklies/latestDie neueste Ausgabe des Wochenberichts: Schlagzeile, Gesamtübersicht und Wochenhighlights nach RubrikenEinmal nach montags um 9 Uhr
/api/v1/weeklies/{week}Eine bestimmte Woche, ISO-Woche wie 2026-W39; zurückgezogene Meldungen entfernen die ZitateNach Ablauf des Caches vor Nutzung den ETag prüfen
/api/v1/weekliesIndex der WochenberichteEinmal wöchentlich
/api/v1/monthlies/latestDie neueste Ausgabe des MonatsberichtsEinmal nach am 1. jedes Monats um 9:30 Uhr
/api/v1/monthlies/{month}Ein bestimmter Monat, etwa 2026-09Nach Ablauf des Caches vor Nutzung den ETag prüfen
/api/v1/monthliesIndex der MonatsberichteEinmal monatlich
Für KI-Assistenten
/api/v1/agentAnleitung für Agenten; die aufgeführten Adressen liefern aufbereitetes deutsches MarkdownBei Bedarf
Vollständige Synchronisierung der Auswahl
/api/v1/selected/snapshotDie gesamte aktuelle Auswahl, seitenweise in einem DurchgangNur beim ersten Mal
/api/v1/selected/changesSpätere Ergänzungen, Änderungen und RücknahmenAlle paar Minuten

Typische Verwendung

bash
# 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。