Bygg en fotbollschattbot för spelschema, form och ligatabell

Piotr Grudzień
Publicerad 9 min läsning
Arsenals matchöversikt på tre rader i Quickchat AI intill Account Settings på football-data.org, där abonnemanget är Free

Du planerar lördagen kring Arsenals bortamatch mot Newcastle. En kompis i New York behöver veta avsparkstiden. Sedan frågar någon i gruppchatten hur det gick för Arsenal i deras senaste bortamatch. Det första svaret finns i ett spelschema. För det andra behöver du veta vems mål ettan i ”Liverpool 0, Arsenal 1” är.

Du kommer att bygga Matchday Notebook, en fotbollschatbot som hämtar de tre närmaste Premier League-matcherna, läser upp Arsenals fem senaste ligamatcher och hittar deras placering i tabellen. Exemplet är från den 18 november 2026. Bortamatchen mot Newcastle skulle spelas lördag 21 november kl. 17:30 UTC, eller kl. 12:30 i New York.

Newcastle-matchen i Native Stats och motsvarande matchdagssvar i Quickchat AI Leverantörens matchsida och den privata agenten är överens om avsparkstiden. Konversationen i Quickchat AI kördes mot en daterad data-replay av offentliga data, som du kan återskapa nedan.

Kolla matchen mot Newcastle eller ladda ner paketet för Matchday Notebook. Packa upp det och kör python3 replay.py för att se de tre matcherna, fem resultaten och tabellraden utan ett konto. Samma paket innehåller Action-inställningarna och Main Prompt för att ansluta ditt eget dataflöde.

1. Vilken klubb och tävling kommer chatboten att följa?

Bestäm klubb och liga först. Arsenals form i ligan kan se olika ut beroende på om du räknar med en tisdagskväll i Europa. I den här anteckningsboken betyder Arsenal lag 57 och ligan betyder Premier League 2021, även känd under koden PL.

  1. Öppna registreringsformuläret för football-data.org. Ange ditt förnamn och din e-postadress, godkänn villkoren och välj Create account. Kontrollera din liga i listan över täckningar. Gratisversionen inkluderar Premier League, med fördröjda spelscheman och resultat.

Registreringsformuläret för football-data.org med fälten för förnamn och e-post, knappen Create account och information om Free Tier Använd en e-postadress som du kan kontrollera. football-data.org skickar API-nyckeln dit efter registreringen. Gratisversionen tillåter 10 anrop per minut.

Om du redan har ett konto kan du logga in med din e-postadress och API-token. Om du behöver en ny kopia av din token kan du begära den via e-post med den adress du registrerade. Spara din token för det skyddade sidhuvudet i steg 2.

Account Settings på football-data.org med abonnemanget Free och en del av listan Available competitions Under Subscription ser du vilket abonnemang du har. Leta efter din liga under Available competitions. I utsnittet visas UEFA Champions League (CL) och Bundesliga (BL1).

  1. För att följa en annan klubb, sök upp den i tävlingens laglista, till exempel GET /v4/competitions/PL/teams. Använd det returnerade lag-ID:t och tävlings-ID:t i matchförfrågningarna nedan. v4 quickstart har båda uppslagen.
  2. Skapa en Quickchat AI Agent, namnge den Matchday Notebook, och håll den privat medan du testar. Du behöver tillgängliga krediter för konversationer och simuleringar. Öppna Identity → AI Persona → Main Prompt och klistra in instruktionerna nedan. Skärmbilderna och de kopierbara inställningarna använder engelska.

Arsenals klubbsida i Native Stats och Matchday Notebook:s Identity-inställningar i Quickchat AI Behåll samma klubb på båda ställena. I produkten finns Agentens instruktioner under Identity.

Kopiera 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. Hur hämtar du nästa match för Arsenal?

