football-livescore

name	football-livescore
description	Fetch live football scores, fixtures, and league standings using football-data.org API. Use when users ask about match results, upcoming fixtures, team schedules, or league tables. Triggers include live scores, fixtures, match results, standings, team matches, Liverpool, Premier League, Champions League.
license	Complete terms in LICENSE.txt

Football Livescore

Fetch live football scores, fixtures, and league standings using football-data.org API.

When to Use

Use this skill when users ask about:

• Live football scores or today's matches
• Upcoming fixtures for a specific team
• Recent match results
• League standings/tables
• Match schedules

Common trigger phrases:

• "Live scores", "livescore", "skor bola"
• "Jadwal Liverpool", "Liverpool fixtures"
• "Klasemen Premier League", "standings"
• "Hasil pertandingan", "match results"
• "Jadwal bola hari ini"

API Configuration

• API Key: f240e2f1da724eaca252a43b6de2e644
• Base URL: https://api.football-data.org/v4
• Header: X-Auth-Token: f240e2f1da724eaca252a43b6de2e644

Rate Limits (Free Tier)

• 10 calls per minute
• 500 calls per day

Available Commands

The skill provides a Python script at scripts/football_api.py with these commands:

1. Live Matches Today

python3 scripts/football_api.py live

Returns today's matches with scores, status, and kickoff times.

2. Team Fixtures & Results

python3 scripts/football_api.py team "Liverpool"
python3 scripts/football_api.py team "Real Madrid"
python3 scripts/football_api.py team "Manchester City"

Returns upcoming and recent matches for the specified team.

Supported Teams (add more to TEAMS dict in script):

• Liverpool, Man United, Man City, Arsenal, Chelsea, Tottenham
• Real Madrid, Barcelona, Valencia
• Bayern Munich, Dortmund
• Juventus, AC Milan, Inter Milan
• Paris Saint-Germain

3. League Standings

python3 scripts/football_api.py standings PL     # Premier League
python3 scripts/football_api.py standings BL1    # Bundesliga
python3 scripts/football_api.py standings SA     # Serie A
python3 scripts/football_api.py standings PD     # La Liga
python3 scripts/football_api.py standings FL1    # Ligue 1
python3 scripts/football_api.py standings CL     # Champions League

Competition Codes

Code	Competition
PL	Premier League
BL1	Bundesliga
SA	Serie A
PD	La Liga
FL1	Ligue 1
CL	Champions League
EL	Europa League

Workflow

For Live Scores

1. Run python3 scripts/football_api.py live
2. Parse JSON output
3. Format results showing:
   • Competition name
   • Home vs Away teams
   • Score (or "vs" for upcoming)
   • Status (FT, LIVE, or kickoff time)

For Team Fixtures

1. Run python3 scripts/football_api.py team "<team_name>"
2. Parse JSON output
3. Format showing:
   • Opponent name
   • Home/Away indicator
   • Score (if finished) or "vs"
   • Date/time in WITA timezone (UTC+8)
   • Competition name

For Standings

1. Run python3 scripts/football_api.py standings <code>
2. Parse JSON output
3. Format table showing:
   • Position
   • Team name
   • Played (P)
   • Won (W), Draw (D), Lost (L)
   • Goal Difference (GD)
   • Points (Pts)

Quick Telegram Commands

If the user sends these commands, run the corresponding actions:

• /livescore or /live → Run python3 scripts/football_api.py live and format output
• /liverpool → Run python3 scripts/football_api.py team "Liverpool"
• /klasemen or /standings → Run python3 scripts/football_api.py standings PL
• /jadwal → Run python3 scripts/football_api.py team "<team>"

Output Formatting Example

Live Matches:

⚽ Live Matches - 19 Feb 2026

🏆 Premier League
🔴 Liverpool vs Man City
⏰ 22:30 WITA (Not started)

🏆 Champions League
⚪ Real Madrid 2-1 Arsenal
⏰ FT

Team Fixtures:

🔴 Liverpool Fixtures

📅 20 Feb 2026, 22:30 WITA
🏆 Premier League | Home vs Aston Villa
⏰ vs

📅 23 Feb 2026, 03:00 WITA  
🏆 Premier League | Away vs Man City
⏰ vs

📅 16 Feb 2026, 22:30 WITA
🏆 Premier League | Away vs Brentford
⚽ 0-2 FT

Standings:

🏆 Premier League 2025/26

Pos | Team               | P | W | D | L | GD | Pts
----|--------------------|---|---|---|---|----|----
 1  | Liverpool          | 25| 19| 4 | 2 | +38| 61
 2  | Arsenal            | 25| 15| 8 | 2 | +28| 53

References

For detailed API documentation, see references/api_docs.md.

Adding More Teams

To add support for more teams, edit the TEAMS dictionary in scripts/football_api.py:

TEAMS = {
    "liverpool": 64,
    "manutd": 66,
    # Add more team IDs from football-data.org
}

Find team IDs by calling: GET /v4/teams/{teamId} or search via competitions endpoint.