# Match Scraper

> 从球探体育(titan007)抓取竞彩足球赛程数据。在用户说「抓取赛程」「获取今日比赛」「今天有什么比赛」或赛前分析流程启动时使用。

- Skill: `philipbo/match-scraper` (Agent Skill)
- Install (CLI): `npx skillmds@latest add philipbo/match-scraper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/philipbo/match-scraper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: philipbo (https://skillmd.com/u/philipbo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/philipbo/match-scraper

---


# 赛程抓取（match-scraper）

通过仓库内 `scripts/sporttery-sniper` 脚本抓取当日竞彩足球全量赛程数据。

## 前提条件

- `sporttery-sniper` 位于当前仓库的 `scripts/sporttery-sniper` 目录。
- `sporttery-sniper` 使用 titan007 的 XML/文本数据源。
- 脚本失败时直接报告失败原因，不改用其它抓取方式。
- **每次执行都必须实时运行脚本抓取最新数据**，不得复用之前抓取的旧数据。

## 销售窗口检查（定时任务触发时必须执行）

如果是 Cron 定时触发（非用户手动询问），先检查当前时间是否在竞彩销售窗口内（时间边界以 **AGENTS.md 六、可配置参数** 为准：`SCHEDULE_PUBLISH_TIME` ～ `SALES_CUTOFF_WEEKDAY` / `SALES_CUTOFF_WEEKEND`）：

- 周一至周五：11:00 ~ 22:00（默认）
- 周六、周日：11:00 ~ 23:00（默认）

**如果当前时间不在销售窗口内 → 直接终止，不抓取数据，不执行后续流程。** 向龙王发送一条简短通知：「当前不在竞彩销售时间内，跳过本次执行。」

用户手动询问（如"今天有什么比赛"）不受此限制，任何时间都可以查询。

## 执行步骤

### 步骤 1：检查脚本目录

确认 `scripts/sporttery-sniper/package.json` 存在。若不存在，直接报告「scripts/sporttery-sniper 不存在，无法同步赛程」，结束流程，不写 memory。

### 步骤 2：运行脚本同步赛程

销售日期使用当前自然日（`YYYY-MM-DD`）。手动查询非当天赛程时，将目标日期传给 `--date`。

```bash
cd scripts/sporttery-sniper
npm run schedule -- --date {YYYY-MM-DD} --format openclaw-json
```

脚本输出必须是 JSON，且 `kind` 必须为 `openclaw.schedule`。若脚本失败、JSON 无法解析、`kind` 不匹配，或 `matches` 字段缺失，直接报告失败原因，结束流程，不写 memory。

### 步骤 3：解析脚本输出

从 `openclaw.schedule` JSON 中读取：

| JSON 字段 | 写入 memory 字段 |
| --- | --- |
| `matches[].no` | 编号 |
| `matches[].matchId` | 比赛ID |
| `matches[].league` | 联赛 |
| `matches[].leagueLevel` | 联赛层级 |
| `matches[].kickoffTime` | 开球 |
| `matches[].status` | 状态 |
| `matches[].homeTeam` | 主队 |
| `matches[].score` | 比分 |
| `matches[].awayTeam` | 客队 |
| `matches[].analysisUrl` | 分析页 |

同时读取 `summary.total/notStarted/inProgress/finished` 作为汇总计数。若脚本输出中某些字段为空，用「无数据」或 `-` 标记，不要臆造。

### 步骤 4：格式化输出并写入 memory

按「结构化输出」和「写入每日记忆」章节格式生成赛程摘要，追加写入 `memory/{今天日期}.md`。

脚本输出中已按销售日过滤；若命令指定 `--date`，以该日期作为销售日。若 `matches.length = 0`，执行「当日无比赛」流程。

### 步骤 5：结构化输出

先输出日期汇总头，再按编号升序逐场列出：

```
⚽ **{星期X} {YYYY-MM-DD}** 共{N}场比赛

| 编号    | 对阵               | 开球             | 联赛   |
| ------- | ------------------ | ---------------- | ------ |
| {编号}  | [{主队} VS {客队}](https://zq.titan007.com/analysis/{matchId}cn.htm) | {开球 YYYY-MM-DD HH:MM} | {联赛} |
| ...     | ...                | ...              | ...    |
```

同时保存结构化数据供后续 skill 使用（每场一条）：

```
- 编号: {竞彩编号}
  比赛ID: {matchId}
  联赛: {联赛名称}
  联赛层级: {高/中/低/排除}
  开球: {YYYY-MM-DD HH:mm}
  状态: {未开场/进行中/已完场}
  主队: {主队名}
  比分: {比分或 - }
  客队: {客队名}
  分析页: https://zq.titan007.com/analysis/{matchId}cn.htm
```

**联赛层级预分类规则**（供 match-screening 阶段1 直接使用）：

- **高**：英超、西甲、德甲、意甲、法甲、欧冠、欧联杯、欧协联
- **中**：英冠、西乙、德乙、意乙、法乙、葡超、荷甲、比甲、土超、巴甲、阿甲、中超、日职联、韩K联、美职联、澳超
- **低**：北欧（瑞典超、挪超、丹超、芬超）、东欧（波兰甲、捷甲、罗甲）及其他未列出联赛
- **排除**：赛事名称含「友谊」「热身」「邀请」，或 U21/U23 青年赛事

**比赛 ID 是后续深度分析的关键**，用于直接拼接分析页 URL，无需再从列表页点击跳转。

### 步骤 6：写入每日记忆

**首次运行检查**：写入前确认 `memory/` 目录存在。如果不存在，先创建该目录。

将赛程摘要**追加**写入 `memory/{今天日期}.md`（不覆盖已有赛程 section，同一天可保留多段）。

**Section 标题**：使用 `## 赛程抓取（{执行时间 HH:MM}）`，例如 `## 赛程抓取（11:10）`、`## 赛程抓取（14:25）`。每次赛程同步在文件末尾追加上述 section。初筛、分析编号、编排流程以**当日 memory 中最后一个以 `## 赛程抓取` 开头的 section** 作为当前赛程列表。

格式：

```
## 赛程抓取（11:10）

⚽ {星期X} {YYYY-MM-DD} 共{N}场比赛

抓取时间：{当前时间}
- 未开场：{N} 场
- 进行中：{N} 场
- 已完场：{N} 场

### 赛程列表
{按编号升序的赛程数据}
```

## 查看其他日期赛程

如果需要查看非当天的赛程（如龙王说「看看昨天的比赛」，或复盘需要查历史赛程）：

1. 运行脚本：`cd scripts/sporttery-sniper && npm run schedule -- --date {目标日期} --format openclaw-json`
2. 解析 `openclaw.schedule` JSON 并按步骤 3～4 输出。

## 异常处理

- 脚本目录不存在：报告 `scripts/sporttery-sniper` 不存在，结束流程。
- 脚本执行失败：记录错误信息，重试 1 次；仍失败则结束流程，不写 memory。
- JSON 解析失败或 `kind` 不匹配：记录原始错误，结束流程，不写 memory。
- 部分数据缺失：正常记录已有数据，缺失字段标记为「无数据」。
- **当日无比赛**：如果抓取结果为 0 场比赛：
  1. 告知龙王「今日无竞彩足球赛事」
  2. 执行 recommendation（输入 0 场），按其标准结构写入当日 `## 推荐`（内容为「今日无竞彩赛事，无推荐」，但必须包含 ### 精选场次/候补场次/串关组合 这些块，表可为空），确保 post-review 解析一致
  3. 结束流程，不触发后续 skill

## 输出

将完整的结构化赛程列表返回，供后续 match-screening 使用。