football-data

Installation
Summary

Soccer data across 13 leagues with standings, schedules, match stats, xG, transfers, and player profiles — no API keys required.

  • Covers 13 leagues including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, Champions League, World Cup, and others
  • Provides match-level data: lineups, team statistics, timelines (goals, cards, substitutions), and expected goals (xG) for top 5 leagues only
  • Includes player profiles, season leaders, transfer history via Transfermarkt, and injury/doubtful player lists (Premier League only)
  • CLI-first interface with Python SDK alternative; requires Python 3.10+; no configuration or authentication needed
SKILL.md

Football Data

Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes.

Setup

Before first use, check if the CLI is available:

which sports-skills || pip install sports-skills

If pip install fails (package not found or Python version error), install from GitHub:

pip install git+https://github.com/machina-sports/sports-skills.git

The package requires Python 3.10+. If your default Python is older, use a specific version:

python3 --version  # check version
# If < 3.10, try: python3.12 -m pip install sports-skills
# On macOS with Homebrew: /opt/homebrew/bin/python3.12 -m pip install sports-skills
Related skills
Installs
811
GitHub Stars
100
First Seen
Feb 16, 2026