---
id: daily-korea-weather
name: "korea-weather"
url: https://skills.yangsir.net/skill/daily-korea-weather
author: nomadamas
domain: lifestyle
tags: ["weather", "korea", "api-integration", "forecast", "kma"]
install_count: 1900
rating: 4.30 (9 reviews)
github: https://github.com/nomadamas/k-skill
---

# korea-weather

> 通过代理服务查询韩国气象厅天气预报，获取地区天气信息无需个人API密钥

**Stats**: 1,900 installs · 4.3/5 (9 reviews)

## Before / After 对比

### 天气信息获取效率

**Before**:

需要申请KMA OpenAPI密钥，阅读API文档，编写请求代码，处理认证和数据解析，实现需要数小时

**After**:

直接询问天气即可获得韩国气象厅的准确预报，无需配置API密钥或编写代码，5秒获得结果

| Metric | Before | After | Change |
|---|---|---|---|
| 实现时间 | 180分钟 | 0分钟 | -100% |

## Readme

# korea-weather

# Korea Weather

## What this skill does

기상청 단기예보 조회서비스를 `k-skill-proxy` 경유로 조회해서 한국 날씨를 요약한다.
사용자는 개인 OpenAPI key를 직접 발급할 필요가 없고, proxy 서버에만 `KMA_OPEN_API_KEY` 를 둔다.

## When to use

- "서울 시청 근처 지금 날씨 어때?"

- "부산 날씨 알려줘"

- "위도/경도 기준으로 한국 단기예보 보고 싶어"

## Prerequisites

- optional: `jq`

- self-host 또는 배포 확인이 끝난 `KSKILL_PROXY_BASE_URL`

## Required environment variables

- `KSKILL_PROXY_BASE_URL` (필수: self-host 또는 배포 확인이 끝난 proxy base URL)

사용자가 공공데이터포털 기상청 API key를 직접 다룰 필요는 없다. 대신 `/v1/korea-weather/forecast` route가 실제로 올라와 있는 proxy URL 을 `KSKILL_PROXY_BASE_URL` 로 받는다. upstream `KMA_OPEN_API_KEY` 는 proxy 서버에서만 관리한다.

## Inputs

- 격자 좌표: `nx`, `ny`

- 또는 위도/경도: `lat`, `lon`

- 선택 사항: `baseDate`, `baseTime`

`baseDate` / `baseTime` 을 생략하면 proxy 가 KST 기준 최신 단기예보 발표 시각을 자동으로 고른다.

## Workflow

### 1. Resolve the proxy base URL

`KSKILL_PROXY_BASE_URL` 로 self-host 또는 배포 확인이 끝난 proxy base URL 을 확인한다.

### 2. Query the short-term forecast endpoint

격자 좌표가 이미 있으면 그대로 넣고, 위도/경도만 있으면 proxy 에 그대로 넘긴다.

```
curl -fsS --get 'https://your-proxy.example.com/v1/korea-weather/forecast' \
  --data-urlencode 'lat=37.5665' \
  --data-urlencode 'lon=126.9780'

```

격자 좌표 예시:

```
curl -fsS --get 'https://your-proxy.example.com/v1/korea-weather/forecast' \
  --data-urlencode 'nx=60' \
  --data-urlencode 'ny=127' \
  --data-urlencode 'baseDate=20260405' \
  --data-urlencode 'baseTime=0500'

```

### 3. Summarize the response conservatively

가능하면 아래 항목만 먼저 요약한다.

- `TMP`: 기온

- `SKY`: 하늘상태

- `PTY`: 강수형태

- `POP`: 강수확률

- `PCP`: 강수량

- `SNO`: 적설

- `REH`: 습도

- `WSD`: 풍속

응답에는 조회 시점과 `baseDate` / `baseTime` 도 함께 적는다.

## Done when

- 요청 위치의 단기예보 응답이 정리되어 있다

- 조회 시점과 예보 발표 시각이 명시되어 있다

- upstream key가 클라이언트에 노출되지 않았다

## Failure modes

- `KSKILL_PROXY_BASE_URL` 이 비어 있거나 weather route가 아직 배포되지 않은 경우

- `nx` / `ny` 또는 `lat` / `lon` 이 불완전한 경우

- 기상청 quota 초과 또는 upstream 장애

- 선택한 발표 시각에 아직 예보가 준비되지 않은 경우

## Notes

- 공식 API는 `nx` / `ny` 격자를 쓰지만, proxy 는 `lat` / `lon` 도 받아 내부에서 격자로 변환한다.

- 단기예보 category 는 `TMP`, `SKY`, `PTY`, `POP`, `PCP`, `SNO`, `REH`, `WSD` 등을 중심으로 본다.

- proxy 운영/환경변수 설정은 `docs/features/k-skill-proxy.md` 를 참고한다.

Weekly Installs455Repository[nomadamas/k-skill](https://github.com/nomadamas/k-skill)GitHub Stars3.0KFirst Seen5 days agoSecurity Audits[Gen Agent Trust HubPass](/nomadamas/k-skill/korea-weather/security/agent-trust-hub)[SocketWarn](/nomadamas/k-skill/korea-weather/security/socket)[SnykPass](/nomadamas/k-skill/korea-weather/security/snyk)Installed oncodex451antigravity450opencode449github-copilot449kimi-cli449amp449

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