足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策4.6 核心接口精讲②：match-pack 单场全景数据包
旗舰match-pack 是球小策的旗舰接口（50 点）。这一篇完整拆解它。
一、它解决什么问题
做单场深度分析，你需要的数据分散在七八个接口里。逐个调用不仅贵，而且需要自己做关联拼接。
match-pack 把这些数据一次性打包好，并且已经完成了关联处理。
三种等价路径
/match-pack/{id}
/match_pack/{id}
/match/{id}/pack三条路径指向同一份数据，按习惯选一个即可。
二、包含哪些维度
| 维度 | 内容 | 对应单接口 |
|---|---|---|
| 比赛基础 | 时间、场地、双方、状态 | /fixtures/{id} |
| 技术统计 | 控球、射门、射正、角球、犯规等 | /fixtures/{id}/stats |
| 事件流 | 进球、换人、黄红牌时间线 | /fixtures/{id}/events |
| 阵容 | 首发、替补、阵型 | /fixtures/{id}/lineups |
| 球员表现 | 逐球员数据 | /fixtures/{id}/players |
| 市场数据 | 数据数值快照与异动 | /fixtures/{id}/quotes |
| 高阶指标 | 双方攻防实时指数、阵容完整度等 | 需多处获取，此处已聚合 |
三、调用示例
curl -s 'https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/match-pack/1557403'
-H 'X-API-Key: YOUR_API_KEY_HERE'注意：50 点一次。调试时利用 60 秒去重机制，重复调用不会重复扣点。
四、把它交给 AI 的正确方式
拿到数据包后，不要直接把整个 JSON 粘给 AI（会占用大量上下文，而且模型读不懂嵌套结构）。
推荐做法是先做一次提炼，再把提炼结果给模型：
💬 可复制指令
你是一位足球数据解读分析师。
下面是我从数据接口获取的这场比赛的结构化数据。
请严格基于这些数据完成分析，不要引入任何外部信息。
执行步骤：
第一步，把关键指标整理成一张对比表（主队 / 客队 / 谁占优）；
第二步，找出双方在战术对位上的「长板打短板」关系；
第三步，结合伤停信息，说明哪一方的数据需要打折；
第四步，给出三点最值得关注的结论。
约束：
1. 禁止预测比分，禁止使用「必胜」「稳赢」等绝对化表述；
2. 每个判断必须绑定一个具体数字；
3. 没有数据支撑的内容标注「无数据支撑」并跳过。
数据：
[粘贴关键字段]
五、成本对比：值不值 50 点
| 方案 | 点数 | 说明 |
|---|---|---|
| 逐接口拼装（统计+事件+阵容+球员+市场） | 25+ | 还需自己处理关联，可能遗漏高阶指标 |
| match-pack | 50 | 一次拿全，已聚合，含高阶指标 |
什么时候不建议用
- 你只需要看比分 → 用
/fixtures/{id}（2 点）； - 你只需要技术统计 → 用
/fixtures/{id}/stats（5 点）。
match-pack 的综合性价比在于「全景」，单点查询不要用它。
六、数据落盘建议
已结束比赛的数据不会变化，务必落盘缓存：
from pathlib import Path
import json
CACHE = Path('./match_cache')
CACHE.mkdir(exist_ok=True)
def load_or_fetch(fixture_id, fetch_fn):
f = CACHE / f'{fixture_id}.json'
if f.exists():
return json.loads(f.read_text(encoding='utf-8'))
data = fetch_fn(fixture_id)
f.write_text(json.dumps(data, ensure_ascii=False), encoding='utf-8')
return data