korea-weather

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Korea Weather

韩国天气

What this skill does

该技能的功能

기상청 단기예보 조회서비스를

k-skill-proxy

경유로 조회해서 한국 날씨를 요약한다. 사용자는 개인 OpenAPI key를 직접 발급할 필요가 없고, proxy 서버에만

KMA_OPEN_API_KEY

를 둔다.

通过

k-skill-proxy

代理访问韩国气象厅短期预报查询服务，汇总韩国天气信息。用户无需自行申请个人OpenAPI密钥，仅需在代理服务器上配置

KMA_OPEN_API_KEY

即可。

When to use

使用场景

"서울 시청 근처 지금 날씨 어때?"
"부산 날씨 알려줘"
"위도/경도 기준으로 한국 단기예보 보고 싶어"

"首尔市厅附近现在天气怎么样？"
"告诉我釜山的天气"
"想查看基于经纬度的韩国短期预报"

Prerequisites

前置条件

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

可选：
```
jq
```
已完成自托管或部署验证的
```
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 서버에서만 관리한다.

```
KSKILL_PROXY_BASE_URL
```
（必填：已完成自托管或部署验证的代理基础URL）

用户无需自行处理公共数据门户气象厅的API密钥，只需将实际部署了

/v1/korea-weather/forecast

路由的代理URL配置为

KSKILL_PROXY_BASE_URL

即可。上游

KMA_OPEN_API_KEY

仅在代理服务器端管理。

Inputs

输入参数

격자 좌표:
```
nx
```
,
```
ny
```
또는 위도/경도:
```
lat
```
,
```
lon
```
선택 사항:
```
baseDate
```
,
```
baseTime
```

baseDate

baseTime

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

网格坐标：
```
nx
```
、
```
ny
```
或经纬度：
```
lat
```
、
```
lon
```
可选参数：
```
baseDate
```
、
```
baseTime
```

如果省略

baseDate

baseTime

，代理会自动选择以韩国标准时间(KST)为准的最新短期预报发布时间。

Workflow

工作流程

1. Resolve the proxy base URL

1. 确认代理基础URL

KSKILL_PROXY_BASE_URL

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

通过

KSKILL_PROXY_BASE_URL

确认已完成自托管或部署验证的代理基础URL。

2. Query the short-term forecast endpoint

2. 请求短期预报接口

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

bash

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

격자 좌표 예시:

bash

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'

如果已有网格坐标则直接传入，若只有经纬度则直接传给代理即可。

bash

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

网格坐标示例:

bash

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

3. 稳妥汇总响应结果

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

```
TMP
```
: 기온
```
SKY
```
: 하늘상태
```
PTY
```
: 강수형태
```
POP
```
: 강수확률
```
PCP
```
: 강수량
```
SNO
```
: 적설
```
REH
```
: 습도
```
WSD
```
: 풍속

응답에는 조회 시점과

baseDate

baseTime

도 함께 적는다.

尽可能优先汇总以下字段：

```
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 장애
선택한 발표 시각에 아직 예보가 준비되지 않은 경우

```
KSKILL_PROXY_BASE_URL
```
为空或天气路由尚未部署
```
nx
```
/
```
ny
```
或
```
lat
```
/
```
lon
```
参数不完整
气象厅配额超限或上游服务故障
所选发布时间的预报尚未准备完毕

Notes

注意事项

공식 API는
```
nx
```
/
```
ny
```
격자를 쓰지만, proxy 는
```
lat
```
/
```
lon
```
도 받아 내부에서 격자로 변환한다.
단기예보 category 는
```
TMP
```
,
```
SKY
```
,
```
PTY
```
,
```
POP
```
,
```
PCP
```
,
```
SNO
```
,
```
REH
```
,
```
WSD
```
등을 중심으로 본다.
proxy 운영/환경변수 설정은
```
docs/features/k-skill-proxy.md
```
를 참고한다.

官方API使用
```
nx
```
/
```
ny
```
网格坐标，但代理也支持接收
```
lat
```
/
```
lon
```
，内部会自动转换为网格坐标。
短期预报分类重点关注
```
TMP
```
、
```
SKY
```
、
```
PTY
```
、
```
POP
```
、
```
PCP
```
、
```
SNO
```
、
```
REH
```
、
```
WSD
```
等字段。
代理运营/环境变量配置请参考
```
docs/features/k-skill-proxy.md
```
。