kleague-results

K League Results

技能功能

通过官方K联赛JSON接口，查询指定日期的K1联赛/K2联赛比赛结果，并可选择按球队（例如：FC서울、서울 이랜드、球队代码K09）筛选，同时整理当前排名。

使用场景

• "告诉我今天K1联赛的比赛结果"
• "显示2026-03-22 FC서울的比赛结果和当前排名"
• "整理2026-03-22 K2联赛的结果"

前提条件

• 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）执行
• 如果新增了包，合并后需通过npm publish（基于Changesets）才能使全局安装流程生效
• 详细使用示例请参考 docs/features/kleague-results.md 和 packages/kleague-results/README.md