技能介绍

解决数据获取的脆弱性

在工程实践中，直接抓取 ESPN 等体育网站的数据往往非常脆弱。赛季年份的硬编码、球队 ID 的变更（如西雅图海怪、犹他猛犸象的非连续 ID）以及 Python 环境的不兼容，经常导致自动化脚本在赛季初或休赛期直接崩溃。该技能通过标准化的 CLI 工具封装了这些底层细节，让开发者无需关心 HTTP 请求的构造与解析。

核心工作流与命令设计

技能的调用逻辑遵循严格的三步走模式：

时间推导：根据系统时间推导当前赛季年份（如 2026 年 2 月对应 2025-26 赛季）；
ID 解析：通过 get_teams 将用户输入的球队名解析为 ESPN 标准 ID；
接口调用：调用具体数据接口，如使用 get_scoreboard 获取实时比分，或 get_game_summary 提取完整的 box score。

对于错误处理，它要求静默捕获异常并尝试替代方案，避免向用户暴露底层错误。

边界与避坑指南

在使用该技能时，有几个明确的限制需要注意。首先，它不提供任何博彩赔率接口，若需获取预测市场数据，必须切换至 polymarket 或 kalshi 技能。其次，ESPN 的数据源特性决定了 get_scoreboard 仅覆盖进行中或已结束的比赛，未来的赛程需使用 get_schedule 查询，且休赛期（7-9 月）的 scoreboard 会返回空结果。此外，CLI 依赖 sports-skills 包，要求 Python 3.10+ 环境，且部分球员统计接口需要正确的 player_id。