kbl-results

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，請先嘗試安裝全域 Node 套件，不要直接使用 HTML 爬蟲繞過。

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