Du planst deinen Samstag rund um Arsenals Auswärtsspiel in Newcastle. Ein Freund in New York braucht die Anstoßzeit. Dann fragt jemand im Gruppenchat, wie das letzte Auswärtsspiel für Arsenal gelaufen ist. Die erste Antwort findest du im Spielplan. Für die zweite musst du wissen, wer bei „Liverpool 0, Arsenal 1“ das Tor geschossen hat.
Du baust Matchday Notebook, einen Fußball-Chatbot, der die nächsten drei Premier-League-Spiele abruft, die letzten fünf Ligaergebnisse von Arsenal anzeigt und ihren Tabellenplatz findet. Das Beispiel ist auf den 18. November 2026 datiert. Das Auswärtsspiel in Newcastle war für Samstag, den 21. November um 17:30 UTC angesetzt, also 12:30 Uhr in New York.
Die Match-Seite des Anbieters und der private Agent sind sich über den Anstoß einig. Die Quickchat AI-Konversation lief mit einem datierten Replay öffentlicher Daten, das du unten reproduzieren kannst.
Sieh dir das Spiel gegen Newcastle an oder lade das Matchday Notebook-Kit herunter. Entpacke es und führe python3 replay.py aus, um die drei Spiele, fünf Ergebnisse und den Tabelleneintrag ohne Account zu sehen. Dasselbe Kit enthält die Action-Einstellungen und den Main Prompt, um deinen eigenen Feed anzubinden.
1. Welchem Verein und welchem Wettbewerb soll der Chatbot folgen?
Lege zuerst den Verein und die Liga fest. Arsenals Form in der Liga kann sich ändern, je nachdem, ob du ein Spiel unter der Woche in Europa mitzählst. In diesem Notebook bedeutet Arsenal Team 57 und Liga bedeutet Premier League 2021, auch bekannt unter dem Kürzel PL.
- Öffne das Registrierungsformular von football-data.org. Gib deinen Vornamen und deine E-Mail-Adresse ein, akzeptiere die Bedingungen und wähle Create account. Überprüfe deine Liga auf der Abdeckungsliste. Der kostenlose Plan beinhaltet die Premier League, mit verzögerten Spielplänen und Ergebnissen.
Verwende eine E-Mail-Adresse, die du abrufen kannst. football-data.org sendet den API-Schlüssel nach der Registrierung dorthin. Der kostenlose Plan erlaubt 10 Anfragen pro Minute.
Wenn du bereits ein Konto hast, melde dich mit deiner E-Mail und deinem API-Token an. Wenn du eine weitere Kopie des Tokens benötigst, fordere sie per E-Mail an, indem du die Adresse verwendest, mit der du dich registriert hast. Behalte das Token für den geschützten Header in Schritt 2.
Überprüfe deinen Plan unter Subscription und suche deine Liga unter Available competitions. Dieser Auszug zeigt die UEFA Champions League (CL) und die Bundesliga (BL1).
- Um einem anderen Verein zu folgen, suche ihn in der Teamliste des Wettbewerbs, zum Beispiel
GET /v4/competitions/PL/teams. Verwende die zurückgegebene Team-ID und Wettbewerbs-ID in den untenstehenden Spielanfragen. Der v4-Quickstart enthält beide Suchvorgänge. - Erstelle einen Quickchat AI-Agent, nenne ihn Matchday Notebook und behalte ihn privat, während du testest. Du benötigst verfügbare Credits für Konversationen und Simulationen. Öffne Identity → AI Persona → Main Prompt und füge die Anweisungen unten ein. Die Screenshots und die Einstellungen zum Kopieren sind auf Englisch.
Behalte denselben Verein an beiden Stellen bei. Im Produkt befinden sich die Anweisungen des Agenten unter Identity.
Kopiere den Matchday Notebook Main Prompt
You are Matchday Notebook, an Arsenal Premier League companion. Use get_club_fixtures for the schedule, get_recent_results for form and get_league_standings for the league table. For match reads, use an inclusive UTC start date and an exclusive end date. Ask for dates when the window is unclear.
List up to the requested number of TIMED or SCHEDULED fixtures in kickoff order. Give the date, time and timezone; say when the hour is unconfirmed. Flag postponed or cancelled games separately. For form, sort FINISHED matches newest first, take up to five and read full-time scores home first. Judge wins, draws and losses from Arsenal's side. For standings, find Arsenal (team 57) in the TOTAL table. Give the season, position, games played and points.
Keep answers short. Link a match to https://native-stats.org/match/ID using its returned ID, and the Premier League table to https://native-stats.org/competition/PL/. Attribute football-data.org, give the relevant date and identify any snapshot as a snapshot. Quote a retrieval time only if supplied. Keep null scores unknown. Report empty windows, missing scores and failed reads accurately. Stop after a rate limit. Do not predict scores.
2. Wie bekommst du das nächste Spiel von Arsenal?
Beginne mit der Action, die die Frage nach dem Anstoß im Gruppenchat beantwortet. Eine einzige Anfrage liefert beide Vereine, die Anstoßzeit und den Spielstatus. Lass den Statusfilter hier offen, damit auch eine Verlegung angezeigt werden kann. Ein TIMED-Eintrag hat eine Anstoßzeit. Bei SCHEDULED teilst du dem Leser mit, dass die Uhrzeit noch bestätigt werden muss.
- Öffne Actions & MCPs → Add Action → API Action → Create manually. Setze API Action Name auf
get_club_fixturesund When to run auf AI decides. Füge unter What to ask the user first die erforderlichen Text-Eingabendate_fromunddate_tohinzu, beide mit No default. Ihre Beschreibungen sind „Erstes einzuschließendes UTC-Datum, YYYY-MM-DD“ und „Erstes auszuschließendes UTC-Datum, YYYY-MM-DD“. - Wähle für API Endpoint GET und gib die untenstehende URL ein. Öffne Query Params und setze
competitionsauf den Literalwert2021. FügedateFromunddateTohinzu. Verwende für jeden Wert Add AI Data → Parameters, um die passende Datumseingabe einzufügen. Lasse Body leer. - Füge die Beschreibung unten unter API Action Description ein und speichere die Action. Unter Headers kommt der Credential in eine schreibgeschützte
X-Auth-Token-Zeile. Richte das vor deiner ersten Anfrage ein. Füge einen zweiten, gewöhnlichen Header mitAcceptals Schlüssel undapplication/jsonals Wert hinzu. Verwende dieselben beiden Header für alle drei Actions.
https://api.football-data.org/v4/teams/57/matches
Folge der Route für Team-Spiele aus der Anbieterreferenz in die Action. Arsenal ist in der URL fest codiert, die Liga in Query Params, und die beiden Daten stammen aus der Konversation.
Beschreibung der Spielplan-Action kopieren
Use for Arsenal's upcoming Premier League fixtures in the requested date window. Sort by utcDate ascending. Show TIMED or SCHEDULED matches and flag postponements or cancellations separately. State the window if fewer fixtures are returned.
In den Anfragebeispielen des Anbieters wird der API-Schlüssel in X-Auth-Token platziert. Verwende denselben Header-Namen in Headers bei get_club_fixtures.
Das Anmeldeformular benötigt deine E-Mail und dein API-Token. In Quickchat AI wird nur das Token in die geschützte X-Auth-Token-Zeile eingetragen.
Gib das Token privat ein. Das Dashboard kann ein gespeichertes Secret ersetzen. Um diesen Header von vornherein nur beschreibbar zu machen, verwende die Kontoverbindung einmal pro Action. Verbinde dein Konto mithilfe der Quickchat AI-Einrichtungsanleitung in ChatGPT oder Claude. Bitte den verbundenen Assistenten, den Header mit einem harmlosen Platzhalter gemäß der folgenden Anweisung vorzubereiten. Öffne dann selbst den Tab Headers der Action, ersetze den Wert in derselben Zeile durch dein football-data.org-Token und wähle Save changes. Öffne den Editor erneut und überprüfe, ob [redacted] angezeigt wird. Bewahre das Token im Dashboard und außerhalb der Konversation auf.
On Matchday Notebook, set the X-Auth-Token header of get_club_fixtures to the literal value REPLACE_IN_DASHBOARD with is_secret=true. Preserve the rest of the settings. Read the Action back and confirm that the header is secret and the value is [redacted]. Stop before testing.
Das ist der gespeicherte Header. Der Anbieter erwartet das Token allein, ohne das Präfix Bearer.
Probiere den ersten Lesevorgang aus. Gib unter Test Response → Test the API ein Startdatum und den Tag nach deinem letzten gewünschten Datum an. Aktiviere dann die Action und frage in der AI Preview nach den nächsten drei Ligaspielen in diesem Zeitraum. Wähle für einen Live-Build bevorstehende Daten. Das Archivbeispiel verwendete 2026-11-18 und 2026-12-03, sodass der Abend des 2. Dezember dazugehörte. Überprüfe das nächste Spiel, indem du den Quelllink öffnest. Die v4-Referenz zum Datumsfilter erklärt das exklusive Enddatum.
Im Replay fand das Auswärtsspiel bei Newcastle am 21. November statt, das Heimspiel gegen Manchester City am 29. November und das Auswärtsspiel bei Brentford am 2. Dezember. Hätte die Anfrage am 2. Dezember geendet, wäre Brentford nicht dabei gewesen.
3. Wie liest du die letzten fünf Ergebnisse aus Sicht von Arsenal?
Das aufschlussreichste Spiel in diesem Beispiel endete Liverpool 0, Arsenal 1. Wenn der Chatbot die erste Zahl jedes Mal als Arsenals Ergebnis behandelt, macht er aus einem Auswärtssieg eine Niederlage. Behalte bei jedem Ergebnis die Reihenfolge Heim/Auswärts bei und nutze die Team-ID, um zu entscheiden, wie Arsenal abgeschnitten hat.
- Erstelle eine zweite API Action mit dem Namen
get_recent_results. Verwende denselben GET-Endpunkt, dieselben Datumseingaben, Datums-Chips und denselben Wettbewerbsfilter. Füge die Abfragezeilestatusmit dem WertFINISHEDhinzu. - Setze die Beschreibung unten. Wiederhole die Einrichtung des schreibgeschützten Headers für
get_recent_results, überprüfe die Maske und aktiviere die Action. - Frage nach den fünf letzten Ligaspielen in einem angegebenen Zeitraum. Verwende für das Beispiel den 1. Oktober bis 17. November 2026. Sortiere nach
utcDate, bevor du die fünf Ergebnisse nimmst. Wenn der Zeitraum nur drei Ergebnisse liefert, zeige diese drei an und biete an, weiter zurückzuschauen.
Beschreibung der Ergebnisse-Action kopieren
Use for Arsenal's recent Premier League form in the requested date window. Sort FINISHED matches newest first, then take up to five. Use both full-time goals and the home and away team IDs to judge each result from Arsenal's perspective.
Finde zuerst Arsenal auf der Auswärtsseite und lies dann das Auswärtstor ab. Liverpools Null bedeutet, dass sie kein Tor erzielt haben.
Lies die Serie beginnend mit dem neuesten Spiel. Arsenal schlug Hull mit 1:0, gewann 1:0 bei Liverpool, schlug Everton mit 2:0, gewann 1:0 bei Nottingham Forest und schlug Leeds mit 2:1. Das macht fünf Siege, sieben Tore erzielt und ein Gegentor kassiert. Der Spielbericht zum Liverpool-Spiel ist ein guter Test, da die Siegermannschaft an zweiter Stelle steht.
In den gespeicherten Testdaten beginnt die zurückgegebene Liste absichtlich mit dem Spiel gegen Leeds und endet mit dem Spiel gegen Hull. Durch das Sortieren nach Anstoßzeit rückt das Spiel gegen Hull an den Anfang der Antwort. Öffne die Action-Antwort neben dem Chat und vergleiche das erste und letzte Spiel in beiden Listen.
Fünf Siege können ein wichtiges Detail verbergen. Zwei davon waren Auswärtssiege, daher steht die höhere Toranzahl auf der rechten Seite.
4. Woher kommen Tabellenplatz und Punkte?
Fünf Siege verraten dir, wie die letzten Wochen gelaufen sind. Der Tabellenplatz hängt aber auch von allen vorherigen Spielen und den Ergebnissen der anderen Teams ab. Gib dem Agenten eine separate Action für die Tabelle.
- Nenne sie
get_league_standings. Wähle GET, füge den Endpunkt unten ein und lasse die Eingaben, Abfrageparameter und den Body leer. Verwende AI decides, füge die Beschreibung unten hinzu und wiederhole die Einrichtung des nur beschreibbaren Headers für diese Action. - Suche in der Test Response unter
standingsnach dem Eintrag, dessentypegleichTOTAList. Finde darin untertableden Eintrag, bei demteam.idgleich57ist. Aktiviere die Action und stelle die Frage „Wo steht Arsenal in der Premier-League-Tabelle?“ - Vergleiche
position,playedGamesundpointsmit der Quelle für dieselbe Saison und dasselbe Datum. Am 18. November zeigte die Premier-League-Tabelle in Native Stats Platz 1, 10 Spiele, 27 Punkte. Deine aktuelle Tabelle wird sich ändern, wenn andere Vereine spielen.
https://api.football-data.org/v4/competitions/PL/standings
Beschreibung der Tabellen-Action kopieren
Use for the current Premier League table. Find team ID 57 in standings where type is TOTAL. Report season, position, playedGames and points. If the row is missing, say the position is unavailable.
Lies eine einzelne Zeile in TOTAL. Die 27 Punkte umfassen alle zehn Ligaspiele in der Momentaufnahme.
5. Kannst du das Spieltags-Briefing zu seinen Quellen zurückverfolgen?
Starte eine neue Konversation in der AI Preview. Frage nach den nächsten drei Spielen, dann „Wie haben wir in unseren letzten fünf Ligaspielen abgeschnitten?“, gib den Zeitraum für die Ergebnisse an und frage dann „Wo stehen wir damit in der Tabelle?“. Öffne in der Inbox für jede Antwort die Markierung für die aufgerufene Action. Unter View logs der Action kannst du die Parameter und die Antwort mit dem vergleichen, was der Fan gesehen hat. Die Anleitung zum Erstellen einer API Action zeigt dir, wo du diese Steuerelemente findest.
Um die am Anfang des Artikels gezeigte kombinierte Spieltagsübersicht zu erhalten, stelle die folgende Frage mit den Daten aus dem gespeicherten Beispiel. Für eine aktuelle Zusammenfassung verwende bevorstehende Daten für den Spielplan und kürzliche Daten für die Ergebnisse.
Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.
Überprüfe die Daten und die Spiel-ID im Aufruf. Im lokalen Replay ist 560651 das Spiel gegen Newcastle.
Für eine wiederholbare Überprüfung öffne Conversations → Testing, erstelle ein Test-Set und speichere die drei Fragen. Füge die beiden unten gezeigten Grenzfall-Fragen hinzu. Führe das Test-Set aus, nachdem du eine Action-Beschreibung geändert hast, und überprüfe die Aufrufe zusammen mit den Antworten. Verwende eine kontrollierte Antwort, um einen seltenen Status oder einen Fehler zu testen. Eine rein hypothetische Frage testet nur die Formulierung einer Antwort.
Verwende nach jeder Bearbeitung dieselben Fragen. Das Auswärtsergebnis deckt einen Fehler bei der Torzuordnung auf, den ein reiner Heim-Test übersehen würde.
| Testfall | Was der Fan hören sollte |
|---|---|
Ein Spiel wird verschoben und beide Tore sind null. War es ein Unentschieden? | Das Spiel wurde verschoben. Es gibt kein aufgezeichnetes Ergebnis. |
Eine erfolgreiche Suche liefert eine leere matches-Liste. Ist die ganze Saison leer? | In diesem Zeitraum wurden keine Spiele gefunden. Gib die Daten an, nach denen du gesucht hast. |
| Der Anbieter gibt 401 oder 403 zurück. | Die Abfrage ist fehlgeschlagen. Überprüfe das gespeicherte Token und die Abdeckung des Wettbewerbs. |
| Der Anbieter gibt 429 zurück. | Das Anfragelimit wurde erreicht. Versuche es später noch einmal. |
Ein leeres Fenster bedeutet trotzdem eine erfolgreiche Anfrage. Der Assistent kann vorschlagen, den Zeitraum zu erweitern.
Um eine zweite Meinung zu einer geänderten Anstoßzeit einzuholen, vergleiche sie mit den veröffentlichten Spielplanänderungen der Liga. Notiere dir das geplante Datum, die Zeitzone und das Datum deiner Abfrage zusammen. Der kostenlose Feed kann einer Übertragungsänderung hinterherhinken, was wichtig ist, wenn jemand seinen Samstag nach dieser Antwort plant.
Football data provided by the Football-Data.org API. Das Beispiel beruht auf den öffentlichen Native Stats-Seiten des Anbieters, Stand 18. November 2026. Welche Wettbewerbe abgedeckt sind und wie schnell neue Daten verfügbar sind, steht in der Übersicht der Tarife und Anfragelimits.
Häufig gestellte Fragen
Welche Fußball-API kann ich für einen Spielplan-Chatbot verwenden?
Die football-data.org v4 API liefert Spielpläne, Ergebnisse und Tabellenstände für abgedeckte Wettbewerbe. Verwende den Team-Matches-Endpunkt für den Spielplan und die aktuelle Form, und den Competition-Standings-Endpunkt für die Ligaposition.
Sind football-data.org-Ergebnisse im kostenlosen Plan live?
Der kostenlose Plan beinhaltet verzögerte Ergebnisse und Spielpläne, Ligatabellen für abgedeckte Wettbewerbe und 10 API-Aufrufe pro Minute. Gib die Quelle und das Datum bei jeder Antwort an und überprüfe deinen Plan, wenn du Live-Ergebnisse benötigst.
Wie ändere ich Arsenal zu einem anderen Team?
Finde die Team-ID und den Wettbewerb des Vereins in football-data.org. Ersetze Team 57 in beiden Match Actions, ändere den numerischen Wettbewerbsfilter und die Standings-URL, dann aktualisiere den Vereinsnamen und die Team-ID in den Anweisungen. Teste gegen ein Spiel, das du kennst.
Wie erhalte ich die letzten fünf Spiele aus Sicht des Teams?
Filtere nach beendeten Ligaspielen in einem bestimmten Datumsfenster, sortiere nach Anstoß von neuestem zu ältestem und nimm bis zu fünf. Überprüfe für jedes Ergebnis, ob dein Team zu Hause oder auswärts gespielt hat, bevor du einen Sieg, ein Unentschieden oder eine Niederlage zuweist. Wenn weniger als fünf qualifiziert sind, zeige an, wie viele du gefunden hast.
Was bedeutet ein leeres Ergebnis für ein verschobenes Spiel?
Ein leeres Ergebnis bedeutet, dass der Anbieter keine Gesamtzahl der Tore für diese Seite geliefert hat. Halte den Spielstatus sichtbar und lasse das Ergebnis unbekannt. Ein torloses Unentschieden benötigt ein beendetes Spiel mit zwei aufgezeichneten Nullen.
Wie konvertiere ich einen Fußball-Anstoß in meine Zeitzone?
Beginne mit dem UTC-Anstoß des Spiels, verwende eine benannte Zeitzone wie America/New_York und behalte das Datum in der Antwort bei. Sommerzeit und ein Wechsel des Kalendertages können beide die angezeigte Zeit beeinflussen.