核心用法
Sports Ticker 是一款基于 Python 的本地体育追踪工具,通过调用免费的 ESPN 公开 API 获取实时赛事数据。首次运行 setup.py 启动交互式向导,选择关注运动类型、具体球队、提醒风格(实时比分/终场结果/每日摘要)及免打扰时段,自动生成 config.json 配置文件。日常通过 ticker.py 获取比分,live_monitor.py 实现持续监控,v3 新增 schedule.py 查看未来赛程、auto_setup_crons.py 自动生成比赛日定时任务。
显著优点
1. 零成本无门槛:ESPN API 完全免费且无需申请密钥,即装即用
2. 覆盖全面:支持足球(30+联赛)、NFL、NBA/NCAAB、NHL、MLB、F1 六大类,涵盖全球主流赛事
3. 高度可定制:支持球队 emoji 标记、多联赛归属(如巴萨同时追踪西甲+欧冠)、灵活的 Cron 自动化
4. 多输出格式:提供友好文本、紧凑单行、JSON 机器可读三种格式,适配终端与集成场景
5. 本地隐私优先:数据仅本地处理,无云端账户体系
潜在缺点与局限性
- API 依赖风险:ESPN 可随时调整或关闭公开 API,无 SLA 保障;2023 年 ESPN 曾限制部分端点频率
- 功能边界:不支持投注赔率、球员伤病详情、视频流等增值数据
- 地理限制:部分联赛(如 NFL Sunday Ticket 区域赛)数据可能不完整
- 无原生移动端:纯 CLI 工具,需配合 Cron/推送脚本才能实现手机提醒
- 维护状态:开源项目,长期更新依赖社区贡献
适合人群
- 需要轻量、免费比分追踪的体育爱好者
- 希望自建 Home Assistant/Nodered 自动化流的极客用户
- 对数据隐私敏感、拒绝商业 App 权限索取的用户
常规风险
- 网络暴露:若将 JSON API 输出对接公网服务,需自行校验输入防注入
- Cron 配置错误:
auto_setup_crons.py生成的任务若权限设置不当可能导致脚本重复执行 - API 变更:ESPN 端点变更会导致服务中断,需关注上游更新