lck-analytics

LCK Results + Advanced Analysis

What this skill does

이 스킬은 LCK 조회/분석 전용이다.

• 특정 날짜 LCK 경기 결과 조회
• 특정 팀 alias 정규화 후 필터링
• 현재 스플릿 순위 조회
• 진행 중 경기 live stats 조회
• live timeline 기반 turning point 분석
• Oracle's Elixir 스타일 historical row / CSV 기반
  • 팀 파워 레이팅
  • 챔피언 matchup / synergy 분석
  • patch meta 요약
• 날짜별 match analysis 생성

Origin / attribution

이 스킬은 jerjangmin 님이 만든 원본 lck-analytics skill pack을 k-skill 저장소 안으로 옮기고, 이 저장소의 npm workspace / Changesets 배포 방식에 맞게 정리한 버전이다.

When to use

• "오늘 LCK 경기 결과 알려줘"
• "2026-04-01 한화 경기 결과랑 순위 보여줘"
• "지금 T1 경기 킬/골드/오브젝트 요약해줘"
• "이 경기 turning point가 뭐였어?"
• "이 밴픽에서 어느 쪽 조합이 더 좋았는지 설명해줘"
• "현재 패치에서 어떤 챔피언이 메타 픽인지 보여줘"
• "LCK 팀 파워 레이팅 보여줘"

Prerequisites

• Node.js 18+
• npm install -g lck-analytics

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

npm install -g lck-analytics

Inputs

기본 입력

• 날짜: YYYY-MM-DD
• 선택 사항: 팀명, 과거 팀명, 한글/영문 약칭 alias

고급 분석 입력

• Oracle's Elixir 스타일 CSV 문자열 또는 row 배열
• game id / match id
• live window/details payload 또는 실시간 fetch 권한
• patch version

Team alias normalization

다음 이름들은 같은 canonical team 으로 인식한다.

• DN SOOPers
• DN FREECS
• 광동 프릭스
• Afreeca Freecs

추가로 T1, SKT T1, 담원, Dplus KIA, 브리온, 한화, 젠지, 피어엑스 등도 alias 정규화를 지원한다.

Official surfaces

이 스킬은 Riot 공식 / 공식 웹앱 표면을 우선 사용한다.

• 일정/결과: getSchedule
• 토너먼트 목록: getTournamentsForLeague
• 순위: getStandings
• 이벤트 상세: getEventDetails
• 라이브 window: https://feed.lolesports.com/livestats/v1/window/{gameId}
• 라이브 details: https://feed.lolesports.com/livestats/v1/details/{gameId}

historical 고급 분석은 Oracle's Elixir 스타일 데이터 입력을 사용한다.

Workflow

Included lightweight local pipeline

이 k-skill 팩에는 경량 로컬 파일 기반 파이프라인 스크립트가 포함된다.

• scripts/sync-oracle.js: Oracle-style CSV → historical cache JSON
• scripts/build-match-report.js: 날짜별 match analysis 생성
• scripts/analyze-live-game.js: game analysis 생성
• 기본 cache 위치: .openclaw-lck-cache/

1. Basic scoreboard / standings query

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

const summary = await getLckSummary("2026-04-01", {
  team: "한화",
  includeStandings: true,
});

console.log(JSON.stringify(summary, null, 2));
JS

2. Historical analytics from Oracle-style CSV

직접 API를 호출해도 되지만, local skill pipeline에서는 아래 스크립트 사용을 우선 권장한다.

node ./lck-analytics/scripts/sync-oracle.js \
  --csv ./lck-analytics/samples/oracle-lck-sample.csv

3. Match analysis via local pipeline script

node ./lck-analytics/scripts/build-match-report.js \
  --date 2026-04-01

필요하면 팀 필터도 같이 준다.

node ./lck-analytics/scripts/build-match-report.js \
  --date 2026-04-01 \
  --team 한화

4. Game analysis with turning points via local pipeline script

node ./lck-analytics/scripts/analyze-live-game.js \
  --game game-id

fixture 기반으로 분석할 때는 --window, --details 를 같이 줄 수 있다.

Output guidelines

사용자에게는 원본 JSON을 길게 그대로 던지지 말고 먼저 아래 순서로 정리한다.

경기 결과 요청

• 경기 시각
• 팀1 vs 팀2
• 상태
• 세트 스코어
• 요청 팀 경기만 있으면 해당 경기 우선
• standings 요청이 있으면 현재 순위 같이 표시

진행 중 경기 요청

• 현재 게임 번호
• 킬 차이
• 골드 차이
• 드래곤/바론/타워 차이
• turning point 1~3개

historical / meta 요청

• sample 수를 먼저 표시
• 팀 파워 레이팅은 상위 팀부터 정렬
• champion matchup / synergy는 표본 수가 적으면 낮은 확신도로 표시
• patch meta는 top picks / risers 위주로 짧게 요약

Done when

• 날짜 기준 경기 요약이 있다
• 요청 팀 필터가 적용된다
• standings 요청이면 현재 순위가 같이 정리된다
• live 요청이면 현재 게임 요약과 turning point가 있다
• historical 입력이 있으면 patch meta 또는 power rating까지 설명할 수 있다

Failure modes

• Riot 웹앱 API 구조/헤더가 바뀌면 패키지 수정이 필요할 수 있다
• LOLESPORTS_API_KEY public fallback이 회전되면 환경변수 override가 필요할 수 있다
• historical CSV 컬럼명이 너무 다르면 Oracle-style 정규화 전에 전처리가 필요할 수 있다

Notes

• 이 스킬은 조회/분석 전용이다
• 사용자의 "오늘/어제" 요청은 항상 절대 날짜(YYYY-MM-DD)로 변환해서 실행한다
• 이 저장소에서 main 으로 머지되면 Changesets가 Version Packages PR을 만들고, 그 PR이 merge된 뒤 npm publish가 실행된다