7.12 30 行代码:搭建每日赛事预警机器人
实战
内容太多,看不完或者看不太懂?
复制一段话发给你的 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 等都可以)。
先说清楚:标题里的「30 行代码」指的是——这些代码你不需要自己写。把下面那段需求描述发给 AI,它几秒钟就写好了。你要做的是想清楚「要什么」和「怎么验证它写对了」。
一、你要的是一个什么样的机器人?
不是什么复杂的东西。每天早上自动看一遍今天的比赛,把符合你条件的挑出来告诉你。
| 它做什么 | 你的收益 |
|---|---|
| 拉今天的赛事清单 | 不用自己一场场翻 |
| 按你的条件筛选 | 过滤掉不关心的 |
| 给出筛选理由 | 知道为什么被挑出来 |
| 推送到你方便看的地方 | 不用专门去查 |
二、怎么让 AI 一次把脚本写对?
关键是把需求描述清楚。下面这段可以直接复制,改掉中括号里的内容。
💬 让 AI 写一个每日预警机器人(需求描述模板) 实战
请帮我写一个「每日赛事预警机器人」的小脚本。
<strong>我的环境</strong>:【例如:Windows / macOS / Linux;Python 版本;我完全不懂代码,请你顺带告诉我怎么运行】
<strong>数据来源</strong>:球小策创作者 API,密钥在我的环境变量 QIUXIAOCE_API_KEY 里
<strong>我希望它做什么</strong>:
1. 每天【几点】自动跑一次,拉取当天的全部赛事;
2. 按下面的条件筛选,把符合的场次挑出来:
- 条件一:【例如:两队近 5 场场均总进球都在 2.5 以上】
- 条件二:【例如:其中一方有主力伤停】
- 条件三:【例如:市场参考值在赛前有调整】
3. 对每个被挑中的场次,用一句话说明「它为什么被挑出来」(要写清是哪个条件命中的,以及对应的具体数值);
4. 把结果保存成一个文件,同时【例如:打印在屏幕上 / 发到我的邮箱 / 写入一个表格】。
<strong>硬性要求</strong>:
- 密钥从环境变量读取,不要写死在代码里;
- 请求要有间隔,避免触发限流;
- 遇到接口报错要给出明确提示(区分点数不足、找不到资源、请求过频),不要只抛一个通用错误;
- 如果某个场次的数据缺失,跳过它并在结果里注明「本场数据不完整」,不要用其他场次的数据替代;
- 结果里不要出现任何投注建议、结果预测或绝对化表述。
<strong>交付要求</strong>:
1. 先告诉我你打算怎么做(三到五句话的思路),我确认后再写代码;
2. 写完后,单独告诉我:怎么运行它、怎么改筛选条件、怎么让它每天自动跑。
这份需求里最重要的是「先告诉我思路,我确认后再写」这一句。它让你在 AI 动手之前,有机会发现需求理解错了。
三、筛选条件一般怎么设?
筛选条件是你这个机器人的灵魂。三种常见思路:
| 类型 | 例子 | 特点 |
|---|---|---|
| 指标阈值型 | 「两队场均总进球都超过 2.5」 | 简单直接,但阈值需要自己试 |
| 对比差异型 | 「一队的进攻指标明显高于对手的防守指标」 | 更贴近「有看点」的定义 |
| 异常变动型 | 「赛前市场参考值出现明显调整」 | 捕捉信息变化,但要小心不要过度解读 |
建议从第一种开始——先把跑通流程,再优化筛选逻辑。一上来就设计复杂条件,你会花几天时间在调试上,而不是在产出内容上。
四、机器人还能往哪些方向改造?
跑通之后,可以按这个顺序升级。每一条都可以直接用话术让 AI 改:
- 加筛选维度:「在现有条件之外,再增加一个条件:【新条件】。同时告诉我新增的条件把命中场次从几场变成了几场。」
- 加历史对比:「让它同时拉取这些球队近 5 场的表现,在结果里加一列『近期趋势』(上升 / 平稳 / 下降)。」
- 加输出形态:「除了保存文件,再生成一段可以直接发在社群的短文案,包含对阵、要点和一句观察框架。」
- 加告警:「当命中的场次超过 5 场时,在结果开头加一行提示,提醒我今天是高密度日,需要挑重点。」
💬 改造:加一个筛选条件并对比效果 实战
请在现有脚本基础上增加一个筛选条件:【描述新条件】。
请做三件事:
1. 加上这个条件;
2. 告诉我:加上之后,历史数据里命中的场次从几场变成了几场;
3. 如果这个条件把命中场次砍掉了八成以上,提醒我「这个条件可能过严了」,并建议一个更宽松的版本。
同时保持原有要求不变:先给思路,我确认后再改代码。
五、做这个机器人要注意哪三件事?
注意一:把成本和输出放在结果里。让脚本每次跑完都报告「本次花了多少点、余额还剩多少」。不加这一条,你很可能在不知不觉里用掉大量点数。
注意二:不要让失败静默。接口报错、数据缺失、筛选条件写错——这三种情况都必须有明确提示。最怕的是它「跑完了但什么都没输出」,你还以为今天没有符合条件的比赛。
注意三:结果要能存下来。每天的预警结果累积起来,一两个月后就是你复盘选题质量的第一手材料。
六、怎么让它帮你解读结果?
💬 让 AI 帮你解读预警结果 实战
这是我的预警机器人今天跑出来的结果:
【粘贴结果】
请帮我:
1. 按「值得深挖」的程度排序,说明排序理由(不要只按条件命中数量排);
2. 从里面挑出 1 到 2 场,说明为什么它们最值得写一篇内容;
3. 指出哪些场次虽然命中了条件、但其实没什么可写的(例如数据单薄、两队状态都很平),避免我浪费时间去写;
4. 给被挑中的场次各想一个内容角度(一句话)。
约束:只基于我给的结果分析;不要补充我没提供的数据;不要给比分预测或任何操作建议。
下一步该看什么?
- 把多个自动任务串起来 → 7.13 自动化流水线与成本控制
- 系统怎么分层 → 7.11 自建系统架构
- 怎么验证整套框架 → 7.14 回测验证
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策