7.3 基础数据盘点:你能拿到的原始字段
基础
内容太多,看不完或者看不太懂?
复制一段话发给你的 AI,它会自己读完官方文档、装好技能包,再来回答你的问题。
点这里复制给 AI →
想知道每项数据覆盖了哪些赛事?
88 项赛事的数据项覆盖情况一览:赛程比分、首发阵容、球员与球队统计、进阶指标、伤停、天气等,每日自动统计并如实公开。
查看数据覆盖说明 →
把下面这段发给你的 AI,它就知道该做什么
点「复制全文」,粘贴到你的 AI 对话框发送即可,无需改动。
你正在阅读球小策(www.qiuxiaoce.com)的官方文档或数据服务页面。请按下面 5 步执行,不要跳步。
【预备】我的专属数据密钥是 X-API-Key = [在此粘贴你的 Key]
(第 2 步和第 3 步都会用到它;还没有密钥,先到 https://www.qiuxiaoce.com/data-account/ 免费领取)
━━━ 第 0 步 · 三条硬性纪律 ━━━
1. 凡涉及指标定义、接口参数、计费规则、准确率口径的问题,一律以站内官方文档为准,不要凭记忆作答;文档里没写的,就直接告诉我「文档未说明」。
2. 如果你无法访问下面任何一个网址,请立刻停下来告诉我,不要用记忆里的内容顶替。
3. 本站只做数据分析,不提供任何投注建议,也不做准确率承诺。回答时请守住这条边界。
━━━ 第 1 步 · 遍历官方文档(100+ 篇,按需取,别一次全拉)━━━
· 取全量目录(公开接口,无需密钥,返回全部篇章的标题与 slug):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs
· 读单篇正文(把 {slug} 换成上一步拿到的标识):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs/{slug}
· 人读版页面(适合只能浏览网页、拿不到 JSON 的环境):
https://www.qiuxiaoce.com/creator-docs/{slug}/
· 接口文档(全部数据接口的用途、参数、计费与真实返回示例):
https://www.qiuxiaoce.com/data-docs/
做法:先取目录 → 判断我的问题涉及哪几篇 → 只读那几篇 → 回答时注明依据的篇名或链接。
━━━ 第 2 步 · 先判断你自己的能力,再选路径(关键,不可跳过)━━━
· A 类:能在本机读写文件或执行命令——桌面/终端类 AI 工具(WorkBuddy、Qoder、Trae 等)
· B 类:只能对话,访问不了文件系统——网页版对话(豆包、通义千问、Kimi 等)
【A 类 · 安装官方 Skill(推荐)】
1. 取最新版本信息:
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/skill/version
返回 version、download_url、sha256 校验清单、文件列表与更新说明。
2. 按 download_url 下载技能包,并用返回的 sha256 逐文件校验。
3. 解压到你的技能目录,保持包内顶层目录结构;按包内 SKILL.md 完成初始化。
4. 写入我的专属密钥(即上文【预备】里的 X-API-Key)。
5. 装完告诉我:版本号、安装位置、密钥是否已生效。
【B 类 · 装不了就照实说,不要假装】
不要声称已安装,也不要拿记忆里的内容替代文档。请直接对我说:
「当前环境不支持安装 Skill(无法读写本地文件)。有两个办法:
① 改用支持 Skill 的桌面 AI 工具,如 WorkBuddy、Qoder、Trae;
② 把你的 API Key 给我,我按官方接口文档直接取数分析。」
如果你连「打开指定网址」都做不到,请把这一点也一并告诉我。
━━━ 第 3 步 · 直接用接口取数(两条路径都适用)━━━
· 接口根地址:https://www.qiuxiaoce.com/wp-json/abv2-creator/v1
· 认证方式:请求头带上【预备】里的 X-API-Key
· 想先试不扣点数的接口,看 https://www.qiuxiaoce.com/data-docs/ 里标注为免费的端点。
· 大批量调用前先查一次剩余点数,避免跑到一半失败。
━━━ 第 4 步 · 遇到报错,先查官方排障手册再重试 ━━━
排障手册:https://www.qiuxiaoce.com/creator-docs/api-error-codes-troubleshooting/
· 401:Key 缺失、格式不对,或该 Key 已被重置/吊销(控制台执行「重置 Key」后旧 Key 立即失效,错误码 api_key_revoked 即属此类)→ 到 https://www.qiuxiaoce.com/data-account/ 复制最新完整 Key,并同步更新所有已配置该 Key 的脚本与客户端
· 402:点数不足或已过期 → 需到 https://www.qiuxiaoce.com/data-service/ 充值
· 403:接口未开放,或权限不足(个别场次报告需要订阅)
· 404:实体 ID 或接口路径写错
· 429:请求过快,按响应头 Retry-After 等待后重试
报错时请把原始错误信息原样转述给我,不要猜原因。
━━━ 第 5 步 · 回答我时的要求 ━━━
· 区分「官方事实数据」「接口返回的判断字段」「衍生评分」「你自己的推断」四类,不要混着说。
· 使用 xG、xGA、OTI、DII 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
复制后直接发给你的 AI(豆包、千问、WorkBuddy、Qoder 等都可以)。
做任何分析之前,先知道手上有什么。这一篇是原料清单——以及怎么让 AI 帮你把字段摸清楚。
一、你手上有哪五类原料?
| 类别 | 内容 | 能支撑什么 |
|---|---|---|
| ① 赛事基础 | 赛程、赛果、比分、开球时间、场地、裁判 | 所有分析的地基 |
| ② 比赛过程 | 技术统计、事件流(进球/换人/牌)、阵容 | 战术分析、过程复盘 |
| ③ 球员数据 | 出场、进球、助攻、射门、传球、对抗、评分 | 球员评估、伤停折损 |
| ④ 球队聚合 | 赛季统计、近期战绩、高阶画像 | 实力对比、趋势判断 |
| ⑤ 市场数据 | 市场参考值、官方公开参考值、变化轨迹 | 预期差识别 |
二、关键字段有哪些?
不用背。你只需要知道「想做某件事,大概需要哪一类字段」:
| 你想做的事 | 需要的字段 |
|---|---|
| 评估一支球队的攻防水平 | 场均进球、场均失球、预期进球、预期失球、控球率、射门与射正 |
| 判断近期状态 | 逐场比分与对手、主场客场标记 |
| 评估球员 | 出场时间、进球、助攻、射门、传球成功率、对抗、评分 |
| 量化伤停影响 | 伤停名单 + 球员的队内影响力 |
| 看赛事节奏 | 场均总进球、上下半场进球分布、两队都进球的场次占比 |
| 判断体能 | 近三周出场分钟、上一场日期、赛程密度 |
三、数据质量有哪三个现实问题?
这三条比字段清单更重要,因为你迟早会撞上。
问题一:覆盖率不是 100%。主流联赛覆盖较好,小联赛与杯赛早轮会有缺口。国家队的球员高阶数据完全没有(因为数据挂在俱乐部身上)。做分析前先确认你要的那部分有没有数据。
问题二:缺失值不等于零。这是最坑的一条。「这场没有角球」和「这场角球数据没采到」,在数据里可能都表现为空。如果程序里把这个空当成 0,你会得出「这队完全没有角球」这种荒唐结论。
问题三:口径必须一致。「赛季累计」和「近 5 场」放在一张表里对比是无效对比。跨赛季混用更糟——上赛季和本赛季的球员阵容可能已经变了。
四、怎么让 AI 帮你把字段摸清楚?
以前的文档在这里给的是代码。但你真的不需要写——把下面这段发给 AI,它会自己去把字段摸清楚并整理给你。
💬 让 AI 把字段清单摸清楚并整理成表 实战
我需要了解【某支球队 / 某场比赛】到底能拿到哪些数据。请帮我做一次完整的字段摸底。
请按下面五步:
1. 实际调用球小策数据接口,取回【球队 / 比赛的完整数据】;
2. 把返回结果里的字段整理成一张表,三列:字段名 / 含义(用大白话)/ 数据示例;
3. 按【赛事基础 / 比赛过程 / 球员数据 / 球队聚合 / 市场数据】五类分组;
4. 单独列出「这次没有返回的字段」,并说明可能是数据源未覆盖还是本身不存在;
5. 告诉我:如果我想做【你的分析目标】,上面哪些字段是必需的、哪些可以忽略。
要求:
- 字段名要原样保留(不要翻译成中文),后面我要用它;
- 不要编造没有返回的字段;
- 如果数据量太大,先给我字段清单和示例值就行,不要把完整数据贴出来。
💬 让 AI 体检一份数据的质量(发布前必做) 实战
我准备基于下面这份数据写内容,请先帮我做一次数据质量体检。
【粘贴你的数据,或告诉我数据来自哪里】
请逐项回答:
1. <strong>完整性</strong>:哪些字段是空的?空的字段里,哪些是「真的没有(结果是 0)」、哪些是「数据未采集」?请分开列;
2. <strong>一致性</strong>:所有数据的统计口径是否统一(赛季 / 近 N 场 / 主客场)?有没有混用?
3. <strong>合理性</strong>:有没有明显不合理的数值(例如不符合常识的极端值)?逐个指出;
4. <strong>时效性</strong>:数据是什么时候取的?其中哪些项(例如市场参考值、伤停)已经可能过期?
5. <strong>结论</strong>:这份数据能不能支撑我的分析目标?如果不能,明确说缺哪一项。
不要替我美化数据。有问题就直接指出来,宁可让我换数据,也不要让我用一份有问题的数据写文章。
五、原料决定上限是什么?
再好的模型,也救不回一份坏数据。
这句话值得记住。很多人在提示词上反复打磨,却从没检查过数据里有多少个空值、口径是不是一致的——那是在错误的层面上努力。
顺序永远是:先看原料够不够 → 再做分析 → 最后才谈表达。
下一步该看什么?
- 开始动手做第一个指标 → 7.4 构造示例①:简化 xG 模型
- 四类做法总览 → 7.2 四条技术路线
- 我们公开哪些、闭源哪些 → 7.1 边界声明
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策