Fikstürü, son maç sonuçlarını ve puan durumunu gösteren futbol botu yapın

Piotr Grudzień
Yayımlandı 8 dk okuma
Quickchat AI içindeki Arsenal'in üç satırlık maç günü özeti ve yanında Free aboneliği gösteren football-data.org Account Settings sayfası

Cumartesi gününüzü Arsenal’in Newcastle deplasmanına göre ayarlıyorsunuz. New York’taki bir arkadaşınız maçın başlama saatini soruyor. Sonra grup sohbetinden biri Arsenal’in son deplasman maçında ne yaptığını soruyor. İlk sorunun cevabı fikstür listesinde mevcut. İkincisi içinse “Liverpool 0, Arsenal 1” sonucundaki 1 golünü kimin attığını bilmeniz gerekir.

Sıradaki üç Premier Lig fikstürünü bulan, Arsenal’in son beş lig maçının sonucunu getiren ve takımların puan durumundaki yerini gösteren bir futbol sohbet robotu olan Matchday Notebook’u oluşturacaksınız. Örnek, 18 Kasım 2026 tarihine sabitlenmiştir. Newcastle deplasman maçı 21 Kasım Cumartesi, 17:30 UTC’de, yani New York saatiyle 12:30’te oynanacaktı.

Newcastle fikstürü Native Stats'da ve Quickchat AI'deki ilgili maç günü cevabı Sağlayıcının maç sayfası ile özel Agent, başlama saati konusunda aynı bilgiyi veriyor. Quickchat AI konuşması, aşağıda yeniden oluşturabileceğiniz, herkese açık kayıtların belirli bir tarihli tekrarına göre çalıştırıldı.

Newcastle fikstürünü kontrol edin veya Matchday Notebook kitini indirin. Arşivden çıkarın ve bir hesaba ihtiyaç duymadan üç fikstürü, beş maç sonucunu ve puan durumu satırını görmek için python3 replay.py komutunu çalıştırın. Aynı kit, kendi veri akışınızı bağlamak için Action ayarlarını ve Main Prompt’ü içerir.

1. Sohbet robotu hangi kulübü ve müsabakayı takip edecek?

Önce kulübü ve ligi sabitleyin. Arsenal’in ligdeki formu, Avrupa’da oynanan bir Salı gecesi maçını hesaba katıp katmamanıza göre değişebilir. Bu not defterinde Arsenal, 57 numaralı takım, lig ise 2021 numaralı Premier Lig anlamına gelir ve PL koduyla da bilinir.

  1. football-data.org kayıt formunu açın. Adınızı ve e-posta adresinizi girin, şartları kabul edin ve Create account seçeneğini belirleyin. Kapsam listesinden kendi liginizi kontrol edin. Ücretsiz plan, gecikmeli fikstür ve maç sonuçlarıyla birlikte Premier Lig’i içerir.

Ad ve e-posta alanları, Create account düğmesi ve Free Tier ayrıntılarını içeren football-data.org kayıt formu Kontrol edebileceğiniz bir e-posta adresi kullanın. football-data.org, kayıttan sonra API anahtarını bu adrese gönderir. Ücretsiz plan, dakikada 10 istek yapılmasına izin verir.

Zaten bir hesabınız varsa e-postanız ve API jetonunuz ile oturum açın. Jetonun başka bir kopyasına ihtiyacınız olursa kayıtlı olduğunuz adresi kullanarak e-posta ile talep edin. Jetonu 2. Adım’daki korumalı başlık için saklayın.

football-data.org Account Settings sayfası, Free aboneliği ve Available competitions listesinin bir bölümünü gösteriyor Planınızı Subscription altında kontrol edin ve kendi liginizi Available competitions altında arayın. Bu alıntı UEFA Şampiyonlar Ligi (CL) ve Bundesliga’yı (BL1) göstermektedir.

  1. Başka bir kulübü takip etmek için, o kulübü turnuvanın takımlar listesinden arayın, örneğin GET /v4/competitions/PL/teams. Aşağıdaki maç isteklerinde dönen takım kimliğini ve turnuva kimliğini kullanın. v4 hızlı başlangıç kılavuzunda her iki arama da mevcuttur.
  2. Bir Quickchat AI Agent oluşturun, adını Matchday Notebook koyun ve test ederken gizli tutun. Konuşmalar ve simülasyonlar için kullanılabilir kredilere ihtiyacınız var. Identity → AI Persona → Main Prompt’i açın ve aşağıdaki talimatları yapıştırın. Ekran görüntüleri ve kopyalanabilir ayarlar İngilizce’dir.

