footyclaw

by botaocai

Install this Skill

curl -fsSL -o footyclaw.zip https://skill.seembox.com/api/v1/skills/footyclaw/download && unzip footyclaw.zip

SKILL.md About

---
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：
- 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，零文件写入）

_meta.json Metadata

{
  "ownerId": "kn70e9h8bpnpfc3r7jzsp8gq89838v5f",
  "publishedAt": 1773991609230,
  "slug": "footyclaw",
  "version": "1.0.4"
}