Football Data

This is your no-setup solution for soccer data across 13 leagues including the top five European competitions, MLS, and international tournaments. It pulls standings, fixtures, match stats, xG data, player profiles, and Transfermarkt valuations without requiring any API keys. The coverage is broad but uneven: xG only works for top five leagues, season leaders and injury reports are Premier League only, and there's no live scoring. If you need to build match reports, track team form with xG trends, or pull transfer market values, this handles it with a simple CLI or Python SDK. Just don't expect feature parity across all 13 leagues.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 11
skills.sh installs: 2.4K
GitHub stars: 268
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add machina-sports/sports-skills --skill football-data --agent claude-code

Installs into .claude/skills of the current project.

Files

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

No API keys required.

Quick Start

Prefer the CLI — it avoids Python import path issues:

sports-skills football get_daily_schedule
sports-skills football get_season_standings --season_id=premier-league-2025

Python SDK (alternative):

from sports_skills import football

standings = football.get_season_standings(season_id="premier-league-2025")
schedule = football.get_daily_schedule()