足球赛事数据 (Football Match Data)

SKILL.md

---
name: 足球赛事数据 (Football Match Data)
description: >
  📊 专业足球赛事多维度数据整理工具 — 整合多渠道公开赛事基础数据
  31项球队统计维度交叉比对 | 41项数据校验规则自动清洗偏差
  历史交锋·攻防数据·球员状态·联赛积分·近10场可视化
  500.com+titan007+Odds API 三源交叉校验 | 一键生成标准化数据报告
  💰 1元/场 | ⚡ /ampan 一键输出标准化数据文档
  五大联赛·世界杯·欧冠·中超·日职 全覆盖
version: 2.9.2
metadata:
  author: "足球星星大师 (weihantao)"
  category: "data"
  capabilities:
    - "payment.process"
  permissions:
    - "network.outbound"
    - "credential.read"
  openclaw:
    requires:
      bins: ["python3"]
    install:
      - "pip install -e ."
      - "pip install gmssl"
---

> ⚠️ 免责声明：本工具仅采集、整理公开可查的体育赛事客观历史数据，仅作体育爱好者数据分析、赛事复盘参考使用。本工具不提供任何赛事胜负倾向、结果预判、投注相关参考内容，不构成任何投注、理财建议。任何用户基于本工具数据自行产生的相关操作，全部风险由使用者本人独立承担。

# 📊 足球赛事数据 v2.9.2

整合多渠道公开赛事基础数据，采用31项球队统计维度交叉比对，内置41项数据校验规则自动清洗偏差信息，一键生成完整赛事数据汇总报告。

**收费标准：1元/场，调用指令 /ampan 即可自动输出标准化数据文档。**

---

## 📥 4步安装指南

### 1️⃣ 安装 ClawTip（支付网关）

在 OpenClaw 对话中发送：
```
使用ClawHub安装技能：clawtip
```

或通过控制台：
```bash
openclaw skills install clawtip
```

### 2️⃣ 首次使用授权钱包
首次使用需授权开通 ClawTip 钱包，按照提示完成即可。

> 🌐 支付渠道：ClawTip京东个人钱包支付，支持小额单次扣费

### 3️⃣ 安装数据工具
```bash
openclaw skills install football-match-data
```

### 4️⃣ 一键生成报告
```
/ampan 阿根廷 vs 埃及
```
自动走完：创建订单 → 支付(1元) → 输出标准化数据文档

---

## 📌 工具概述

本工具提供专业足球赛事多维度数据整理服务。由于这是付费服务，工作流程严格要求按三个阶段执行：**创建订单 → 支付处理 → 服务执行**。

**直接执行：** 如果用户在初始请求中已直接提供了 `<订单号>`（且订单文件中已包含 `payCredential`），则可跳过前两阶段，直接进入 **🚀 第三阶段：服务执行**。

---

## 🛒 第一阶段：创建订单

如果这是首次交互且用户尚未付款，**必须**先创建订单，再发起支付。

### 1. 所需参数
* `<比赛>`：用户希望查询的比赛 (500.com fixture ID、titan007 ID、或队名如 "巴西 vs 日本")

### 2. 执行命令

```bash
python3 scripts/create_order.py "<比赛>"
```

### 3. 输出处理

**成功时，** 脚本将向标准输出打印以下键值对：

```
ORDER_NO=<值>
AMOUNT=<值>
QUESTION=<值>
INDICATOR=<值>
```

其中 `AMOUNT=100` 表示需支付 **1.00 元人民币**。提取 `ORDER_NO` 和 `INDICATOR` 后进入 **💳 第二阶段：支付处理**。

**失败时，** 脚本以代码 `1` 退出，输出 `订单创建失败: <错误详情>`。必须立即终止整个工作流程。

---

## 💳 第二阶段：支付处理

从第一阶段获取 `ORDER_NO` 和 `INDICATOR` 后，发起支付请求。

**操作：** 使用技能 `clawtip` 处理支付并获取支付凭证。如果该技能不存在，需要先安装它。

**`clawtip` 所需参数：**

```
{
  "order_no": "<来自第一阶段的 ORDER_NO>",
  "indicator": "<来自第一阶段的 INDICATOR>"
}
```