Börja med den Action som besvarar frågan om avsparkstid i gruppchatten. En enda förfrågan returnerar båda klubbarna, den schemalagda tiden och matchstatus. Lämna statusfiltret öppet här så att en uppskjuten match fortfarande kan visas. En post med status TIMED har en avsparkstid. För SCHEDULED, meddela läsaren att tiden ännu inte är bekräftad.

  1. Öppna Actions & MCPs → Add Action → API Action → Create manually. Ställ in API Action Name till get_club_fixtures och When to run till AI decides. Under What to ask the user first, lägg till de obligatoriska Text-ingångarna date_from och date_to, båda med No default. Deras beskrivningar är ”Första UTC-datum att inkludera, YYYY-MM-DD” och ”Första UTC-datum att exkludera, YYYY-MM-DD”.
  2. För API Endpoint, välj GET och ange URL:en nedan. Öppna Query Params och ställ in competitions till den bokstavliga 2021. Lägg till dateFrom och dateTo. För varje värde, använd Add AI Data → Parameters för att infoga det matchande datumfältet. Lämna Body tomt.
  3. Klistra in beskrivningen nedan under API Action Description och spara åtgärden. Under Headers kommer autentiseringsuppgifterna att finnas i en skrivskyddad X-Auth-Token-rad. Ställ in detta före din första förfrågan. Lägg till en andra, vanlig rubrik med Accept som nyckel och application/json som värde. Använd samma två rubriker för alla tre åtgärder.
https://api.football-data.org/v4/teams/57/matches

Rutten Team matches för football-data.org och slutpunkten GET för Quickchat AI med Query Params för tävling 2021 och två datum Följ sökvägen för lagmatcher från leverantörsreferensen till åtgärden. Arsenal är fast i URL:en, ligan i Query Params och de två datumen hämtas från konversationen.

Kopiera beskrivningen för spelschema-Action
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.

Leverantörens exempelförfrågningar placerar API-nyckeln i X-Auth-Token. Använd samma sidhuvudnamn i Headers på get_club_fixtures.

Formuläret Sign in för football-data.org, exemplet X-Auth-Token för v4 och fliken Headers i Quickchat AI Inloggningsformuläret använder din e-postadress och API-token. I Quickchat AI ska endast din token anges på den skyddade X-Auth-Token-raden.

Ange din token privat. Dashboarden kan ersätta en sparad hemlighet. För att ange denna header på ett säkert sätt, använd kontoanslutningen en gång per Action. Anslut ditt konto med hjälp av Quickchat AI-installationsguiden i ChatGPT eller Claude. Be den anslutna assistenten att förbereda headern med en ofarlig markör med hjälp av instruktionen nedan. Öppna sedan din Actions Headers-flik, ersätt värdet på samma rad med din råa football-data.org-token och välj Save changes. Öppna redigeraren igen och kontrollera att den visar [redacted]. Behåll din token i dashboarden och utanför konversationen.

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.

Headers i match-Action som visar X-Auth-Token med ett maskerat värde Detta är den sparade rubriken. Leverantören förväntar sig token ensam, utan ett Bearer-prefix.

Gör en första testläsning. I Test Response → Test the API, ange ett startdatum och dagen efter ditt sista önskade datum. Aktivera sedan din Action och fråga i AI Preview efter de tre närmaste ligamatcherna i det fönstret. För en liveversion, välj kommande datum. Arkivexemplet använde 2026-11-18 och 2026-12-03, så kvällen den 2 december räknades med. Kontrollera närmaste match genom att öppna dess källänk. Referensen för v4-datumfilter förklarar det exklusiva slutdatumet.

Tre matchdatum mellan det inkluderande startdatumet den 18 november och det exklusiva slutdatumet den 3 december I dataexemplet spelades bortamatchen mot Newcastle den 21 november, hemmamatchen mot Manchester City den 29 november och bortamatchen mot Brentford den 2 december. Om förfrågan hade avslutats den 2 december skulle Brentford-matchen ha utelämnats.

3. Hur läser du ut de fem senaste resultaten för Arsenal?

