Soccer CLI

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

1. Run the installer:

   ./install.sh
   

   This will compile the Go program and move the soccer-cli binary to ~/.local/bin/.

2. 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