K League Results

此技能功能

透過官方K聯賽JSON介面，查詢指定日期的K리그1/K리그2比賽結果，並可依特定球隊（例如：FC서울、서울 이랜드、球隊代碼 K09）篩選，同時整理當前排名。

使用時機

"告訴我今天K리그1的比賽結果"
"顯示2026-03-22 FC서울的比賽結果與當前排名"
"整理2026-03-22 K리그2的比賽結果"

前置需求

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

輸入參數

日期：YYYY-MM-DD
聯賽：K리그1 或 K리그2（預設為 K리그1）
選擇性：球隊名稱、全名、球隊代碼（例如 서울、FC서울、K09）

工作流程

0. 若缺少套件，先進行全域安裝

若 npm root -g 下沒有 kleague-results，請勿使用HTML爬蟲繞過，應先嘗試安裝全域Node套件。

npm install -g kleague-results

1. 取得官方K聯賽JSON資料

此技能使用以下官方JSON端點，而非HTML爬蟲。

賽程/結果：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. 整理為人類可讀格式

請勿直接輸出原始JSON，應依下列原則整理：

主隊 vs 客隊
比賽時間 / 比賽是否結束
比分
當前排名
若有指定球隊，僅顯示該球隊的比賽

3. 保持回答簡潔

若要求為計分板，先提供每場比賽的一行摘要。若指定球隊，則優先顯示該球隊的比賽與當前排名。

完成條件

提供指定日期的比賽摘要
若有指定球隊，僅顯示該球隊的比賽
同時整理當前排名

失敗情況

若K聯賽網站變更 getScheduleList.do 或 teamRank.do 的回應結構，則需更新套件
若查詢日期為比賽前，可能回傳「預定」狀態而非結果
若僅提供簡稱如 서울，可能需要根據聯賽區分 FC서울 / 서울 이랜드

備註

此技能僅供查詢使用
使用者要求「今天/昨天」時，一律轉換為絕對日期（YYYY-MM-DD）後執行
若剛新增套件，合併後需透過Changesets進行npm發佈，全域安裝流程才會生效
詳細使用範例請參閱 docs/features/kleague-results.md 與 packages/kleague-results/README.md

kleague-results

相關技能