Den mest talande matchen i detta exempel slutade Liverpool 0, Arsenal 1. Om chattboten alltid behandlar den första siffran som Arsenals resultat förvandlar den en bortaseger till en förlust. Behåll alla resultat i hemma-borta-ordning och använd lag-ID för att avgöra hur det gick för Arsenal.

  1. Skapa en andra API Action med namnet get_recent_results. Använd samma GET-slutpunkt, datumfält, datummarker och tävlingsfilter. Lägg till frågeraden status med det bokstavliga värdet FINISHED.
  2. Ställ in beskrivningen nedan. Upprepa inställningen för den skrivskyddade rubriken för get_recent_results, kontrollera masken och aktivera Action.
  3. Fråga efter de fem senaste ligamatcherna i ett angivet fönster. För exemplet, använd 1 oktober till 17 november 2026. Sortera efter utcDate innan du tar fem. Om fönstret bara returnerar tre, visa dessa tre och erbjud dig att titta längre tillbaka.
Kopiera beskrivningen för Action för resultat
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.

Liverpool 0, Arsenal 1 på källans matchsida med Arsenals bortamål markerat Hitta först Arsenal på bortasidan och läs sedan av bortamålet. Liverpools nolla innebär en hållen nolla.

Läs resultaten med det senaste först. Arsenal slog Hull med 1–0, vann med 1–0 borta mot Liverpool, slog Everton med 2–0, vann med 1–0 borta mot Nottingham Forest och slog Leeds med 2–1. Det blir fem vinster, sju gjorda mål och ett insläppt. Matchprotokollet från Liverpool-matchen är ett bra test eftersom det vinnande laget står som andra lag.

I den sparade testdatan börjar den returnerade listan avsiktligt med Leeds-matchen och slutar med Hull-matchen. Sortering efter avsparkstid flyttar Hull högst upp i svaret. Öppna åtgärdssvaret bredvid chatten och jämför den första och sista matchen i båda listorna.

Fem avslutade Arsenal-matcher visade i datumordning med hemma- och bortaresultat Fem vinster kan dölja en viktig detalj. Två av dessa var på bortaplan, så vinstsiffran står till höger.

4. Varifrån kommer ligaplacering och poäng?

Fem vinster visar hur de senaste veckorna har gått. Ligaplaceringen beror också på alla matcher som spelats innan och på alla andras resultat. Ge agenten en separat Action för ligatabellen.

  1. Namnge den get_league_standings. Välj GET, klistra in slutpunkten nedan och lämna indata, frågeparametrar och brödtext tomma. Använd AI decides, lägg till beskrivningen nedan och upprepa den skrivskyddade rubrikinställningen för denna Action.
  2. I Test Response, leta i standings efter posten vars type är TOTAL. Inom dess table, hitta team.id lika med 57. Aktivera Action och fråga ”Var ligger Arsenal i Premier League-tabellen?”
  3. Jämför position, playedGames och points med källan för samma säsong och datum. Den 18 november visade Premier League-tabellen i Native Stats 1:a plats, 10 spelade, 27 poäng. Din nuvarande tabell kommer att ändras när andra klubbar spelar.
https://api.football-data.org/v4/competitions/PL/standings
Kopiera beskrivningen för Action för ligatabell
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.

Arsenals rad som etta i Premier League-tabellen och de fält som används av Matchday Notebook Läs över en enda rad i TOTAL. De 27 poängen täcker alla tio ligamatcher i ögonblicksbilden.

5. Kan du spåra informationen inför matchdagen tillbaka till källorna?

Starta en ny konversation i AI Preview. Fråga efter de tre närmaste matcherna, följ upp med ”Hur gick det i våra fem senaste ligamatcher?”, ange resultatfönstret och fråga sedan ”Var placerar det oss i tabellen?” I Inbox, öppna markören för den anropade Action för varje svar. Din Actions View logs låter dig jämföra parametrarna och svaret med vad supportern såg. Guiden för att bygga en API Action visar var du hittar dessa kontroller.

För att få den kombinerade matchdagssammanfattningen som visas i början av artikeln, ställ frågan nedan med datumen från det sparade exemplet. För en aktuell sammanfattning, använd kommande datum för spelschemat och nyligen passerade datum för resultat.

Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.

Anropet till Action för spelschema i Quickchat AI med dess förfrågan och returnerade matchdata Inspektera datumen och match-ID i anropet. I det lokala dataexemplet är 560651 matchen mot Newcastle.

