用途:聚合多个免费数据源,查询全球主要联赛的足球数据,包括积分榜、赛程、比赛摘要与统计、xG、转会、球员资料、历史交锋和球队实力。
安装与用法:先检查 which sports-skills,不存在则 pip install sports-skills;若安装失败可从 GitHub 安装 pip install git+https://github.com/machina-sports/sports-skills.git,需 Python 3.10+。优先使用 CLI,例如 sports-skills football get_daily_schedule、sports-skills football get_season_standings --season_id=premier-league-2025。也可用 Python SDK:from sports_skills import football。无需 API 密钥。
主要能力:支持查询当前赛季、联赛列表与赛季、赛季赛程、积分榜、球队、按名称搜索球队和球员、球队资料与阵容、每日赛程、比赛摘要/阵容/统计/时间线、球队赛程、历史交锋、球队 Elo 实力对比、比赛预测、xG、球员单场统计、伤停球员、转会历史和球员赛季数据。
数据覆盖:ESPN 覆盖所有联赛的积分榜、赛程、球队与比赛数据;Understat 仅前五大联赛(英超、西甲、德甲、意甲、法甲)提供 xG;FPL 仅英超提供赛季射手榜和伤停球员;Transfermarkt 提供有 tm_player_id 的球员资料与身价;football-data.co.uk 提供 11 个欧洲国内联赛的同级别历史交锋;ClubElo 提供欧洲俱乐部实力评分与一周内的胜负预测。未覆盖的接口返回空数据并附说明,而非报错。
限制:赛季 ID 必须用 get_current_season 获取而非硬编码;球队和比赛 ID 需先搜索或从赛程获取,不可猜测;xG 和球员 xG 统计仅限前五大联赛;赛季射手榜和伤停球员仅限英超;历史交锋仅限同级别联赛;比赛预测仅覆盖约一周内的赛程;ClubElo 服务中断时实力评分回退为本地 Elo 并标注 source: local-elo;数据可能存在延迟。部分命令不存在,须使用文档列出的正确命令。具体参数、返回结构和完整覆盖表见 references/api-reference.md。