介绍
# Sports Ticker
通过**免费实时提醒**追踪您在**多项运动**中最喜欢的球队！
支持：⚽ 足球 • 🏈 美式橄榄球 (NFL) • 🏀 篮球 (NBA) • 🏒 冰球 (NHL) • ⚾ 棒球 (MLB) • 🏎 一级方程式 (F1)
## 首次运行（入门向导）
当 `config.json` 不存在时，运行设置脚本将启动一个交互式向导：
```bash python3 scripts/setup.py ```
**向导会询问：** 1. 📺 **哪些运动？** — 从足球、NFL、NBA、NHL、MLB、F1 中选择 2. 🏆 **哪些球队？** — 从热门球队中选择或搜索任意球队 3. 🔔 **提醒风格？** — 实时比分、仅赛后结果或每日摘要 4. ⏰ **比赛日提醒？** — 在开赛前 30 分钟收到提醒 5. 🌙 **免打扰时段？** — 睡觉时暂停提醒
设置完成后，您的 `config.json` 就绪，您可以开始追踪了！
**随时重新运行设置：** ```bash python3 scripts/setup.py --force # Overwrites existing config ```
## 快速开始
```bash # 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 ```
## 配置示例
```json { "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"] } ] } ```
## 命令
```bash # 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
# 📅 Schedule - View upcoming fixtures (NEW in v3!) python3 scripts/schedule.py # All teams, next 14 days python3 scripts/schedule.py --days 30 # Look further ahead python3 scripts/schedule.py --team spurs # Specific team python3 scripts/schedule.py --compact # One-liner format python3 scripts/schedule.py --json # JSON output
# 🤖 Auto Setup Crons - Generate match-day crons (NEW in v3!) python3 scripts/auto_setup_crons.py # All teams, next 7 days python3 scripts/auto_setup_crons.py --team spurs --days 14 python3 scripts/auto_setup_crons.py --json # Machine-readable python3 scripts/auto_setup_crons.py --commands # OpenClaw CLI commands
# ESPN direct python3 scripts/espn.py leagues python3 scripts/espn.py scoreboard nba basketball python3 scripts/espn.py search "Chiefs" football ```
## 提醒类型
- 🏟 比赛开始（开球 / 跳球） - ⚽🏈🏀⚾ 得分时刻（进球、达阵、三分球、本垒打） - 🟥 红牌 / 驱逐出场 - ⏸ 中场休息 / 节间休息 - 🏁 最终结果（胜/负/平）
## ESPN API（免费！）
无需密钥。涵盖所有主要运动和全球 50 多个联赛。
**支持的运动：** - 足球：英超、西甲、欧冠联赛、美职联 (MLS) 等 30 多项 - 美式橄榄球：NFL - 篮球：NBA、WNBA、NCAA - 冰球：NHL - 棒球：MLB - 赛车：一级方程式