K League Results

What this skill does

公式 K リーグ JSON エンドポイントで特定日時の K リーグ1/K リーグ2 の試合結果を照会し、必要に応じて特定チーム（例：FC ソウル、ソウル イーランド、チームコード K09）のみでフィルタリングした後、現在の順位を合わせて整理する。

When to use

• 「今日の K リーグ1 の試合結果を教えて」
• 「2026-03-22 FC ソウルの試合結果と現在の順位を見せて」
• 「2026-03-22 K リーグ2 の結果を整理してくれ」

Prerequisites

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

Inputs

• 日付：YYYY-MM-DD
• リーグ：K리그1 または K리그2（デフォルトは K리그1）
• 選択肢：チーム名、フルネーム、チームコード（서울、FC서울、K09 など）

Workflow

0. Install the package globally when missing

npm root -g 以下に kleague-results がない場合は、HTML スクレイピングで迂回せず、まず全体 Node パッケージをインストールしようとする。

npm install -g kleague-results

1. Fetch the official K League JSON

このスキルは HTML クローリングの代わりに、以下の公式 JSON エンドポイントを使用する。

• スケジュール/結果：https://www.kleague.com/getScheduleList.do
• チーム順位：https://www.kleague.com/record/teamRank.do

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, "kleague-results", "src", "index.js"),
).href;
const { getKLeagueSummary } = await import(entry);

const summary = await getKLeagueSummary("2026-03-22", {
  leagueId: "K리그1",
  team: "FC서울",
  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

• K リーグサイトが getScheduleList.do または teamRank.do のレスポンス構造を変更した場合、パッケージの修正が必要
• 試合前の日付の場合、結果の代わりに予定ステータスが返される可能性がある
• 서울 のように短い名前のみが与えられた場合、リーグに応じて FC서울 / 서울 이랜드 の区別が必要な場合がある

Notes

• このスキルは照会のみである
• ユーザーの「今日/昨日」リクエストは常に絶対日付（YYYY-MM-DD）に変換して実行する
• パッケージを新たに追加した状態の場合、マージ後に npm publish（Changesets ベース）を実施する必要があり、その後、全体インストールフローが機能する
• 詳細な使用例は docs/features/kleague-results.md と packages/kleague-results/README.md に従う