soccer-cli

// A CLI to check soccer scores, game details, and player stats from your terminal.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namesoccer-cli

version1.0.0

authorJ R

descriptionA CLI to check soccer scores, game details, and player stats from your terminal.

requires[object Object]

installinstall.sh

usagesoccer-cli scores "Manchester United" soccer-cli game <fixture_id> soccer-cli squad <fixture_id>

soccer-cli

A command-line interface to check soccer scores, game details, and player stats using the API-Football service.

Description

This skill provides a set of commands to quickly retrieve football data directly in your terminal. You can get the latest score for your favorite team, see detailed events from a specific match (like goals and cards), and view the full squad with player ratings and minutes played.

Installation

Run the installer:
```
./install.sh
```
This will compile the Go program and move the soccer-cli binary to ~/.local/bin/.
Configure API Key: The CLI needs an API key from API-Football.

Create a configuration file at ~/.config/soccer-cli/config.yaml:
```
mkdir -p ~/.config/soccer-cli
touch ~/.config/soccer-cli/config.yaml
```
Add your API key to the file in the following format:
```
apikey: YOUR_API_KEY_HERE
```

Usage

Get the latest score for a team:
```
soccer-cli scores "<team-name>"
```
Example: soccer-cli scores "Real Madrid"
Get detailed events from a game: (Use the Fixture ID from the scores command)
```
soccer-cli game <fixture_id>
```
Example: soccer-cli game 123456
Get the squad and player stats for a game:
```
soccer-cli squad <fixture_id>
```
Example: soccer-cli squad 123456