本文目录导读：
你问的“开源项目统计头球争顶成功率”，这个说法有点混搭——“开源项目”通常指软件，而“头球争顶成功率”是足球数据指标，我猜你想问的是：有没有开源项目/工具可以统计足球比赛中的头球争顶成功率？ 下面按这个理解来回答。
结论先说
有，但不多，且大多不是“开箱即用”的成品。 目前没有特别成熟、专门只做“头球争顶成功率”的开源项目，相关能力通常分散在以下几类开源工具/数据项目中，需要自己组合或二次开发。
主要可行的开源路径
足球事件数据开源项目（最直接）
这类项目提供逐事件数据,其中包含“空中对抗/Aerial Duel”事件，可据此计算头球争顶成功率。
- StatsBomb Open Data（GitHub:
statsbomb/open-data）- 提供免费比赛事件数据,事件类型里有
Duel，子类型含Aerial Lost等。 - 可统计：空中对抗次数、成功/失败，进而算成功率。
- 缺点：数据覆盖赛事有限，需自己写统计脚本。
- 提供免费比赛事件数据,事件类型里有
- Wyscout 公开数据 / Socceraction 库
socceraction（GitHub:ML-KULeuven/socceraction）是开源 Python 库，用于把事件数据处理成动作价值框架，兼容 StatsBomb、Wyscout 格式，可在此基础上过滤空中对抗事件做统计。
计算机视觉/视频分析开源项目（更接近“自动统计”）
用比赛视频自动检测头球和争顶,技术门槛高，成熟度参差。
- SoccerNet（
SoccerNet/soccer-net）：足球视频理解基准，含动作识别任务，但“头球争顶”不是标准类别，需自己训练。 - Roboflow / YOLO 系列 + 自定义数据集：社区有不少用 YOLOv8 检测“头球”的开源 notebook，但多为演示级，不能直接产出可靠的争顶成功率。
- TrackLab / Sports2D 等跟踪项目：可做球员检测跟踪，但“争顶成功”判定需要结合球轨迹和球员动作，仍需大量自定义逻辑。
数据抓取 + 统计脚本
- football-data.org / API-Football 的 Python 封装：部分付费 API 提供“空中对抗”统计，开源封装可帮你拉数据，但成功率字段不一定直接给，需自己算。
现实建议
| 需求 | 推荐方案 |
|---|---|
| 想快速算某场比赛头球争顶成功率 | 用 StatsBomb Open Data + 自己写 Pandas 脚本过滤 Duel/Aerial 事件 |
| 想批量处理多赛事 | socceraction + StatsBomb/Wyscout 数据 |
| 想从视频自动统计 | 用 SoccerNet 或 YOLO 自训练，但要做好长期投入准备，目前无成熟开源成品 |
| 想要现成网页工具 | 基本没有专门开源的“头球争顶统计器”，商业产品（如 WyScout、InStat）才有 |
一个简单计算口径（供参考）
头球争顶成功率 = 成功空中对抗次数 /（成功 + 失败空中对抗次数）× 100%，注意不同数据源对“争顶成功”定义不同（是否包含二点球、是否区分进攻/防守），跨源比较要小心。
如果你能说明是想用现成数据算还是从视频自动识别，以及目标赛事/数据源，我可以给更具体的项目名和实现思路。
