OpenParable
Skip to content
← Back to skills

Sports Ticker

Apps & Automation
sports-ticker

Sports Ticker is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Live sports alerts for Soccer, NFL, NBA, NHL, MLB, F1 and more. Real-time scoring with FREE ESPN API. Track any team from any major league worldwide.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/sports-ticker/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/sports-ticker, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Sports Ticker

Track your favorite teams across multiple sports with FREE live alerts!

Supports: ⚽ Soccer • 🏈 NFL • 🏀 NBA • 🏒 NHL • ⚾ MLB • 🏎️ F1

First Run (Onboarding)

When no config.json exists, running the setup script launches an interactive wizard:

python3 scripts/setup.py

The wizard asks:

  1. 📺 Which sports? — Pick from Soccer, NFL, NBA, NHL, MLB, F1
  2. 🏆 Which teams? — Choose from popular teams or search for any team
  3. 🔔 Alert style? — Live scores, final only, or daily digest
  4. ⏰ Game-day reminders? — Get a heads-up 30 mins before kick-off
  5. 🌙 Quiet hours? — Pause alerts while you sleep

After setup, your config.json is ready and you can start tracking!

Re-run setup anytime:

python3 scripts/setup.py --force  # Overwrites existing config

Quick Start

# First time? Just run setup!
python3 scripts/setup.py  # Interactive wizard

# Find team IDs (any sport)
python3 scripts/setup.py find "Lakers" basketball
python3 scripts/setup.py find "Chiefs" football
python3 scripts/setup.py find "Barcelona" soccer

# Test
python3 scripts/ticker.py

Config Example

{
  "teams": [
    {
      "name": "Barcelona",
      "emoji": "🔵🔴",
      "sport": "soccer",
      "espn_id": "83",
      "espn_leagues": ["esp.1", "uefa.champions"]
    },
    {
      "name": "Lakers",
      "emoji": "🏀💜💛",
      "sport": "basketball",
      "espn_id": "13",
      "espn_leagues": ["nba"]
    }
  ]
}

Commands

# Ticker for all teams
python3 scripts/ticker.py

# Live monitor (for cron)
python3 scripts/live_monitor.py

# League scoreboard
python3 scripts/ticker.py league nba basketball
python3 scripts/ticker.py league nfl football
python3 scripts/ticker.py league eng.1 soccer

# ESPN direct
python3 scripts/espn.py leagues
python3 scripts/espn.py scoreboard nba basketball
python3 scripts/espn.py search "Chiefs" football

Alert Types

  • 🏟️ Game start (kick-off / tip-off)
  • ⚽🏈🏀⚾ Scoring plays (goals, touchdowns, 3-pointers, home runs)
  • 🟥 Red cards / Ejections
  • ⏸️ Halftime / Period breaks
  • 🏁 Final results (WIN/LOSS/DRAW)

ESPN API (Free!)

No key needed. Covers all major sports and 50+ leagues worldwide.

Supported Sports:

  • Soccer: Premier League, La Liga, Champions League, MLS, and 30+ more
  • Football: NFL
  • Basketball: NBA, WNBA, NCAA
  • Hockey: NHL
  • Baseball: MLB
  • Racing: Formula 1