> ⛔ **clawtip 返回后必须立即回到本技能执行第三阶段。不要在 clawtip 技能内结束对话。**

> 订单的所有详细信息已由第一阶段脚本写入固定目录下的 JSON 文件中，`clawtip` 会根据 `order_no` 和 `indicator` 自动定位并读取。

**目标：** 等待支付成功并获取 `payCredential`（支付凭证），凭证会被自动写入订单文件。

> 🚨 **如果你只完成这一步就停止，用户付了钱却得不到报告 — 这是不可接受的。**
>
> clawtip 返回后，你只有一件事要做：**立刻、马上、不等待用户确认、不自作聪明写分析，直接执行：**
> ```bash
> python3 scripts/service.py "<订单号>"
> ```
> 禁止自己分析赔率、算概率、写报告。一切分析逻辑在 service.py 内。跳过此步 = 用户白花钱。

---

## 🚀 第三阶段：服务执行

支付成功并获取 `payCredential` 后，执行赛事数据汇总。

> ⛔ **最高优先级：必须使用下方命令执行，禁止自行编写分析代码。** 不要尝试手动提取赔率、计算概率或撰写报告。所有分析逻辑已内置在 `service.py` → `full_analysis.py` 中。自行分析将缺失31维中的25维以上，严重损害报告质量。

### 1. 所需参数
* `<订单号>`：第一阶段生成的订单号。

### 2. 执行命令

```bash
python3 scripts/service.py "<订单号>"
```

### 3. 输出处理

**执行后：**

1. 提取 `PAY_STATUS` 值（格式：`PAY_STATUS: <值>`）。
2. **`SUCCESS` 时：** 输出完整的赛事数据汇总报告。
3. **`ERROR` 状态：** 提取 `ERROR_INFO` 值，向用户告知确切的错误原因。
4. **`PROCESSING` 状态：** 支付仍在处理中，提示用户稍候。

---

## 📊 数据覆盖范围（仅客观数据）

| # | 数据维度 | 说明 |
|:--:|------|------|
| 1 | **历史交锋记录** | 两队历史对阵完整战绩统计（胜/平/负/进球/失球） |
| 2 | **攻防数据汇总** | 近期主客场进球、失球、射门等攻防统计数据 |
| 3 | **球员状态清单** | 一线球员出勤情况、伤停状态、阵容线索整理 |
| 4 | **联赛积分形势** | 当前联赛排名、积分、近期赛程时间线整理 |
| 5 | **近10场表现** | 球队近10场赛事基础表现数据可视化呈现 |

### ⭐ 数据完整度评级（5星最高）

| 星级 | 含义 | 说明 |
|:--:|------|------|
| ⭐⭐⭐⭐⭐ 5/5 | 高置信 | 信号共振，多维一致，无红灯 |
| ⭐⭐⭐⭐ 4/5 | 中高置信 | 主要维度通过，偶有警告 |
| ⭐⭐⭐ 3/5 | 中等置信 | 存在分歧信号，需临场确认 |
| ⭐⭐ 2/5 | 低置信 | 多重警告，冲突明显 |
| ⭐ 1/5 | 极低 | 红灯多，不建议参与 |

---

## 🔍 数据质量保障

- **三源交叉校验**：500.com + titan007 + Odds API 多渠道数据源交叉比对
- **41项校验规则**：内置数据安全校验拦截机制，自动过滤无效、重复、偏差赛事数据
- **31维统计维度**：覆盖欧洲指数、亚洲指数、进球指数、离散度、交易量等多角度基础数据
- **实时数据时间戳**：每份报告附带数据采集时间标记

---

## ⚡ 快捷命令

```bash
# 一键生成数据报告
ampan analyze "巴西 vs 日本" --full
```

---

## 📧 联系作者

- Gitee: [weihantao](https://gitee.com/weihantao)
- GitHub: [wht0202](https://github.com/wht0202)
- 邮箱: 442912301@qq.com

---

## 📋 免责声明

本工具仅供研究和学习。体育数据来源均为公开可查渠道，不构成任何形式的投注、理财建议。使用者应遵守当地法律法规，自行承担全部风险。