SKILL.md
readonly只读
name
kbl-results
description
KBL韩国职业篮球比赛结果和当前球队排名，按日期/球队查询。使用官方JSON端点和kbl-results npm包。
KBL Results
本技能的功能
通过官方KBL JSON接口查询指定日期的韩国职业篮球比赛日程/结果，并可选择按特定球队（例如：서울 SK、부산 KCC、球队代码55）进行筛选，同时整理当前球队排名。
使用场景
- "告诉我今天的KBL比赛结果"
- "显示2026-04-01 서울 SK的比赛结果"
- "告诉我KBL当前球队排名"
前提条件
- Node.js 18+
npm install -g kbl-results
输入
- 日期：
YYYY-MM-DD - 可选：球队名称、全名、球队代码
工作流程
0. 全局安装缺失的包
如果npm root -g下没有kbl-results，不要使用HTML抓取作为替代，而是先尝试全局安装Node包。
npm install -g kbl-results
1. 获取官方KBL JSON
官方KBL网页应用使用https://api.kbl.or.kr JSON API。因此，在浏览器抓取之前，优先使用以下接口。
- 日程/结果：
https://api.kbl.or.kr/match/list - 球队排名：
https://api.kbl.or.kr/league/rank/team
GLOBAL_NPM_ROOT="$(npm root -g)" node --input-type=module - <<'JS'
import path from "node:path";
import { pathToFileURL } from "node:url";
const entry = pathToFileURL(
path.join(process.env.GLOBAL_NPM_ROOT, "kbl-results", "src", "index.js"),
).href;
const { getKBLSummary } = await import(entry);
const summary = await getKBLSummary("2026-04-01", {
team: "부산 KCC",
includeStandings: true,
});
console.log(JSON.stringify(summary, null, 2));
JS
2. 转换为人类可读格式
不要直接返回原始JSON，而是按以下标准整理：
- 主队 vs 客队
- 比赛时间 / 是否结束 / 是否直播
- 比分
- 当前排名
- 如果指定了球队，则只筛选该球队的比赛
3. 保持回答简洁
如果请求的是比分板，则先给出每场比赛的一行摘要。如果是特定球队的请求，则先显示该球队的比赛和当前排名。
完成条件
- 提供了基于日期的比赛摘要
- 如果指定了球队，则只保留该球队的比赛
- 当前排名已一并整理
失败模式
- 如果KBL更改了
api.kbl.or.kr的响应结构，则需要修改包 - 如果是比赛前的日期，可能返回预定状态而非结果
- 仅当官方JSON被屏蔽时，才考虑使用抓取作为后备方案
备注
- 本技能仅用于查询
- 用户的“今天/昨天”请求始终转换为绝对日期（
YYYY-MM-DD）后执行 - 详细使用示例请参考
docs/features/kbl-results.md和packages/kbl-results/README.md
