---
id: daily-kleague-results
name: "kleague-results"
url: https://skills.yangsir.net/skill/daily-kleague-results
author: nomadamas
domain: lifestyle
tags: ["sports", "k-league", "korea", "football"]
install_count: 2100
rating: 4.30 (7 reviews)
github: https://github.com/nomadamas/k-skill
---

# kleague-results

> 查询韩国 K 联赛特定日期的比赛结果，支持按球队过滤并显示当前联赛排名和积分情况

**Stats**: 2,100 installs · 4.3/5 (7 reviews)

## Before / After 对比

### 比赛结果查询

**Before**:

访问 K 联赛官网或体育新闻网站，查找特定日期的比赛结果，在多个页面间切换查看比分和排名，需要 5-10 分钟

**After**:

询问特定日期或球队的比赛结果，5 秒返回比分、进球球员、黄牌红牌等详细信息，并附带当前联赛排名

| Metric | Before | After | Change |
|---|---|---|---|
| 查询时间 | 450秒 | 5秒 | -99% |

## Readme

# kleague-results

# 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 scraping 으로 우회하지 말고 먼저 전역 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

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

## 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` 를 따른다

Weekly Installs728Repository[nomadamas/k-skill](https://github.com/nomadamas/k-skill)GitHub Stars3.0KFirst Seen14 days agoSecurity Audits[Gen Agent Trust HubWarn](/nomadamas/k-skill/kleague-results/security/agent-trust-hub)[SocketPass](/nomadamas/k-skill/kleague-results/security/socket)[SnykWarn](/nomadamas/k-skill/kleague-results/security/snyk)Installed oncodex724antigravity723opencode722github-copilot722kimi-cli722amp722

---
*Source: https://skills.yangsir.net/skill/daily-kleague-results*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-kleague-results/markdown*