kleague-results

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

K League Results

What this skill does

功能说明

공식 K리그 JSON 표면으로 특정 날짜의 K리그1/K리그2 경기 결과를 조회하고, 필요하면 특정 팀(예:

FC서울

서울 이랜드

, 팀 코드

K09

)만 필터링한 뒤 현재 순위까지 함께 정리한다.

通过K联赛官方JSON接口查询特定日期的K联赛1/K联赛2的比赛结果，如有需要可筛选特定球队（例如：

FC首尔

、

首尔衣恋

、球队代码

K09

），同时整理输出当前排名。

When to use

适用场景

"오늘 K리그1 경기 결과 알려줘"
"2026-03-22 FC서울 경기 결과랑 현재 순위 보여줘"
"2026-03-22 K리그2 결과 정리해줘"

"告诉我今天K联赛1的比赛结果"
"给我看2026-03-22 FC首尔的比赛结果和当前排名"
"整理2026-03-22的K联赛2比赛结果"

Prerequisites

前置要求

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

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

Inputs

输入参数

날짜:
```
YYYY-MM-DD
```
리그:
```
K리그1
```
또는
```
K리그2
```
(기본값은
```
K리그1
```
)
선택 사항: 팀명, 풀네임, 팀 코드 (
```
서울
```
,
```
FC서울
```
,
```
K09
```
등)

日期:
```
YYYY-MM-DD
```
联赛:
```
K联赛1
```
或
```
K联赛2
```
（默认值为
```
K联赛1
```
）
可选参数：球队简称、全称、球队代码（例如
```
首尔
```
、
```
FC首尔
```
、
```
K09
```
等）

Workflow

工作流程

0. Install the package globally when missing

0. 缺失包时先全局安装

npm root -g

아래에

kleague-results

가 없으면 HTML scraping 으로 우회하지 말고 먼저 전역 Node 패키지 설치를 시도한다.

bash

npm install -g kleague-results

如果

npm root -g

路径下没有

kleague-results

，不要绕过安装直接爬取HTML，先尝试全局安装该Node包。

bash

npm install -g kleague-results

1. Fetch the official K League JSON

1. 获取K联赛官方JSON数据

이 스킬은 HTML 크롤링 대신 아래 공식 JSON 엔드포인트를 사용한다.

일정/결과:

https://www.kleague.com/getScheduleList.do

팀 순위:

https://www.kleague.com/record/teamRank.do

bash

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

此技能不使用HTML爬取，而是调用以下官方JSON接口。

赛程/结果:

https://www.kleague.com/getScheduleList.do

球队排名:

https://www.kleague.com/record/teamRank.do

bash

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

2. 数据人性化格式化

원본 JSON을 그대로 던지지 말고 아래 기준으로 정리한다.

홈팀 vs 원정팀
경기 시간 / 경기 종료 여부
스코어
현재 순위
요청 팀이 있으면 해당 팀 경기만 필터링

不要直接返回原始JSON，需按照以下规则整理：

主队 vs 客队
比赛时间 / 比赛是否结束
比分
当前排名
如果指定了查询球队，仅筛选该球队的比赛

3. Keep the answer compact

3. 保持回答简洁

요청이 scoreboard 면 경기별 한 줄 요약부터 준다. 특정 팀 요청이면 그 팀 경기와 현재 순위만 먼저 보여준다.

如果用户请求的是积分榜，优先按比赛单条摘要输出；如果指定了查询球队，优先展示该球队的比赛结果和当前排名。

Done when

完成标准

날짜 기준 경기 요약이 있다
팀 요청이면 해당 팀 경기만 남아 있다
현재 순위가 같이 정리되어 있다

已输出指定日期的比赛摘要
如果指定了球队，仅保留该球队的相关比赛
同时整理输出了当前排名

Failure modes

异常场景

K리그 사이트가
```
getScheduleList.do
```
또는
```
teamRank.do
```
응답 구조를 바꾸면 패키지 수정이 필요하다
경기 전 날짜면 결과 대신 예정 상태가 반환될 수 있다
```
서울
```
처럼 짧은 이름만 주면 리그에 따라
```
FC서울
```
/
```
서울 이랜드
```
구분이 필요할 수 있다

如果K联赛官网调整了
```
getScheduleList.do
```
或
```
teamRank.do
```
的响应结构，需要修改对应npm包
如果查询的是比赛还未举办的日期，会返回赛事预告状态而非比赛结果
如果仅提供
```
首尔
```
这类简称，需要根据联赛区分是
```
FC首尔
```
还是
```
首尔衣恋
```

Notes

注意事项

이 스킬은 조회 전용이다
사용자의 "오늘/어제" 요청은 항상 절대 날짜(
```
YYYY-MM-DD
```
)로 변환해서 실행한다
패키지를 새로 추가한 상태라면 머지 후 npm publish(Changesets 기반)를 진행해야 전역 설치 흐름이 살아난다

자세한 사용 예시는

docs/features/kleague-results.md

와

packages/kleague-results/README.md

를 따른다

此技能仅支持查询功能
用户提及的"今天/昨天"等相对日期，需先转换为
```
YYYY-MM-DD
```
格式的绝对日期再执行查询
如果是新增的包，合并代码后需要基于Changesets执行npm publish，全局安装流程才能正常运行

详细使用示例参考

docs/features/kleague-results.md

和

packages/kleague-results/README.md

文档