| name | match-scraper |
| description | 从球探体育(titan007)抓取竞彩足球赛程数据。在用户说「抓取赛程」「获取今日比赛」「今天有什么比赛」或赛前分析流程启动时使用。 |
| metadata | {"openclaw":{"emoji":"📆"}} |
赛程抓取（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。
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} 场
### 赛程列表
{按编号升序的赛程数据}
查看其他日期赛程
如果需要查看非当天的赛程（如龙王说「看看昨天的比赛」，或复盘需要查历史赛程）：
- 运行脚本：
cd scripts/sporttery-sniper && npm run schedule -- --date {目标日期} --format openclaw-json
- 解析
openclaw.schedule JSON 并按步骤 3～4 输出。
异常处理
- 脚本目录不存在：报告
scripts/sporttery-sniper 不存在，结束流程。
- 脚本执行失败：记录错误信息，重试 1 次；仍失败则结束流程，不写 memory。
- JSON 解析失败或
kind 不匹配：记录原始错误，结束流程，不写 memory。
- 部分数据缺失：正常记录已有数据，缺失字段标记为「无数据」。
- 当日无比赛：如果抓取结果为 0 场比赛：
- 告知龙王「今日无竞彩足球赛事」
- 执行 recommendation（输入 0 场），按其标准结构写入当日
## 推荐（内容为「今日无竞彩赛事，无推荐」，但必须包含 ### 精选场次/候补场次/串关组合 这些块，表可为空），确保 post-review 解析一致
- 结束流程，不触发后续 skill
输出
将完整的结构化赛程列表返回，供后续 match-screening 使用。
