NFL Data 是一个用于获取美国职业橄榄球联盟（NFL）数据的工具，数据来源包括 ESPN 公开接口和 nflverse 后端。它提供命令行界面（CLI）和 Python SDK 两种使用方式，无需 API 密钥，零配置即可开始查询。
用途
该工具面向需要 NFL 赛程、比分、排名、阵容、逐回合数据、球员与球队统计等信息的场景。它整合了两个数据后端：ESPN 提供实时比分、比赛摘要、伤病报告等；nflverse 提供标准化的历史数据表，包括赛程、每周阵容、逐回合数据和统计汇总。
主要能力
工具提供以下命令：
- get_scoreboard：实时/近期比分
- get_standings：按联盟和分区排名
- get_teams：全部 32 支 NFL 球队
- get_team_roster：球队完整名单
- get_team_schedule：特定球队赛程
- get_game_summary：详细技术统计和得分回合
- get_leaders：统计领先者
- get_news：新闻文章
- get_play_by_play：逐回合数据
- get_win_probability：胜率图表数据
- get_schedule：单赛季周或 ESPN 当前窗口
- get_injuries：伤病报告
- get_transactions：近期交易
- get_futures：期货/赔率市场
- get_depth_chart：球队深度图
- get_team_stats：球队统计概况
- get_player_stats：球员统计概况
- get_nflverse_schedule：nflverse 赛程/结果表
- get_nflverse_weekly_rosters：nflverse 每周阵容
- get_nflverse_player_stats：nflverse 球员统计
- get_nflverse_team_stats：nflverse 球队统计
- get_nflverse_play_by_play：nflverse 逐回合数据
- get_fantasy_trending：Sleeper 梦幻趋势添加/删除
nflverse 数据表较宽，支持 sort_by、descending、limit 和 fields 参数来筛选所需行和列。
使用方式
安装：
which sports-skills || pip install sports-skills
若 pip 安装失败，可从 GitHub 安装：
pip install git+https://github.com/machina-sports/sports-skills.git
需要 Python 3.10+。nflverse 后端需安装额外依赖：
pip install sports-skills[nfl]
CLI 示例：
sports-skills nfl get_scoreboard
sports-skills nfl get_standings --season=2025
sports-skills nfl get_teams
Python SDK 示例：
from sports_skills import nfl
scores = nfl.get_scoreboard({})
standings = nfl.get_standings({"params": {"season": "2025"}})
使用前需根据系统提示中的当前日期推导赛季年份，不要硬编码。若只提供球队名称，需先调用 get_teams 解析球队 ID。
适用场景
- 查询实时比分和排名
- 获取球队名单、伤病报告和交易信息
- 分析球员和球队统计数据
- 获取逐回合数据和胜率数据
- 结合 ESPN 和 nflverse 数据进行综合分析
- 查看梦幻橄榄球趋势
限制
- 不提供 get_odds / get_betting_odds 命令，预测市场赔率需使用 polymarket 或 kalshi 技能。
- 不存在 search_teams、get_box_score、get_player_ratings 命令。
- ESPN 和 nflverse 使用不同的标识符系统，球队缩写和球员 ID 不自动对齐，需手动匹配。
- get_schedule 不返回整个赛季，仅单周或 ESPN 当前窗口。
- 空赛程响应不能推断为轮空，需检查 coverage 块。
- 伤病记录缺失不代表球员健康。
- get_fantasy_trending 的 count 是流行度信号，不是预测或推荐。
- nflverse 后端在 Python 3.9 下功能受限，get_nflverse_team_stats 不可用。
- 部分功能依赖第三方数据源，数据新鲜度需参考 source.trending_fetched_at。