名称： sports-ticker
版本： 3.0.6
描述： 足球、NFL、NBA、NHL、MLB、F1 等赛事实时提醒。使用免费的 ESPN API 获取实时比分。可追踪全球各大联赛的任何球队。
元数据： {"openclaw":{"requires":{"bins":["python3"],"note":"无需 API 密钥。使用免费的 ESPN API。"}}}

体育赛事提醒器

通过免费的实时提醒，追踪您喜爱的多项目球队！

支持：⚽ 足球 • 🏈 NFL • 🏀 NBA • 🏒 NHL • ⚾ MLB • 🏎 F1

首次运行（初始化）

当 config.json 文件不存在时，运行设置脚本将启动一个交互式向导：

python3 scripts/setup.py

向导将询问：
1. 📺 关注哪些体育项目？ — 从足球、NFL、NBA、NHL、MLB、F1 中选择
2. 🏆 关注哪些球队？ — 从热门球队中选择或搜索任意球队
3. 🔔 提醒样式？ — 实时比分、仅最终结果或每日摘要
4. ⏰ 赛前提醒？ — 在开赛前 30 分钟获得通知
5. 🌙 静默时段？ — 在您睡眠时暂停提醒

设置完成后，您的 config.json 文件即准备就绪，可以开始追踪了！

随时重新运行设置：

python3 scripts/setup.py --force  # 覆盖现有配置

快速开始

# 第一次使用？直接运行设置脚本！
python3 scripts/setup.py  # 交互式向导

# 查找球队 ID（任何体育项目）
python3 scripts/setup.py find "湖人" basketball
python3 scripts/setup.py find "酋长" football
python3 scripts/setup.py find "巴塞罗那" soccer

# 测试
python3 scripts/ticker.py

配置示例

{
  "teams": [
    {
      "name": "巴塞罗那",
      "emoji": "🔵🔴",
      "sport": "soccer",
      "espn_id": "83",
      "espn_leagues": ["esp.1", "uefa.champions"]
    },
    {
      "name": "湖人",
      "emoji": "🏀💜💛",
      "sport": "basketball",
      "espn_id": "13",
      "espn_leagues": ["nba"]
    }
  ]
}

命令

# 为所有球队显示提醒器
python3 scripts/ticker.py

# 实时监控（用于 cron 任务）
python3 scripts/live_monitor.py

# 联赛积分榜
python3 scripts/ticker.py league nba basketball
python3 scripts/ticker.py league nfl football
python3 scripts/ticker.py league eng.1 soccer

# 📅 赛程 - 查看即将到来的比赛（v3 新增！）
python3 scripts/schedule.py                    # 所有球队，未来 14 天
python3 scripts/schedule.py --days 30          # 查看更远的赛程
python3 scripts/schedule.py --team spurs       # 特定球队
python3 scripts/schedule.py --compact          # 单行格式
python3 scripts/schedule.py --json             # JSON 输出

# 🤖 自动设置 Cron 任务 - 生成比赛日的 cron 任务（v3 新增！）
python3 scripts/auto_setup_crons.py            # 所有球队，未来 7 天
python3 scripts/auto_setup_crons.py --team spurs --days 14
python3 scripts/auto_setup_crons.py --json     # 机器可读格式
python3 scripts/auto_setup_crons.py --commands # OpenClaw CLI 命令

# ESPN 直接操作
python3 scripts/espn.py leagues
python3 scripts/espn.py scoreboard nba basketball
python3 scripts/espn.py search "酋长" football

提醒类型

• 🏟 比赛开始（开球 / 跳球）
• ⚽🏈🏀⚾ 得分事件（进球、达阵、三分球、本垒打）
• 🟥 红牌 / 驱逐出场
• ⏸ 中场休息 / 节间休息
• 🏁 最终结果（胜/负/平）

ESPN API（免费！）

无需密钥。覆盖全球所有主要体育项目和 50 多个联赛。

支持的体育项目：
- 足球：英超、西甲、欧冠、MLS 等 30 多个联赛
- 美式橄榄球：NFL
- 篮球：NBA、WNBA、NCAA
- 冰球：NHL
- 棒球：MLB
- 赛车：一级方程式