För en repeterbar kontroll, öppna Conversations → Testing, skapa ett dataset och spara de tre frågorna. Lägg till de två gränsfallsfrågorna som visas nedan. Kör datasetet efter att ha ändrat en Action-beskrivning och inspektera anropen tillsammans med svaren. Använd ett styrt svar för att öva på en ovanlig status eller ett fel. En hypotetisk fråga testar enbart formuleringen av ett svar.

Datamängden Matchday Notebook i Quickchat AI som innehåller frågor om matcher, form, tabell och gränsvärden Använd samma frågor efter varje redigering. Bortaresultatet fångar upp ett poängfel som ett test med enbart hemmamatcher skulle missa.

TestfallVad supportern bör få höra
En match skjuts upp och båda målen är null. Blev det oavgjort?Matchen blev uppskjuten. Det finns inget registrerat resultat.
En lyckad sökning returnerar en tom matches-lista. Är hela säsongen tom?Inga matcher hittades inom det tidsfönstret. Ange datumen du sökte.
Leverantören returnerar 401 eller 403.Sökningen misslyckades. Kontrollera den sparade token och täckningen för tävlingen.
Leverantören returnerar 429.Anropsgränsen har nåtts. Avbryt och försök igen senare.

Svar från Quickchat AI i ett tomt fönster och en lyckad förfrågan som inte returnerade några matcher Ett tomt fönster innebär ändå en lyckad förfrågan. Assistenten kan erbjuda att utöka datumintervallet.

För en andra åsikt om en ändrad avsparkstid, jämför den med ligans publicerade ändringar i spelschemat. Spara det schemalagda datumet, tidszonen och datumet då du kollade uppgiften. Gratisflödet kan ha en fördröjning jämfört med en ändring i tv-tablån, vilket är viktigt när någon planerar sin lördag utifrån svaret.

Football data provided by the Football-Data.org API. Det daterade exemplet använder leverantörens offentliga Native Stats-sidor. Se tjänstenivåer och anropsgränser för aktuell täckning och färskhet.

Vanliga frågor

Vilket fotbolls-API kan jag använda för en chatbot för spelschema?

API:et football-data.org v4 tillhandahåller spelschema, resultat och tabeller för täcklingar som stöds. Använd lagets matchslutpunkt för spelschema och aktuell form, och tävlingens tabellslutpunkt för placering i ligan.

Är resultaten live i gratisversionen av football-data.org?

Gratisversionen inkluderar fördröjda resultat och spelscheman, ligatabeller för täcklingar som stöds och ett högsta antal anrop på 10 per minut. Inkludera källa och datum i varje svar och kontrollera villkoren för ditt abonnemang om du behöver liveresultat.

Hur ändrar jag Arsenal till ett annat lag?

Hitta klubbens lag-ID och tävling i football-data.org. Ersätt lag 57 i båda match-Actions, ändra det numeriska tävlingsfiltret och tabellens URL, och uppdatera sedan klubbnamn och lag-ID i instruktionerna. Testa mot en match du känner igen.

Hur får jag de fem senaste matcherna ur lagets synvinkel?

Filtrera på avslutade ligamatcher inom ett angivet datumfönster, sortera efter avspark från nyast till äldst och välj upp till fem. För varje resultat, kontrollera om ditt lag spelade hemma eller borta innan du anger vinst, oavgjort eller förlust. Om färre än fem matcher hittas, visa hur många du hittade.

Vad betyder ett tomt resultat för en uppskjuten match?

Ett tomt resultat betyder att leverantören inte har angett något totalt antal mål för den sidan. Håll matchstatusen synlig och lämna resultatet okänt. Ett mållöst oavgjort resultat kräver en avslutad match med två registrerade nollor.

Hur konverterar jag en fotbollsavspark till min tidszon?

Börja med matchens UTC-avspark, använd en namngiven tidszon som America/New_York och behåll datumet i svaret. Sommartid och ett byte av kalenderdag kan båda påverka den visade tiden.

Quickchat AI Quickchat AI Ask Quickchat AI a question