Arsenal'in Native Stats'daki kulüp sayfası ve Matchday Notebook'ın Quickchat AI'teki Identity ayarları Her iki yerde de aynı kulübü kullanın. Üründe, Agent’ın talimatları Identity altında bulunur.

Matchday Notebook Main Prompt'i kopyalayın
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. Sıradaki Arsenal fikstürünü nasıl alırsınız?

Grup sohbetindeki başlama saati sorusunu yanıtlayan Action ile başlayın. Tek bir istek her iki kulübü, planlanan zamanı ve maç durumunu döndürür. Bir ertelemenin de görüntülenebilmesi için durum filtresini burada açık bırakın. TIMED durumundaki bir kaydın başlama saati vardır. SCHEDULED için ise okuyucuya saatin henüz onaylanmadığını belirtin.

  1. Actions & MCPs → Add Action → API Action → Create manually yolunu izleyin. API Action Name alanını get_club_fixtures ve When to run alanını AI decides olarak ayarlayın. What to ask the user first altında, gerekli Text türündeki date_from ve date_to girdilerini, her ikisi de No default olacak şekilde ekleyin. Açıklamaları “Dahil edilecek ilk UTC tarihi, YYYY-MM-DD” ve “Hariç tutulacak ilk UTC tarihi, YYYY-MM-DD” şeklindedir.
  2. API Endpoint için GET’i seçin ve aşağıdaki URL’yi girin. Query Params’yi açın ve competitions’ü değişmez 2021 olarak ayarlayın. dateFrom ve dateTo’yı ekleyin. Her değer için, eşleşen tarih girişini eklemek için Add AI Data → Parameters’i kullanın. Body’u boş bırakın.
  3. Aşağıdaki açıklamayı API Action Description altına yapıştırın ve Eylemi kaydedin. Headers altında, kimlik bilgisi yalnızca yazılabilir bir X-Auth-Token satırına gidecektir. Bunu ilk isteğinizden önce ayarlayın. Anahtar olarak Accept ve değer olarak application/json ile ikinci, sıradan bir başlık ekleyin. Her üç Eylemde de aynı iki başlığı kullanın.
https://api.football-data.org/v4/teams/57/matches

football-data.org Team matches rotası ve 2021 müsabakası ile iki tarih için Query Params içeren Quickchat AI GET uç noktası Sağlayıcı referansından Eyleme giden takım maçları rotasını izleyin. Arsenal URL’de, lig Query Params içinde sabitlenmiştir ve iki tarih sohbetten gelir.

Fikstür Action açıklamasını kopyalayın
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.

Sağlayıcının istek örnekleri API anahtarını X-Auth-Token içine koyar. get_club_fixtures üzerindeki Headers bölümünde aynı başlık adını kullanın.

Herkese açık football-data.org Sign in formu, v4 X-Auth-Token örneği ve Quickchat AI içindeki Headers sekmesi Oturum açma formu, e-postanızı ve API jetonunuzu alır. Quickchat AI içinde yalnızca jeton, korumalı X-Auth-Token satırına girilir.

Jetonu gizli bir şekilde girin. Kontrol paneli, kayıtlı bir gizli anahtarın yerine geçebilir. Bu başlığı en baştan yalnızca yazılabilir yapmak için her bir Action için hesap bağlantısını bir kez kullanın. Hesabınızı ChatGPT veya Claude üzerinden Quickchat AI kurulum kılavuzunu kullanarak bağlayın. Bağlı asistandan aşağıdaki talimatla başlığı geçici bir işaretleyiciyle hazırlamasını isteyin. Ardından Action’ın Headers sekmesini kendiniz açın, o aynı satırdaki değeri ham football-data.org jetonunuzla değiştirin ve Save changes seçeneğini belirleyin. Düzenleyiciyi yeniden açıp [redacted] olarak görüntülendiğini kontrol edin. Jetonu kontrol panelinde tutun ve konuşmanın dışında bırakın.

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.

