FootyClaw: AI Quant Betting Agent

--- name: footyclaw description: > FootyClaw — 足球投注全流程助手。覆盖赛事信息抓取、足彩玩法规则、赔率获取（通过环境变量 ODDS_API_KEY 读取密钥）、基本面分析、EV期望值计算、Kelly公式仓位管理、最终下注方案推荐、 账本记账与资金曲线生成。 触发词：分析今晚比赛、查赔率、找投注机会、今天有什么场、EV分析、Kelly仓位、 下注推荐、记账、更新账本、出账本图表、足彩、亚盘、大小球、欧盘。 --- # ⚽ FootyClaw — 足球投注全流程 Skill ## 0. 快速开始 用户首次使用时询问： 1. **初始资金池金额**（本金） 2. **股东结构**（若多人合伙，记录各人出资比例） > **密钥安全规范**：API 密钥通过环境变量 `ODDS_API_KEY` 获取，由 Skill > 平台 secrets 机制自动注入。**不要在对话中询问、打印或以任何方式暴露用户的 > 明文密钥。** 若环境变量缺失，提示用户到 Skill 设置页面配置 `ODDS_API_KEY` >（免费注册：https://the-odds-api.com）。 --- ## 1. 标准分析流程 ### Step 1 — 读取资金池 从会话记忆中获取当前资金池余额（首次使用时由用户提供初始金额） ### Step 2 — 拉取赔率 python3 scripts/daily_scanner.py \ --bankroll <资金池> --min-ev 1.0 --hours-ahead 36 （脚本自动从环境变量 `ODDS_API_KEY` 读取密钥，无需手动传入） 扫描覆盖：英超/西甲/德甲/意甲/法甲/欧冠/欧联/欧协联 ### Step 3 — EV 计算（核心规则） 必须用 Pinnacle 公平概率 vs 其他 bookmaker 赔率： 1. 提取 Pinnacle 对同一市场的两个结果配对去 vig 2. 公平概率 fp = (1/o1) / (1/o1 + 1/o2) 3. EV% = fp×(odds-1) - (1-fp) 4. 绝不用 Pinnacle 对 Pinnacle 算 EV（会得到虚假 100%+） 5. 排除：matchbook/betfair_ex/williamhill/betonlineag EV 阈值：<1% 不投 | 1-3% 可投 | 3-5% 好机会 | >5% 需核实 ### Step 4 — 基本面核查 详见 references/fundamental-analysis.md： - xG/xGA 数据趋势 - 近期主客场分开统计 - 伤病/停赛情况 - 轮换风险（国际赛周/欧战密集期） - 赔率移动方向（跟随 sharp money） ### Step 5 — 仓位计算 Kelly = (fp×(odds-1) - (1-fp)) / (odds-1) 推荐注额 = Kelly × fraction × 资金池 - fraction 默认 1/4 Kelly，可按用户风险偏好调整 - 正 EV 机会不足时不强行凑负 EV 注 - 单注上限：资金池 20%（风控硬性上限） - 连续亏损 3 日：建议降低仓位直至盈利 ### Step 6 — 输出下注方案 企业微信不渲染 Markdown 表格，必须用纯文本格式： 📅 周X（MM-DD）｜总注 ¥X,000 🏴 主队 vs 客队 | HH:MM 投注项 @赔率 | EV +X.X% | ¥X,000 | 赢 +¥X,000 三天总注 ¥X,000 | 期望 +¥XXX | 全中 +¥X,000 --- ## 2. 盘口规则速查 亚盘让球： - X.0：赢全赢，平退款，输全输 - X.25：赢全赢，平=半输，输全输 - X.5：赢全赢，平/输全输（无退款） - X.75：赢1球=半赢，赢2球+=全赢，平/输全输 大小球 Under 方向： - U2.25：2球半赢，3球+全输 - U2.5：2球以下全赢，3球+全输 - U2.75：3球半赢，4球+全输 - U3.0：3球退款，4球+全输 Over 方向完全相反。 盈利计算： - 全赢：注额 × (赔率 - 1) - 半赢：注额 × (赔率 - 1) × 0.5 - BTTS/DNB：见 references/betting-rules.md --- ## 3. 账本记账（纯对话，零文件写入） 账本数据由大模型会话记忆维护，每次记账直接在对话框打印 Markdown 表格： | Day | 日期 | 注数 | 中/总 | 盈亏 | 期末资金 | 备注 | 用户可随时说"出账本"查看完整表格。 盈利计算规则： - 欧盘独赢盈利 = 注额 × (欧赔 - 1) - 亚盘盈利 = 注额 × HK赔率（HK赔率 = 欧赔 - 1） - 股东权益按出资比例分配 资金曲线图：`python3 scripts/chart_generator.py` 脚本从 stdin 读取账本 Markdown 表格，在内存中生成 SVG，输出 Base64 编码的 `<img>` 标签到 stdout，可直接嵌入对话框显示，不写任何本地文件。 --- ## 4. 联赛特性速查 英超 soccer_epl：~2.7球，平局率26%，主场优势弱 西甲 soccer_spain_la_liga：~2.5球，技术流，强队让球有价值 德甲 soccer_germany_bundesliga：~3.2球，高进球，大球多 意甲 soccer_italy_serie_a：~2.5球，防守为主，BTTS No多 法甲 soccer_france_ligue_one：~2.4球，PSG碾压，非PSG小球多 欧冠 soccer_uefa_champs_league：~2.9球，首回合保守 --- ## 5. 参考文件索引 - references/betting-rules.md — 完整盘口规则 - references/fundamental-analysis.md — 基本面分析框架 - scripts/daily_scanner.py — 全联赛 EV 扫描 - scripts/ev_calculator.py — EV + Kelly 计算 - scripts/fetch_odds.py — 单联赛赔率拉取 - scripts/chart_generator.py — 账本图表生成（stdin→Base64 img，零文件写入）