football-data Football
Run on Machina
Coming soon
Football (soccer) data across 13 leagues — standings, schedules, match stats, xG, transfers, player profiles. Zero config, no API keys. Covers Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, Champions League, World Cup, Championship, Eredivisie, Primeira Liga, Serie A Brazil, European Championship.
Commands
| Command | Description |
|---|---|
get_current_season |
Detect current season for a competition |
get_competitions |
List available competitions with current season info |
get_competition_seasons |
Available seasons for a competition |
get_season_schedule |
Full season match schedule |
get_season_standings |
League table for a season |
get_season_leaders |
Top scorers/leaders (Premier League only) |
get_season_teams |
Teams in a season |
search_team |
Search for a team by name |
search_player |
Search for a player by name |
get_team_profile |
Basic team info (no squad/roster) |
get_daily_schedule |
All matches for a date across all leagues |
get_event_summary |
Match summary with scores |
get_event_lineups |
Match lineups |
get_event_statistics |
Match team statistics |
get_event_timeline |
Match timeline (goals, cards, subs) |
get_team_schedule |
Schedule for a specific team |
get_head_to_head |
UNAVAILABLE — returns empty |
get_event_xg |
xG data (top 5 leagues only) |
get_event_players_statistics |
Player-level match stats with optional xG |
get_missing_players |
Injured/doubtful players (Premier League only) |
get_season_transfers |
Transfer history via Transfermarkt |
get_player_season_stats |
Player season stats via ESPN |
get_player_profile |
Player profile (FPL and/or Transfermarkt) |
Example Prompts
- Show me the Premier League table
- How did Arsenal vs Liverpool go?
- Deep dive on Chelsea's recent form
- What's Saka's market value?
- Tell me about Corinthians
Quick Start
# CLI
sports-skills football-data get_current_season
# Python
from sports_skills import football_data
football_data.get_current_season()