Fikstür Action'ındaki Headers, sansürlenmiş bir değerle X-Auth-Token'i gösteriyor Bu kaydedilmiş başlıktır. Sağlayıcı, jetonu tek başına, Bearer öneki olmadan bekler.

İlk okumayı deneyin. Test Response → Test the API bölümünde bir başlangıç tarihi ve istediğiniz son tarihten bir sonraki günü girin. Ardından Action’ı etkinleştirin ve AI Preview bölümünde bu tarih aralığındaki sonraki üç lig fikstürünü isteyin. Canlı bir deneme için gelecek tarihleri seçin. Arşivdeki örnekte 2026-11-18 ve 2026-12-03 kullanılmıştır, bu nedenle 2 Aralık akşamı da dahil edilmiştir. En yakın maçı kaynak bağlantısını açarak kontrol edin. v4 tarih filtresi referansında bitiş tarihinin neden hariç tutulduğu açıklanmaktadır.

Başlangıç tarihi olan 18 Kasım (dahil) ile bitiş tarihi olan 3 Aralık (hariç) arasındaki üç fikstür tarihi Veri tekrarında Newcastle deplasmanı 21 Kasım’a, Manchester City iç saha maçı 29 Kasım’a ve Brentford deplasmanı 2 Aralık’a denk geldi. İsteği 2 Aralık’ta bitirmek Brentford maçını kapsam dışı bırakırdı.

3. Arsenal’in son beş maç sonucunu nasıl okursunuz?

Bu örnekteki en aydınlatıcı maç Liverpool 0, Arsenal 1 sonucuyla bitti. Eğer sohbet robotu ilk sayıyı her zaman Arsenal’in skoru olarak ele alırsa bir deplasman galibiyetini mağlubiyete çevirir. Her skoru ev sahibi-deplasman sırasında tutun ve Arsenal’in ne yaptığını belirlemek için takım kimliğini kullanın.

  1. get_recent_results adında ikinci bir API Action oluşturun. Aynı GET uç noktasını, tarih girdilerini, tarih çiplerini ve turnuva filtresini kullanın. Değeri FINISHED olan status sorgu satırını ekleyin.
  2. Aşağıdaki açıklamayı ayarlayın. get_recent_results için yalnızca yazılabilir başlık kurulumunu tekrarlayın, maskeyi kontrol edin ve Action’ı etkinleştirin.
  3. Belirtilen bir tarih aralığındaki en son beş lig maçını isteyin. Örnek için 1 Ekim ile 17 Kasım 2026 arasını kullanın. Beş maçı almadan önce utcDate değerine göre sıralayın. Eğer tarih aralığı sadece üç maç döndürürse bu üçünü gösterin ve daha geriye bakmayı teklif edin.
Sonuçlar Action açıklamasını kopyalayın
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.

Kaynak maç sayfasında Liverpool 0, Arsenal 1, Arsenal deplasman skoru seçilmiş olarak Önce Arsenal’i deplasman takımı olarak bulun, ardından deplasman golünü okuyun. Liverpool’un sıfır golü, gol yemeden maçı tamamladığı anlamına gelir.

Sonuçları en yeniden eskiye doğru okuyun. Arsenal, Hull’u 1-0 yendi, Liverpool deplasmanında 1-0 kazandı, Everton’ı 2-0 yendi, Nottingham Forest deplasmanında 1-0 kazandı ve Leeds’i 2-1 yendi. Bu da beş galibiyet, atılan yedi gol ve yenilen bir gol demek. Liverpool maç kaydı iyi bir test örneğidir çünkü kazanan taraf ikinci sırada görünür.

Kaydedilmiş test verilerinde, gelen liste kasıtlı olarak Leeds maçıyla başlar ve Hull maçıyla biter. Başlama saatine göre sıralama yapmak Hull’u yanıtın en başına taşır. Sohbetin yanındaki Eylem yanıtını açın ve her iki listedeki ilk ve son maçları karşılaştırın.

