kbl-results

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

KBL Results

What this skill does

本Skill的功能

공식 KBL JSON 표면으로 특정 날짜의 한국프로농구 경기 일정/결과를 조회하고, 필요하면 특정 팀(예:

서울 SK

부산 KCC

, 팀 코드

)만 필터링한 뒤 현재 팀 순위까지 함께 정리한다.

通过官方KBL JSON接口查询指定日期的韩国职业篮球赛程/结果，若需要可仅筛选特定球队（例如：

首尔SK

、

釜山KCC

、球队代码

），并整理当前球队排名。

When to use

使用场景

"오늘 KBL 경기 결과 알려줘"
"2026-04-01 서울 SK 경기 결과 보여줘"
"KBL 현재 팀 순위 알려줘"

"告诉我今天的KBL比赛结果"
"展示2026-04-01首尔SK的比赛结果"
"告诉我当前KBL球队排名"

Prerequisites

前置条件

Node.js 18+
```
npm install -g kbl-results
```

Node.js 18+
```
npm install -g kbl-results
```

Inputs

输入参数

날짜:
```
YYYY-MM-DD
```
선택 사항: 팀명, 풀네임, 팀 코드

日期：
```
YYYY-MM-DD
```
可选：球队名称、全称、球队代码

Workflow

工作流程

0. Install the package globally when missing

0. 缺失时全局安装包

npm root -g

아래에

kbl-results

가 없으면 HTML scraping 으로 우회하지 말고 먼저 전역 Node 패키지 설치를 시도한다.

bash

npm install -g kbl-results

如果

npm root -g

下没有

kbl-results

，不要通过HTML抓取绕过，先尝试全局安装Node包。

bash

npm install -g kbl-results

1. Fetch the official KBL JSON

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
```

bash

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

官方KBL Web应用使用

https://api.kbl.or.kr

JSON API。因此在浏览器抓取前优先使用以下接口：

赛程/结果：
```
https://api.kbl.or.kr/match/list
```
球队排名：
```
https://api.kbl.or.kr/league/rank/team
```

bash

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. Normalize for humans

2. 整理为易读格式

원본 JSON을 그대로 던지지 말고 아래 기준으로 정리한다.

홈팀 vs 원정팀
경기 시간 / 종료 여부 / LIVE 여부
스코어
현재 순위
요청 팀이 있으면 해당 팀 경기만 필터링

不要直接返回原始JSON，按照以下标准整理：

主场队 vs 客场队
比赛时间 / 是否结束 / LIVE状态
比分
当前排名
若有指定球队则仅筛选该球队的比赛

3. Keep the answer compact

3. 保持回答简洁

요청이 scoreboard 면 경기별 한 줄 요약부터 준다. 특정 팀 요청이면 그 팀 경기와 현재 순위만 먼저 보여준다.

如果请求的是计分板，先提供每场比赛的一行摘要。如果是特定球队请求，先展示该球队的比赛及当前排名。

Done when

完成标准

날짜 기준 경기 요약이 있다
팀 요청이면 해당 팀 경기만 남아 있다
현재 순위가 같이 정리되어 있다

有按日期整理的比赛摘要
若为球队请求，仅保留该球队的比赛
已整理好当前排名

Failure modes

失败场景

KBL가
```
api.kbl.or.kr
```
응답 구조를 바꾸면 패키지 수정이 필요하다
경기 전 날짜면 결과 대신 예정 상태가 반환될 수 있다
크롤링 fallback은 공식 JSON이 막혔을 때만 검토한다

若KBL修改
```
api.kbl.or.kr
```
的响应结构，则需要修改包
比赛前的日期可能会返回预定状态而非结果
仅在官方JSON无法使用时考虑抓取降级方案

Notes

注意事项

이 스킬은 조회 전용이다
사용자의 "오늘/어제" 요청은 항상 절대 날짜(
```
YYYY-MM-DD
```
)로 변환해서 실행한다

자세한 사용 예시는

docs/features/kbl-results.md

와

packages/kbl-results/README.md

를 따른다

本Skill仅用于查询
用户的"今天/昨天"请求需始终转换为绝对日期(
```
YYYY-MM-DD
```
)后执行

详细使用示例请参考

docs/features/kbl-results.md

和

packages/kbl-results/README.md