| name | football |
| description | European football matches — upcoming games, results, and highlights for briefings. |
| homepage | https://www.football-data.org/ |
| metadata | [object Object] |
Football Skill ⚽
Track European football matches — upcoming games, live scores, and results.
Quick Start
# Upcoming matches (next 7 days)
{baseDir}/scripts/football.js upcoming
# Today's matches
{baseDir}/scripts/football.js today
# Specific league
{baseDir}/scripts/football.js upcoming --league bundesliga
{baseDir}/scripts/football.js upcoming --league premier-league
{baseDir}/scripts/football.js upcoming --league champions-league
# Interesting matches only (top teams, derbies)
{baseDir}/scripts/football.js highlights
# Results from recent matches
{baseDir}/scripts/football.js results
Supported Leagues
| League | Code | API |
|---|---|---|
| Bundesliga | bundesliga, bl1 |
OpenLigaDB (free) |
| 2. Bundesliga | bundesliga2, bl2 |
OpenLigaDB (free) |
| DFB Pokal | dfb |
OpenLigaDB (free) |
| Premier League | premier-league, pl |
football-data.org |
| La Liga | la-liga, pd |
football-data.org |
| Serie A | serie-a, sa |
football-data.org |
| Ligue 1 | ligue-1, fl1 |
football-data.org |
| Champions League | champions-league, cl |
football-data.org |
| Europa League | europa-league, el |
football-data.org |
Morning Briefing Integration
For daily briefings, use:
{baseDir}/scripts/football.js briefing
Returns a compact summary of:
- Today's interesting matches
- Yesterday's notable results
- Upcoming highlights this week
API Keys
OpenLigaDB (German leagues): No key required! ✅
football-data.org (other leagues): Free tier available
- Register at https://www.football-data.org/client/register
- Set
FOOTBALL_DATA_API_KEYenvironment variable
"Interesting" Match Criteria
The highlights command filters for:
- Top teams playing (Bayern, Dortmund, Real, Barça, etc.)
- Derby matches
- Champions League knockout games
- Title deciders (late season, close standings)
Output Formats
# JSON (default)
{baseDir}/scripts/football.js today
# Human-readable
{baseDir}/scripts/football.js today --human
# Compact (for briefings)
{baseDir}/scripts/football.js briefing --compact