Dokumentation der API

Nachrichtenbeobachtung

Stonewake liest die weltweite Berichterstattung über jedes Unternehmen, das Ihr Arbeitsbereich im Bestand hält oder beobachtet, und über jede natürliche Person, die er beobachtet, und führt für jedes Unternehmen und jede Person eine tägliche Tonlage zusammen mit den Artikeln, auf denen sie beruht. Die Tonlagen stehen über die API und Assistenten mit KI über MCP zur Verfügung.

Woher die Nachrichten stammen

Die Artikel stammen vom GDELT Project, das alle 15 Minuten eine Datei mit den weltweit gefundenen Nachrichten veröffentlicht, auf Englisch und maschinell übersetzt aus etwa 65 Sprachen. Für jeden Artikel nennt die Datei die Organisationen und Personen, die er erwähnt, und die Tonlage des Dokuments als Ganzes. Stonewake liest jede englische Datei, sobald sie erscheint, und jede übersetzte Datei etwa eine Stunde nach ihrer Zeit, sobald der Downloadserver von GDELT sie ausliefert, und behält nur die Artikel, die ein Unternehmen oder eine Person nennen, die ein Arbeitsbereich beobachtet.

Daten von GDELT werden mit ihrer Quellenangabe und einem Link auf das GDELT Project (https://www.gdeltproject.org/) gezeigt. Jede Antwort trägt beides im Feld attribution.

Wie ein Artikel einem Unternehmen zugeordnet wird

Eine Organisation, die ein Artikel nennt, passt nur als ganzer Name zu einem Unternehmen, verglichen so, wie das Screening von Stonewake Namen vergleicht. Großschreibung und Kleinschreibung, Satzzeichen, Bindestriche und Akzente zählen nicht, Buchstaben wie ø, æ und ł gelten als o, ae und l, eine Rechtsform wird ausgeschrieben verglichen, sodass AG und Aktiengesellschaft dasselbe sind, und ein eingetragener Name gilt auch ohne die Rechtsform an seinem Ende, sodass Adolf Würth GmbH & Co. KG zu Adolf Wurth und Novo Nordisk A/S zu Novo Nordisk passt. Die Namen, die ein Register für das Unternehmen nennt, frühere Namen eingeschlossen, gelten als seine Namen. Ebenso gelten die Markennamen und Kurznamen, die die Aliasliste von Stonewake für den LEI des Unternehmens nennt, etwa BMW für Bayerische Motoren Werke Aktiengesellschaft oder VW für Volkswagen, und sie gelten nur für das Unternehmen, das diesen LEI trägt. Die Aliasliste beruht auf Wikidata und GLEIF. Ein Markenname oder Kurzname, der in keiner der beiden Quellen steht, oder jeder Markenname eines Unternehmens ohne seinen LEI passt nicht, und eine Tonlage zählt nur zugeordnete Artikel.

Ein Name, der einen anderen nur enthält, passt nie, sodass BP nie zu bpost passt. Ein Name, den zwei beobachtete Unternehmen teilen, passt zu keinem von beiden, ebenso ein Name, den die Aliasliste für zwei Unternehmen nennt, etwa Porsche. Ein Name auf der geprüften Liste von Stonewake mit Namen, die in den Nachrichten auch ein anderes Unternehmen, einen Ort, eine Institution oder ein gewöhnliches Wort bezeichnen, passt nie, gleich welches Unternehmen ihn nennt. Merck bezeichnet auch das US Unternehmen Merck & Co., deshalb wird Merck KGaA als Merck KGaA zugeordnet und nie als Merck allein. Dasselbe gilt für Hermes, Continental, Metro, Otto, Shell, Mercedes, Caterpillar, Bayer, RBI und etwa 30 weitere Namen. Jede Zuordnung behält den Organisationsnamen, den der Artikel verwendet, und den Unternehmensnamen, dem er gleicht.

Eine natürliche Person, die Ihr Arbeitsbereich beobachtet, passt zu einer Person, die ein Artikel nennt, wenn die ganzen Namen gleich sind, auf dieselbe Weise verglichen. Der eingetragene Name zählt mit den Vornamen zuerst, sodass MUSTER, Anna Maria zu Anna Maria Muster passt, ebenso der erste Vorname mit dem Nachnamen, Anna Muster. Ein einzelnes Wort passt nie, und ein Name, den zwei beobachtete Subjekte teilen, passt zu keinem. Ein Namensvetter mit demselben ganzen Namen kann passen, lesen Sie daher die Artikel. Personen werden nur beobachtet, wo Personendaten für Ihren Arbeitsbereich eingeschaltet sind, und nie eine Person, die widersprochen hat.

Was gespeichert wird

Für jeden zugeordneten Artikel speichert Stonewake seine Adresse, die Domain des Herausgebers, das Veröffentlichungsdatum, die Sprache und die Tonlage des Dokuments nach GDELT. Keine Überschrift und kein Artikeltext wird gespeichert, und kein Name einer Person außer dem Namen, der zu einer von Ihrem Arbeitsbereich beobachteten Person passte. Tägliche Tonlagen werden ein Jahr aufbewahrt, die Artikel und ihre Zuordnungen ein Jahr und 30 Tage, sodass jede aufbewahrte Tonlage auf ihre Artikel zurückgeführt werden kann. Danach werden sie gelöscht.

Die tägliche Tonlage

Jedes Unternehmen hat eine Tonlage je Tag, in UTC. Sie betrachtet die Artikel, die das Unternehmen in den 30 Tagen bis zu diesem Tag nannten, und hat einen von drei Zuständen.

• reading. Mindestens drei Artikel. tone_mean ist der Mittelwert der GDELT Tonlage dieser Artikel. GDELT misst die Tonlage der meisten Dokumente zwischen etwa minus 10, sehr negativ, und plus 10, sehr positiv. Der Mittelwert beschreibt die Berichterstattung, die das Unternehmen nennt, nicht die Sicht jedes einzelnen Artikels auf das Unternehmen. Ein Markenname nennt auch die Produkte des Unternehmens, sodass die Artikel eines Autoherstellers auch Autotests und Verkehrsmeldungen umfassen, und der Mittelwert beschreibt auch diese Berichterstattung.
• too_little_coverage. Weniger als drei Artikel, während jeder der 30 Tage vollständig gelesen wurde. Es wird keine Tonlage gezeigt.
• feed_gap. Der Tag selbst wurde nicht vollständig gelesen, oder es gibt weniger als drei Artikel, während einige der 30 Tage nicht vollständig gelesen wurden, sodass fehlende Artikel nicht auszuschließen sind. Es wird keine Tonlage gezeigt.

Jede Tonlage nennt article_keys, die neuesten 100 der Artikel, auf denen sie beruht, jeder Schlüssel der SHA-256 der Adresse des Artikels, während articles_window sie alle zählt, und gap_days, wie viele ihrer 30 Tage nicht vollständig gelesen wurden. Ein Tag ist vollständig gelesen, wenn jede 15 Minuten Datei dieses Tages im englischen und im übersetzten Strom gelesen wurde oder GDELT die Datei nicht innerhalb eines Tages nach ihrer Zeit veröffentlicht hat oder die Datei in drei Versuchen nicht gelesen werden konnte. Der laufende Tag ist deshalb nie vollständig gelesen, und seine Tonlage ist feed_gap, bis seine letzte Datei gelesen ist.

Die Tonlagen Ihres Arbeitsbereichs beruhen nur auf Artikeln, die für Ihren Arbeitsbereich zugeordnet wurden, gegen die eigenen Unternehmen Ihres Arbeitsbereichs. Stonewake liest außerdem frühere Dateien erneut, bis zu 30 Tage zurück, für jedes Unternehmen, das Ihr Arbeitsbereich im Bestand hält oder beobachtet, gleich wie kurz es schon in Bestand oder Beobachtungsliste steht, sodass die 30 Tage des Unternehmens von Anfang an vollständig sein können. Bis diese Dateien erneut gelesen sind, gelten der Tag, an dem die Beobachtung begann, und die Tage davor für Ihren Arbeitsbereich als nicht vollständig gelesen. Eine Tonlage zeigt nie Berichterstattung, die das Interesse eines anderen Arbeitsbereichs gesammelt hat.

Tonlage und Kreditsicht

Die Tonlage ist Kontext neben der Kreditsicht. Sie geht nicht in die Risikobewertung ein, die kein Modell und keine Nachrichten verwendet. Für eine Person, die Ihr Arbeitsbereich beobachtet, ist die Tonlage Kontext der Sorgfaltsprüfung, die Ihr Institut zu dieser Person durchführt, nie ein Score der Person. Ein Einzelkaufmann, das Geschäft einer natürlichen Person, hat keine Tonlage, weder eine Lesung noch die Tonlage eines Artikels, und antwortet daher mit latest null und ohne readings, während seine Artikel und Nachrichtenereignisse ausgeliefert werden.

Nachrichtenereignisse und Meldungen

Stonewake sucht in den Nachrichten außerdem nach ernsten Ereignissen zu jedem Unternehmen, das Ihr Arbeitsbereich im Bestand hält oder beobachtet, und meldet Ihrem Team, wenn eine Nachrichtenprüfung eines bestätigt. Die Art eines Ereignisses kommt aus GDELTs eigenen Themencodes, über eine geprüfte und versionierte Zuordnung. Ein Modell liest die Artikel erst danach und kann das Ereignis bestätigen oder von einer Meldung zurückhalten, siehe Die Nachrichtenprüfung unten. Die Arten sind Insolvenz, Sanktionen oder eine Strafe, Betrug, Korruption oder Geldwäsche, ein Cyberangriff oder ein Datenleck, ein Industrieunfall, eine Klage oder ein Kartellverfahren, ein Abgang oder eine Festnahme in der Führung, Stellenabbau oder Schließungen, ein Streik und ein Vorfall zu Umwelt oder Menschenrechten. GDELT hat kein Thema für einen Produktrückruf oder eine Herabstufung des Ratings, daher wird keines von beiden hier gefunden.

Ein Artikel zählt für ein Ereignis nur, wenn das Thema höchstens 200 Zeichen von einer Stelle entfernt steht, an der der Artikel das Unternehmen nennt, der Artikel das Unternehmen mindestens viermal und zuerst in seinen ersten 200 Zeichen nennt, seine Tonlage bei höchstens minus 1,5 liegt und kein Thema zu Polizei, Diebstahl oder Straßenverkehr nahe beim Unternehmen steht, das in echten Dateien eine Straftat oder einen Unfall mit einem Auto oder einer Filiale der Marke kennzeichnete. Ein Abgang in der Führung braucht außerdem eine Rolle wie Vorstandsvorsitz oder Aufsichtsratsvorsitz nahe beim Unternehmen. Ein Einzelkaufmann und eine beobachtete Person erhalten Ereignisse und Meldungen wie ein Unternehmen. Keine Person und kein Einzelkaufmann wird je bewertet, und ein Einzelkaufmann trägt keine Tonlage.

Die Artikel eines Unternehmens und einer Art innerhalb von 48 Stunden ergeben ein Ereignis, wenn sie aus mindestens zwei unabhängigen Quellen stammen, wobei Kopien eines übernommenen Artikels einmal zählen, und wenn sie mindestens das Doppelte der üblichen Rate des Unternehmens für diese Art in den 14 Tagen davor erreichen. Spätere Artikel in jeder Sprache kommen zum offenen Ereignis hinzu, statt eine neue Meldung auszulösen. Eine neue Meldung folgt nur, wenn eine schwerere Art erscheint oder die 48 Stunden vorbei sind. Dateien, die der Nachlauf erneut liest, lösen nie eine Meldung aus.

Eine Insolvenz ist kritisch, wenn mindestens drei unabhängige Quellen in mindestens zwei Sprachen über sie berichten, sonst hoch. Sanktionen, ein Streik, ein Abgang in der Führung und ein Vorfall zu Umwelt oder Menschenrechten sind Information, die übrigen Arten hoch. Ein Nachrichtenereignis, das die Nachrichtenprüfung bestätigt hat, meldet sich als Pressemeldung über die Abonnements Ihres Teams, die Ruhezeiten und jede Budgetgrenze wie jede andere Meldung und erreicht ein Telefon nur, wenn es kritisch ist. Die Mail nennt das Unternehmen, die Art des Ereignisses, wie viele Artikel in wie vielen Sprachen und den Link zu den Nachrichten des Unternehmens im Dashboard. Teams Karten und Webhook Nachrichten mit der Einstellung ausführlich tragen die Art und die Zahlen, eine SMS bleibt die kurze Nachricht ohne Namen.

Die Nachrichtenprüfung

Vor jeder Meldung liest eine Nachrichtenprüfung die Artikel. Stonewake ruft die neuesten Artikel des Ereignisses ab, höchstens acht und einen je Geschichte, über seinen üblichen Abruf, mit denselben Regeln zu robots.txt, zu Seiten, die auf unsere Anfrage warten, und zu Budgetgrenzen wie bei jedem anderen Abruf. Eine Seite, die nicht rechtzeitig antwortet, bleibt außen vor. Claude Haiku 5.5 liest bis zu fünf davon zusammen mit der Identität des Unternehmens, seinem Registernamen, den Namen, die seine Register nennen, seinem Land, seiner Rechtsform und Kennungen wie dem LEI. Für eine beobachtete Person liest es den eingetragenen Namen und das Land, mit einem Prompt für eine Person, als Teil der Sorgfaltsprüfung, die Ihr Institut zu dieser Person durchführt. Das Modell antwortet mit ja, nein oder unsicher, nennt die Art des Ereignisses und zitiert die Artikel.

Wenn weniger als fünf Artikel gelesen werden können, kann eine zweite Quelle vollständige Texte hinzufügen. Stonewake sucht dann einmal für das Ereignis in NewsAPI.ai (Event Registry), nach dem freigegebenen Suchnamen des Unternehmens zusammen mit den Wörtern der Art des Ereignisses über die 48 Stunden des Ereignisses, und fügt Artikel weiterer Herausgeber hinzu, deren Text das Unternehmen nahe einem solchen Wort nennt, einen je Herausgeber und bis zu fünf Artikel insgesamt. Gesucht wird nur für ein Unternehmen, dessen Suchprofil unser Betrieb von Hand angelegt und freigegeben hat, nachdem er eine Stichprobe dessen gelesen hat, was der Name findet, damit Namensvettern außen vor bleiben, nie für eine Person oder einen Einzelkaufmann, und nur für einen Arbeitsbereich ohne eigene Liste von Suchanbietern. Die zweite Quelle eröffnet nie ein Ereignis, fügt nie eine Art hinzu und hebt nie einen Schweregrad, ihre Artikel durchlaufen dieselbe Prüfung wie jeder andere Artikel, und die Nachrichtenkarte des Unternehmens, die API und MCP nennen jene, die die Prüfung gelesen hat, unter der Prüfung des Ereignisses mit Link, Herausgeber, Datum und Sprache, nie mit Überschrift oder Text. Sie ist ausgeschaltet, solange Ihr Vertrag sie nicht umfasst.

Die Antwort zählt nur, wenn eine deterministische Prüfung sie bestätigt. Jedes Zitat muss aus einem der Artikel stammen, die die Prüfung gelesen hat, denen des Ereignisses oder denen der zweiten Quelle, und Wort für Wort im Text stehen, den die Prüfung gelesen hat. Die Art muss eine sein, die die Themenzuordnung für das Ereignis bereits gefunden hat, sodass das Modell ein Ereignis eingrenzen, aber nie erweitern kann. Ein Ja braucht Zitate von mindestens zwei verschiedenen Herausgebern, sodass die Artikel eines einzelnen Herausgebers allein nie eine Meldung auslösen. Zwei Herausgeber zählen als einer, wenn ihre Zitate dieselbe Passage sind, etwa ein und derselbe Satz einer Nachrichtenagentur, und auch dann, wenn der Artikel jedes der beiden die Passage enthält, die aus dem anderen zitiert wird, etwa ein und dieselbe Agenturmeldung auf zwei Websites. Die Prüfung sieht, wo ein Zitat steht, nicht, was es belegt. Ein Modell, das sich von einem Artikel täuschen lässt, kann deshalb ein Ereignis bestätigen, das die Regel gefunden hat. Es kann aber nie ein Ereignis hinzufügen, nie eine Art wählen, die die Zuordnung nicht gefunden hat, und nie einen höheren Schweregrad setzen. Artikeltext, der wie eine Anweisung an ein Modell klingt, bleibt aus der Prüfung heraus und wird unserem Betrieb genannt. Jede andere Antwort gilt als unsicher. Der Schweregrad folgt der bestätigten Art und steigt nie über den der Regel, sodass nur ein Ereignis, das die Regel bereits als kritisch einstuft, ein Telefon erreichen kann.

Nur ein bestätigtes Ereignis meldet sich. Jedes andere Ereignis bleibt auf der Nachrichtenkarte des Unternehmens als Bericht zum Lesen, ohne Art und ohne Schweregrad, und wird nie verborgen oder gelöscht. Wenn die Prüfung nicht laufen kann, weil das Modell, das Budget oder der Abruf nicht verfügbar ist, geht keine Meldung hinaus, das Ereignis hält den Grund fest, unser Betrieb sieht die Zahl solcher Ereignisse, und die Prüfung läuft erneut, sobald die Ursache behoben ist. Stonewake speichert nur das Urteil, die bestätigte Art, den Schlüssel des ersten zitierten Artikels, Modell und Version der Anweisung und den Zeitpunkt der Prüfung sowie Link, Herausgeber, Datum und Sprache jedes Artikels aus NewsAPI.ai, den die Prüfung gelesen hat. Der Artikeltext und die Zitate liegen nur für die Prüfung im Speicher und werden danach verworfen. Ein Arbeitsbereich auf der EU Route wird dort mit seinem eigenen Modell geprüft.

Ein Arbeitsbereich, der das Unternehmen beobachtet, erhält ein Ereignis für den ganzen Arbeitsbereich. Ein Unternehmen, das nur in Teambeständen steht, erhält ein Ereignis für jedes Team, das es hält, sodass keine Meldung eines Teams ein Unternehmen aus dem Bestand eines anderen Teams nennt.

Gemessen an vier Wochen echter Dateien und 150 großen börsennotierten Unternehmen ergab die Regel für alle 150 zusammen etwa 1,4 Ereignisse am Tag, und etwa vier von zehn waren ein echtes ernstes Ereignis zum Unternehmen. Die Zahl beruht auf einer Einschätzung jedes Ereignisses und ist eine Wahrscheinlichkeit. Mit der Nachrichtenprüfung ergab eine Wiederholung von drei Wochen derselben Dateien 6 Meldungen für die 150 Unternehmen statt 32, und nach unserer Einschätzung war jede ein ernstes Ereignis zum Unternehmen, während etwa zwei Drittel der echten Ereignisse Berichte zum Lesen blieben, meist weil das Modell sie nicht als ernstes Ereignis zum Unternehmen las und manche, weil nur der Artikel eines Herausgebers gelesen werden konnte. Auf einem zweiten Bestand von 30 Unternehmen, die in der Praxis beobachtet werden, hielt die Prüfung alle 6 Meldungen zurück, die die Regel ausgelöst hätte und von denen keine eindeutig ein ernstes Ereignis zum Unternehmen war. In derselben Wiederholung mit NewsAPI.ai als zweiter Quelle bestätigte die Prüfung 9 der 14 von uns als echt eingestuften Ereignisse statt 4 und in zwei Läufen 1 oder 2 der 21 falschen statt 1 ohne sie. Auch diese Zahlen sind Einschätzungen, und die Antworten des Modells schwanken leicht von Lauf zu Lauf. Lesen Sie Berichte zum Lesen als Frühwarnung und ein bestätigtes Ereignis als Bericht, den man vor einer Entscheidung liest, nicht als Befund.

Routen

• GET /v1/news/companies listet die Unternehmen aus Bestand und Beobachtungsliste Ihres Arbeitsbereichs und die Personen, die er beobachtet, mit node_type person, jedes mit seiner neuesten Tonlage eines vollständig gelesenen Tages, seitenweise mit limit und offset. Ein Unternehmen ohne gespeicherte Tonlage antwortet mit latest null, was nichts über seine Berichterstattung sagt.
• GET /v1/news/companies/{node_id} liefert die Tonlagen eines Unternehmens, neueste zuerst, days davon (30, wenn nichts angegeben ist, höchstens 90), und die neuesten 100 Artikel hinter der neuesten samt jedem Artikel, den seine Ereignisse nennen, jeden mit article_key, url, publisher_host, published_at, language, gdelt_tone und matched_organization. Seine events listen die Nachrichtenereignisse des Unternehmens aus denselben Tagen, neueste zuerst, höchstens 20, jedes mit event_type, severity, opened_at (der erste Artikel), detected_at, closes_at, last_article_at, articles, sources, languages, alerted, article_keys (die neuesten 20 Artikel), mapping_version, rule_version und check, die Nachrichtenprüfung mit ihrem status (confirmed, not_confirmed, pending, unchecked oder covered), verdict, der bestätigten event_type und severity, dem ersten zitierten article_key, reason, model, prompt_version, checked_at und second_source_articles, den Artikeln aus NewsAPI.ai, die die Prüfung neben denen des Ereignisses gelesen hat, jeder mit article_key, url, publisher_host, published_at, language und provider. Nur ein Ereignis mit confirmed meldet sich. Ein Team liest die Ereignisse seines eigenen Teams und jene für den ganzen Arbeitsbereich.

Ein Schlüssel liest die Unternehmen aus dem Bestand seines eigenen Teams und die Unternehmen und Personen, die sein Arbeitsbereich beobachtet. Jedes andere Unternehmen antwortet mit 404, sodass die Routen nie zeigen, welche Unternehmen ein anderer Arbeitsbereich verfolgt. Das MCP Werkzeug company_news liest beide Routen.