아스널의 뉴캐슬 원정 경기에 맞춰 토요일 일정을 잡고 있습니다. 뉴욕에 있는 친구가 킥오프 시간을 물어봅니다. 그러자 그룹 채팅에서 누군가 아스널이 지난 원정 경기에서 어떻게 했는지 묻습니다. 첫 번째 답변은 경기 일정 목록에 있습니다. 두 번째 답변을 위해서는 “리버풀 0, 아스널 1”에서 1골이 누구의 골인지 알아야 합니다.
프리미어리그 다음 3경기 일정을 조회하고 아스널의 최근 리그 5경기 결과를 읽고 순위표에서 아스널의 순위를 찾는 축구 챗봇 Matchday Notebook을 만들어 봅니다. 이 예시는 2026년 11월 18일에 고정되어 있습니다. 뉴캐슬 원정 경기는 11월 21일 토요일 17:30 UTC, 즉 뉴욕 시간으로 오후 12:30에 예정되어 있었습니다.
공급자의 경기 페이지와 비공개 에이전트의 킥오프 시간이 일치합니다. Quickchat AI 대화는 날짜가 지정된 공개 기록의 데이터 리플레이를 기반으로 실행되었으며 아래에서 재현할 수 있습니다.
뉴캐슬 경기 일정 확인하기 또는 Matchday Notebook 키트 다운로드하기. 압축을 풀고 python3 replay.py을 실행하면 계정 없이도 3경기 일정, 5경기 결과, 순위표 행을 볼 수 있습니다. 동일한 키트에는 Action 설정과 자체 피드를 연결하기 위한 Main Prompt가 포함되어 있습니다.
1. 챗봇이 어떤 팀과 대회를 추적할까요?
먼저 클럽과 리그를 정하세요. 화요일 밤 유럽 대항전까지 포함하면 아스널의 최근 성적이 리그 경기만 집계했을 때와 달라집니다. 이 노트북에서 팀 ID 57은 아스널, 대회 ID 2021은 프리미어리그를 뜻합니다. 리그 코드는 PL입니다.
- football-data.org 등록 양식을 엽니다. 이름과 이메일 주소를 입력하고 약관에 동의한 후 Create account를 선택합니다. 커버리지 목록에서 리그를 확인하세요. 무료 플랜에는 경기 일정과 점수가 지연 제공되는 프리미어리그가 포함됩니다.
확인할 수 있는 이메일 주소를 사용하세요. football-data.org는 등록 후 해당 주소로 API 키를 보냅니다. 무료 플랜은 분당 10회의 요청을 허용합니다.
이미 계정이 있다면 이메일과 API 토큰으로 로그인하세요. 토큰 사본이 더 필요하면 등록한 주소를 사용하여 이메일로 요청하세요. 토큰은 2단계의 보호된 헤더에 사용되므로 잘 보관하세요.
Subscription에서 플랜을 확인하고 Available competitions에서 리그를 찾아보세요. 이 발췌문은 UEFA 챔피언스리그(CL)와 분데스리가(BL1)를 보여줍니다.
- 다른 팀을 추적하려면 예시(
GET /v4/competitions/PL/teams)와 같이 해당 대회의 팀 목록에서 찾아보세요. 반환된 팀 ID와 대회 ID를 아래 경기 요청에 사용하세요. v4 퀵스타트에 두 조회 방법이 모두 나와 있습니다. - Quickchat AI 에이전트를 생성하고 이름을 Matchday Notebook로 지정한 다음 테스트하는 동안 비공개로 유지하세요. 대화와 시뮬레이션을 위해 사용 가능한 크레딧이 필요합니다. Identity → AI Persona → Main Prompt를 열고 아래 안내를 붙여넣으세요. 스크린샷과 복사 가능한 설정은 영어를 사용합니다.
두 곳 모두에서 동일한 클럽을 유지하세요. 제품에서 에이전트의 지침은 Identity 아래에 있습니다.
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. 다음 아스널 경기 일정을 어떻게 가져오나요?
그룹 채팅의 킥오프 시간 질문에 답하는 Action으로 시작하세요. 한 번의 요청으로 양 팀, 예정된 시간, 경기 상태가 반환됩니다. 여기서는 연기된 경기도 표시될 수 있도록 상태 필터를 열어 두세요. TIMED 기록에는 킥오프 시간이 있습니다. SCHEDULED의 경우, 시간이 아직 확정되지 않았다고 사용자에게 알려주세요.
- Actions & MCPs → Add Action → API Action → Create manually을 엽니다. API Action Name를
get_club_fixtures로, When to run을 AI decides로 설정합니다. What to ask the user first 아래에 필수 Text 입력인date_from과date_to을 추가하고 둘 다 No default로 설정합니다. 각 설명은 ‘포함할 시작 UTC 날짜, YYYY-MM-DD’와 ‘제외할 시작 UTC 날짜, YYYY-MM-DD’입니다. - API Endpoint에 대해 GET을 선택하고 아래 URL을 입력합니다. Query Params를 열고
competitions을 리터럴2021로 설정합니다.dateFrom와dateTo을 추가합니다. 각 값에 대해 Add AI Data → Parameters을 사용하여 일치하는 날짜 입력을 삽입합니다. Body는 비워 둡니다. - 아래 설명을 API Action Description에 붙여넣고 Action을 저장하세요. Headers에서 자격 증명은 쓰기 전용
X-Auth-Token행에 들어갑니다. 첫 번째 요청 전에 설정하세요.Accept을 키로,application/json를 값으로 하는 두 번째 일반 헤더를 추가하세요. 세 가지 Action 모두에 동일한 두 헤더를 사용하세요.
https://api.football-data.org/v4/teams/57/matches
제공업체 참조에서 팀 경기 경로를 따라 액션으로 이동합니다. 아스널은 URL에 고정되어 있고 리그는 Query Params에 있으며 두 날짜는 대화에서 가져옵니다.
경기 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.
제공업체의 요청 예시에서는 API 키를 X-Auth-Token에 넣습니다. get_club_fixtures의 Headers에서 동일한 헤더 이름을 사용하세요.
로그인 양식에는 이메일과 API 토큰을 입력합니다. Quickchat AI에서는 보호된 X-Auth-Token 행에 토큰만 들어갑니다.
토큰을 비공개로 입력하세요. 대시보드는 저장된 보안 비밀을 대체할 수 있습니다. 헤더를 처음부터 쓰기 전용으로 만들려면 Action당 한 번씩 계정 연결을 사용하세요. ChatGPT 또는 Claude의 Quickchat AI 설정 가이드를 사용하여 계정을 연결하세요. 연결된 어시스턴트에게 아래 지침에 따라 임시 표시(마커)로 헤더를 준비하도록 요청하세요. 그런 다음 Action의 Headers 탭을 직접 열고 같은 행의 값을 football-data.org 토큰 원본으로 교체한 후 Save changes을 선택하세요. 편집기를 다시 열어 [redacted]가 표시되는지 확인하세요. 토큰은 대화에 입력하지 말고 대시보드에만 보관하세요.
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.
저장된 헤더입니다. 공급자는 Bearer 접두사 없이 토큰 자체를 예상합니다.
첫 읽기를 시도해 보세요. Test Response → Test the API에서 시작일과 조회 종료일 바로 다음 날짜를 입력하세요. 그런 다음 Action을 활성화하고 AI Preview에서 해당 기간의 다음 리그 경기 3개를 요청하세요. 실시간으로 빌드하는 경우, 다가오는 날짜를 선택하세요. 보관된 예시에서는 2026-11-18과 2026-12-03를 사용했으므로 12월 2일 저녁 경기가 포함되었습니다. 소스 링크를 열어 가장 가까운 경기를 확인하세요. v4 날짜 필터 참조는 종료일이 제외되는 규칙을 설명합니다.
데이터 리플레이에서 뉴캐슬 원정 경기는 11월 21일, 맨체스터 시티 홈 경기는 11월 29일, 브렌트퍼드 원정 경기는 12월 2일에 열렸습니다. 요청 종료일을 12월 2일로 설정했다면 브렌트퍼드 경기는 제외되었을 것입니다.
3. 아스널의 최근 5경기 결과를 어떻게 조회하나요?
이 예시에서 가장 확실한 경기는 리버풀 0, 아스널 1로 끝났습니다. 챗봇이 항상 첫 번째 숫자를 아스널의 득점으로 처리한다면 원정 승리가 패배로 바뀔 수 있습니다. 모든 점수를 홈-원정 순서로 유지하고 팀 ID를 사용하여 아스널의 경기 결과를 판단하세요.
- 이름이
get_recent_results인 두 번째 API Action을 만드세요. 동일한 GET 엔드포인트, 날짜 입력, 날짜 칩, 대회 필터를 사용하세요. 리터럴 값FINISHED를 사용하는 쿼리 행status을 추가하세요. - 아래 설명을 설정하세요.
get_recent_results에 대한 쓰기 전용 헤더 설정을 반복하고, 마스크를 확인하고 Action을 활성화하세요. - 지정된 기간 내의 가장 최근 리그 5경기를 요청하세요. 예시에서는 2026년 10월 1일부터 11월 17일까지를 사용하세요. 5경기를 가져오기 전에
utcDate을 기준으로 정렬하세요. 해당 기간에 경기가 3개만 반환되면 그 3개를 보여주고 더 이전 기록을 찾아보겠냐고 제안하세요.
경기 결과 Action 설명 복사
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.
먼저 원정 팀에서 아스널을 찾은 다음 원정 득점을 읽으세요. 리버풀의 0점은 무실점(클린 시트)을 의미합니다.
최신순으로 경기 결과를 읽어보세요. 아스널은 헐 시티에 1-0 승, 리버풀 원정 1-0 승, 에버턴에 2-0 승, 노팅엄 포레스트 원정 1-0 승, 리즈에 2-1 승리를 거두었습니다. 이로써 5승, 7득점 1실점을 기록했습니다. 리버풀 경기 기록은 승리 팀이 두 번째로 표시되므로 좋은 테스트 자료가 됩니다.
저장된 테스트 데이터에서 반환된 목록은 의도적으로 리즈 경기로 시작하여 헐 경기로 끝납니다. 킥오프 타임스탬프를 기준으로 정렬하면 헐 경기가 응답의 맨 위로 이동합니다. 채팅 옆의 Action 응답을 열고 두 목록의 첫 경기와 마지막 경기를 비교해 보세요.
5승이라는 결과만 보면 중요한 세부 정보를 놓칠 수 있습니다. 이 중 두 경기는 원정 경기였으므로 승리팀의 득점은 오른쪽에 표시됩니다.
4. 리그 순위와 승점은 어디서 가져오나요?
5연승은 최근 몇 주간의 성적을 보여줍니다. 리그 순위는 이전의 모든 경기와 다른 모든 팀의 결과에도 영향을 받습니다. 에이전트에 별도의 순위표 조회 Action을 부여하세요.
- 이름을
get_league_standings으로 지정합니다. GET을 선택하고 아래 엔드포인트를 붙여넣은 다음 입력, 쿼리 매개변수 및 본문을 비워 둡니다. AI decides를 사용하고 아래 설명을 추가한 다음 이 Action에 대해 쓰기 전용 헤더 설정을 반복합니다. - Test Response에서
standings목록 중type가TOTAL인 항목을 찾으세요. 그 항목의table안에서team.id가57인 것을 찾으세요. Action을 활성화하고 “프리미어리그 순위표에서 아스널은 몇 위인가요?”라고 질문하세요. - 같은 시즌, 같은 날짜의 원본 데이터와
position,playedGames,points를 비교해 보세요. 11월 18일 기준 Native Stats의 프리미어리그 순위표는 1위, 10경기, 27승점을 보여주었습니다. 현재 순위표는 다른 구단들의 경기 결과에 따라 계속 변동됩니다.
https://api.football-data.org/v4/competitions/PL/standings
순위표 Action 설명 복사
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.
TOTAL 순위표의 한 행을 가로질러 읽으세요. 27승점은 이 스냅샷 시점까지의 리그 10경기를 모두 포함합니다.
5. 경기 당일 브리핑 내용을 소스 데이터까지 추적할 수 있나요?
새 AI Preview 대화를 시작하세요. 다음 경기 일정 3개를 요청하고, 이어서 “최근 리그 5경기 성적이 어땠어?”라고 물어본 후 결과 조회 기간을 알려주고, “그래서 지금 리그 순위가 어떻게 돼?”라고 질문하세요. Inbox에서 각 답변에 대해 호출된 Action 표시를 여세요. Action의 View logs를 통해 서포터가 본 내용과 파라미터 및 응답을 비교할 수 있습니다. API Action 구축 가이드에서 이러한 제어 기능을 어디서 찾을 수 있는지 보여줍니다.
글의 서두에 나온 경기 요약 정보를 얻으려면 저장된 예시의 날짜를 사용하여 아래 질문을 하세요. 최신 요약 정보를 원한다면 경기 일정에는 미래 날짜를, 경기 결과에는 최근 날짜를 사용하세요.
Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.
호출된 내용에서 날짜와 경기 ID를 확인하세요. 로컬 리플레이에서 560651은 뉴캐슬과의 경기 일정입니다.
반복 가능한 확인을 위해 Conversations → Testing을 열고, 데이터셋을 생성하고 세 가지 질문을 저장합니다. 아래에 표시된 두 가지 경계 질문을 추가합니다. Action 설명을 변경한 후 데이터셋을 실행하고 응답과 함께 호출을 검사합니다. 통제된 응답을 사용하여 드문 상태 또는 오류를 연습합니다. 가상의 질문만으로 답변의 문구를 테스트합니다.
수정할 때마다 동일한 질문을 사용하세요. 원정 경기 결과는 모든 테스트를 홈 경기로만 진행했을 때 놓칠 수 있는 득점 기록 오류를 발견하게 해줍니다.
| 테스트 사례 | 서포터가 들어야 할 답변 |
|---|---|
경기가 연기되고 두 골 모두 null입니다. 무승부였나요? | 경기가 연기되었습니다. 기록된 점수가 없습니다. |
성공적인 검색 결과 matches 목록이 비어 있습니다. 시즌 전체가 비어 있나요? | 해당 기간에 반환된 경기가 없습니다. 검색한 날짜를 알려주세요. |
| 제공자가 401 또는 403을 반환합니다. | 조회에 실패했습니다. 저장된 토큰과 대회의 지원 범위를 확인하세요. |
| 제공자가 429를 반환합니다. | 요청 한도에 도달했습니다. 중지하고 나중에 다시 시도하세요. |
창이 비어 있어도 요청은 성공한 것입니다. 어시스턴트가 날짜 범위를 넓히도록 제안할 수 있습니다.
변경된 킥오프 시간에 대한 재확인이 필요하다면 리그의 공개된 경기 일정 변경 내용과 비교해 보세요. 예정된 날짜, 시간대, 조회한 날짜를 함께 기록해 두는 것이 좋습니다. 무료 데이터 피드는 방송사의 일정 변경보다 늦게 반영될 수 있는데, 답변을 바탕으로 주말 계획을 세우는 사용자에게는 중요한 문제입니다.
Football data provided by the Football-Data.org API. 이 예시의 날짜는 제공자의 공개 Native Stats 페이지를 기준으로 합니다. 최신 데이터 범위와 갱신 주기는 피드 플랜 및 분당 요청 횟수 제한을 참조하세요.
자주 묻는 질문
경기 일정 챗봇에 어떤 축구 API를 사용할 수 있나요?
football-data.org v4 API는 지원 대상 대회의 경기 일정, 결과, 순위표를 제공합니다. 경기 일정과 최근 성적은 팀의 경기 엔드포인트를 사용하고 리그 순위는 대회의 순위표 엔드포인트를 사용하세요.
무료 플랜에서 football-data.org 점수가 실시간으로 제공되나요?
무료 플랜에는 지연된 점수 및 경기 일정, 지원 대상 대회의 리그 순위표, 분당 10회의 API 호출이 포함됩니다. 각 답변에 출처와 날짜를 포함하고 실시간 점수가 필요한 경우 플랜을 확인하세요.
아스널을 다른 팀으로 변경하려면 어떻게 해야 하나요?
football-data.org에서 해당 팀의 ID와 대회 정보를 찾으세요. 두 경기 Action 모두에서 팀 57을 교체하고 숫자 대회 필터와 순위표 URL을 변경한 다음 안내에 따라 팀 이름과 팀 ID를 업데이트하세요. 직접 아는 경기 일정으로 테스트해 보세요.
팀 관점에서 최근 5경기를 어떻게 가져오나요?
지정된 날짜 범위 내에서 종료된 리그 경기를 필터링하고 킥오프 시간을 최신순으로 정렬하여 최대 5개를 가져옵니다. 각 득점에 대해 팀이 홈 경기였는지 원정 경기였는지 확인한 후 승, 무, 패를 할당합니다. 5경기 미만인 경우 찾은 경기 수를 표시하세요.
연기된 경기의 빈 점수는 무엇을 의미하나요?
점수가 비어 있다는 것은 공급자가 해당 팀의 총득점을 제공하지 않았음을 의미합니다. 경기 상태는 계속 표시하고 점수는 알 수 없음으로 두세요. 무득점 무승부는 종료된 경기에서 양 팀 모두 0점으로 기록되어야 합니다.
축구 킥오프 시간을 내 시간대로 변환하려면 어떻게 해야 하나요?
경기의 UTC 킥오프 시간으로 시작하여 America/New_York과 같은 명명된 시간대를 사용하고 답변에 날짜를 포함하세요. 일광 절약 시간과 날짜 변경 모두 표시되는 시간에 영향을 줄 수 있습니다.