SuperAPI AI 工具集

data-sources

数据与分析

查看项目

更新于 10-16 03:04

技能介绍

用途:在编写数据获取代码前,为建模问题挑选可复现、合规的公共体育数据源。适用于不确定选哪个源、需要在加载前确定粒度(比赛、球队-比赛、球员-比赛、回合/事件)、比较nflverse、sportsdataverse、pybaseball等公共选项,或撰写含出处、快照与首次加载校验的数据源方案时。

主要能力:输出数据源方案,命名所需粒度、决策时点字段、主源、备选源、覆盖风险、条款、快照规则与首次加载检查;提供源比较评分维度(覆盖、粒度、语义、时间、身份标识、可靠性、访问、可复现性、成本/体量);给出首次加载诊断项(行数、自然键唯一性、状态区分、时间戳含义、缺失率等);规定快照与出处策略,保留未改动的原始响应及其检索元数据。

必要用法:先锁定问题、分析粒度与自然键、目标、总体及决策时点T;列出最小必需字段与稳定标识;用评分卡比较至少两个候选源;查上游文档确认覆盖面、字段/时间语义与条款;数据源方案工件可用命令生成:python /path/to/data-sources/scripts/print_source_plan.py --out data/source_plan.md;首次加载用样例校验键、行数、周期、结果、实体、时间戳与空值,并测试联接的未匹配与多对多行。

适用场景:NFL赛前胜率模型(球队-比赛粒度,nflverse/nflreadpy);MLB投球分析(投球粒度,pybaseball Statcast,按日期限定请求);跨源伤病补充(需稳定球员/球队ID与发布时间戳及as-of谓语)。

限制:不用于已完成加载后的EDA或建模,也不替代具体加载器技能;源选择不产生预测效度。不得在有受支持发布/API时爬取,不得用显示名直接合并,不得把当前名单/评分当历史,不得无界拉取,不得实验中途换源或混粒度,不得只凭一次记分板调用推断赛季覆盖。需遵守条款、速率限制、访问控制与署名,仅在允许时缓存。资料未提供具体价格与稳定排名,具体覆盖与条款须在选源时向上游文档核实。