KBL Results

What this skill does

公式 KBL JSON エンドポイントを使用して、特定の日付の韓国プロバスケットボール(KBL)の試合スケジュール/結果を照会し、必要に応じて特定のチーム(例: Seoul SK、Busan KCC、チームコード 55)のみをフィルタリングした後、現在のチームランキングを一緒に整理します。

When to use

• "今日の KBL 試合結果を教えてください"
• "2026-04-01 のソウル SK の試合結果を見せてください"
• "KBL の現在のチームランキングを教えてください"

Prerequisites

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

Inputs

• 日付: YYYY-MM-DD
• オプション: チーム名、フルネーム、チームコード

Workflow

0. Install the package globally when missing

npm root -g の下に kbl-results がない場合は、HTML スクレイピングにフォールバックするのではなく、まずグローバルな Node パッケージのインストールを試みます。

npm install -g kbl-results

1. Fetch the official 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. Normalize for humans

元の JSON をそのまま返すのではなく、以下の基準で整理します。

• ホームチーム vs アウェイチーム
• 試合時刻 / 終了状況 / ライブ配信の有無
• スコア
• 現在のランキング
• リクエストされたチームがある場合は、そのチームの試合のみをフィルタリング

3. Keep the answer compact

リクエストがスコアボードの場合は、試合ごとの 1 行サマリーから提供します。特定のチームがリクエストされた場合は、そのチームの試合と現在のランキングのみを最初に表示します。

Done when

• 日付ベースの試合サマリーが存在する
• チームがリクエストされている場合は、そのチームの試合のみが残っている
• 現在のランキングが一緒に整理されている

Failure modes

• KBL が api.kbl.or.kr のレスポンス構造を変更した場合、パッケージの修正が必要です
• 試合前の日付の場合、結果の代わりに予定状況が返される可能性があります
• クローリングのフォールバックは、公式 JSON がブロックされている場合のみ検討します

Notes

• このスキルは照会専用です
• ユーザーの「今日/昨日」というリクエストは常に絶対日付(YYYY-MM-DD)に変換して実行してください
• 詳細な使用例は docs/features/kbl-results.md と packages/kbl-results/README.md に従ってください