Arsenal'in tamamlanmış beş maçı, ev ve deplasman skorlarıyla birlikte tarih sırasına göre gösteriliyor Beş galibiyet önemli bir detayı gizleyebilir. Bunlardan ikisi deplasmandaydı, bu yüzden kazanan sayı sağda.

4. Ligdeki sıralama ve puanlar nereden geliyor?

Beş galibiyet size son birkaç haftanın nasıl geçtiğini anlatır. Ligdeki sıralama aynı zamanda önceki tüm maçlara ve diğer takımların sonuçlarına da bağlıdır. Agent’a ayrı bir puan durumu Action’ı verin.

  1. Adını get_league_standings olarak belirleyin. GET yöntemini seçin, aşağıdaki uç noktayı yapıştırın ve girdileri, sorgu parametrelerini ve gövdeyi boş bırakın. AI decides seçeneğini kullanın, aşağıdaki açıklamayı ekleyin ve bu Action için yalnızca yazılabilir başlık kurulumunu tekrarlayın.
  2. Test Response bölümünde, standings içinde type değeri TOTAL olan girişi arayın. Bu girişin table alanı içinde team.id değeri 57’ya eşit olanı bulun. Action’ı etkinleştirin ve “Arsenal Premier Lig puan durumunda nerede?” diye sorun.
  3. position, playedGames ve points değerlerini aynı sezon ve tarihe ait kaynakla karşılaştırın. 18 Kasım’da Native Stats’teki Premier Lig puan durumu 1. sıra, 10 maç, 27 puan gösteriyordu. Diğer kulüpler maç yaptıkça mevcut puan durumu değişecektir.
https://api.football-data.org/v4/competitions/PL/standings
Puan durumu Eylemi açıklamasını kopyalayın
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.

Arsenal'in Premier Lig puan durumundaki birinci sıra satırı ve Matchday Notebook tarafından kullanılan alanlar TOTAL’da tek bir satırı okuyun. 27 puan, anlık görüntüdeki on lig maçının tamamını kapsar.

5. Maç günü brifingini kaynaklarına kadar takip edebilir misiniz?

Yeni bir AI Preview sohbeti başlatın. Sonraki üç fikstürü sorun, ardından “Son beş lig maçımızda ne yaptık?” diye devam edin, sonuçlar için tarih aralığını belirtin ve sonra “Bu sonuçlarla puan durumunda neredeyiz?” diye sorun. Inbox bölümünde her cevap için çağrılan Action işaretçisini açın. Action’ın View logs bölümü, parametreleri ve yanıtı taraftarın gördükleriyle karşılaştırmanıza olanak tanır. Bir API Action oluşturma rehberi bu kontrolleri nerede bulacağınızı gösterir.

Makalenin başında gösterilen birleşik maç günü özetini almak için aşağıdaki soruyu kaydedilmiş örnekteki tarihleri kullanarak sorun. Güncel bir özet için fikstürler için yaklaşan tarihleri ve sonuçlar için geçmiş tarihleri kullanın.

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

Quickchat AI'daki fikstür Eylemi çağrısı, isteği ve döndürülen maç kaydıyla birlikte Çağrıdaki tarihleri ve maç kimliğini inceleyin. Yerel veri tekrarında 560651, Newcastle fikstürüdür.

Tekrarlanabilir bir kontrol için Conversations → Testing’i açın, bir veri kümesi oluşturun ve üç soruyu kaydedin. Aşağıda gösterilen iki sınır sorusunu ekleyin. Bir Eylem açıklamasını değiştirdikten sonra veri kümesini çalıştırın ve çağrıları yanıtlarla birlikte inceleyin. Nadir bir durumu veya bir hatayı test etmek için kontrollü bir yanıt kullanın. Yalnızca varsayımsal bir soru, bir cevabın ifade şeklini test eder.

Fikstür, form, puan durumu ve sınır durum sorularını içeren Quickchat AI'deki Matchday Notebook veri kümesi Her düzenlemeden sonra aynı soruları kullanın. Deplasman sonucu, yalnızca evde yapılan bir testin kaçıracağı bir skor hatasını yakalar.

