Golazo

Use it when

• You cannot stream a match and want live scores, goals, cards, substitutions, and stats for 65+ football leagues directly in your terminal with desktop goal notifications.
• You are building an agent or script that needs live or recent football match data as structured JSON with a self-describing contract, typed error codes, and a documented exit code map.

What it solves

Not the fit when

• Match detail lookups against real IDs are best-effort; the README notes reliability only with --mock.
• Not a general sports data API; football (soccer) only.
• No streaming or video; text data, stats, and links to official highlights only.
• video streaming of matches
• betting odds or predictions
• sports other than football
• historical season-level statistics archives

Install

brew install 0xjuanma/tap/golazo  (or: curl -fsSL https://raw.githubusercontent.com/0xjuanma/golazo/main/scripts/install.sh | bash)

Invoke

Run `golazo` for the interactive TUI with live match timelines and desktop goal notifications; for scripts and agents use JSON subcommands: `golazo live`, `golazo finished --days 3`, `golazo match <id>`, `golazo leagues --all`, `golazo capabilities` (structured output with typed error codes, contract in docs/CLI.md).

Alternatives

No reviewed alternatives recorded yet.