⚽ FootyClaw — 足球投注全流程 Skill

---

secrets:

- name: ODDS_API_KEY

description: "用户自行申请的 The-Odds-API 免费密钥"

permissions:

network:

- host: "api.the-odds-api.com"

ports: [443]

reason: "拉取实时赔率数据（The Odds API v4）"

---

---

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：

Step 5 — 仓位计算

Kelly = (fp×(odds-1) - (1-fp)) / (odds-1)

推荐注额 = Kelly × fraction × 资金池

Step 6 — 输出下注方案

企业微信不渲染 Markdown 表格，必须用纯文本格式：

📅 周X（MM-DD）｜总注 ¥X,000

🏴 主队 vs 客队 | HH:MM

投注项 @赔率 | EV +X.X% | ¥X,000 | 赢 +¥X,000

三天总注 ¥X,000 | 期望 +¥XXX | 全中 +¥X,000

---

2. 盘口规则速查

亚盘让球：

大小球 Under 方向：

Over 方向完全相反。

盈利计算：

---

3. 账本记账（纯对话，零文件写入）

账本数据由大模型会话记忆维护，每次记账直接在对话框打印 Markdown 表格：

| Day | 日期 | 注数 | 中/总 | 盈亏 | 期末资金 | 备注 |

用户可随时说"出账本"查看完整表格。

盈利计算规则：

资金曲线图：`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. 参考文件索引