Test durumuTaraftarın duyması gereken yanıt
Bir maç ertelendi ve her iki gol de null. Berabere miydi?Fikstür ertelendi. Kayıtlı bir skor yok.
Başarılı bir arama boş bir matches listesi döndürüyor. Tüm sezon boş mu?Bu tarih aralığında herhangi bir maç bulunamadı. Aradığınız tarihleri belirtin.
Sağlayıcı 401 veya 403 döndürüyor.Arama başarısız oldu. Kayıtlı jetonu ve turnuva kapsamını kontrol edin.
Sağlayıcı 429 döndürüyor.İstek sınırı aşıldı. Bir süre sonra tekrar deneyin.

Quickchat AI'ın herhangi bir maç bulamayan başarılı isteğe verdiği boş yanıt Herhangi bir sonuç bulunamasa da istek başarılı olabilir. Asistan, tarih aralığını genişletmeyi önerebilir.

Değişen başlama saatiyle ilgili ikinci bir görüş almak için bunu ligin yayınlanan fikstür düzenlemeleriyle karşılaştırın. Maçın planlanan tarihini, saat dilimini ve bu bilgiyi kontrol ettiğiniz tarihi not edin. Ücretsiz veri akışı, yayıncıların yaptığı bir değişikliği gecikmeli yansıtabilir. Cumartesi gününü bu yanıta göre planlayan biri için bu durum önemlidir.

Football data provided by the Football-Data.org API. Bu eski örnekte, sağlayıcının herkese açık Native Stats sayfaları kullanılmaktadır. Güncel kapsam ve yenileme sıklığı hakkında bilgi için veri akışı planlarına ve istek sınırlarına göz atın.

Sıkça sorulan sorular

Fikstür sohbet robotu için hangi futbol API’sini kullanabilirim?

football-data.org v4 API’si, kapsanan turnuvalar için fikstür, maç sonuçları ve puan durumu sağlar. Fikstür ve son beş lig maçındaki form için takımın maçlar uç noktasını, ligdeki sıralama için ise turnuvanın puan durumu uç noktasını kullanın.

Ücretsiz planda football-data.org skorları canlı mı?

Ücretsiz plan, gecikmeli maç sonuçları ve fikstürler, kapsanan turnuvalar için puan durumları ve dakikada 10 API isteği içerir. Her yanıta kaynağı ve tarihi ekleyin, canlı maç sonuçlarına ihtiyacınız varsa planınızı kontrol edin.

Arsenal’i başka bir takıma nasıl değiştiririm?

Kulübün takım kimliğini ve turnuvasını football-data.org’da bulun. Her iki maç Action’ında 57 olan takım kimliğini değiştirin, sayısal turnuva filtresini ve puan durumu URL’sini değiştirin, ardından talimatlardaki kulüp adını ve takım kimliğini güncelleyin. Bildiğiniz bir fikstürle test edin.

Takımın oynadığı son beş maçı nasıl alabilirim?

Belirtilen bir tarih aralığında tamamlanmış lig maçlarını filtreleyin, başlama saatine göre en yeniden en eskiye doğru sıralayın ve en fazla beş maç alın. Her skor için, galibiyet, beraberlik veya mağlubiyet olarak belirlemeden önce takımınızın iç sahada mı yoksa deplasmanda mı oynadığını kontrol edin. Beşten az maç bulunursa kaç tane bulduğunuzu gösterin.

Ertelenen bir maç için boş skor ne anlama geliyor?

Boş bir skor, sağlayıcının o takım için bir gol sayısı sağlamadığı anlamına gelir. Maç durumunu görünür tutun ve skoru bilinmiyor olarak bırakın. Golsüz bir beraberlik için, tamamlanmış bir maçta iki takım için de sıfır gol kaydedilmiş olması gerekir.

Bir futbol maçının başlama saatini kendi saat dilimime nasıl dönüştürürüm?

Maçın UTC başlama saatini temel alın, America/New_York gibi adlandırılmış bir saat dilimi kullanın ve yanıtta tarihi koruyun. Yaz saati uygulaması ve takvim gününün değişmesi, görüntülenen saati etkileyebilir.

Quickchat AI Quickchat AI Ask Quickchat AI a question