Korea Weather
Summarize Korean short-term weather for a lat/lon or KMA grid point without issuing your own 기상청 OpenAPI key.
Overview
Korea Weather is an agent skill for the Build phase that summarizes Korean 단기예보 via the k-skill-proxy without users managing a personal KMA OpenAPI key.
Install
npx skills add https://github.com/nomadamas/k-skill --skill korea-weatherWhat is this skill?
- Queries 기상청 단기예보 via default hosted `k-skill-proxy.nomadamas.org` or a self-hosted base URL
- Accepts `nx`/`ny` grid coords or `lat`/`lon`; optional `baseDate`/`baseTime` with KST auto-selection when omitted
- No per-user `KMA_OPEN_API_KEY`—upstream key stays on the proxy server only
- Documented `curl` workflow with optional `jq` for parsing responses
- Default hosted proxy base: https://k-skill-proxy.nomadamas.org
- Forecast route: /v1/korea-weather/forecast
Adoption & trust: 2.3k installs on skills.sh; 5.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want accurate Korean forecast data in chat or agents but do not want every developer to register and rotate 기상청 API credentials.
Who is it for?
Korea-locale agents, field ops assistants, and builders prototyping location-aware features who already use the k-skill proxy stack.
Skip if: Global multi-country weather products, offline-only apps, or teams that require direct unproxied KMA integration and full raw payload control without a proxy.
When should I use this skill?
User asks for Korean location weather, grid or lat/lon 단기예보, or phrases like 서울/부산 날씨.
What do I get? / Deliverables
The agent returns a concise weather summary for the requested coordinates using the proxy-managed upstream key and documented forecast endpoint.
- Human-readable Korean weather summary for the requested location
- Structured forecast data from the proxy response when parsed
Recommended Skills
Journey fit
Canonical shelf is Build because the skill wires an agent to an external forecast API through a hosted proxy, not because weather is only relevant while coding. Integrations fits proxy-backed HTTP calls to `/v1/korea-weather/forecast` and optional `KSKILL_PROXY_BASE_URL` overrides.
How it compares
Use this hosted-proxy skill instead of hand-rolling 기상청 auth and grid conversion in every agent session.
Common Questions / FAQ
Who is korea-weather for?
Solo and indie builders running Claude Code, Cursor, or Codex who need Korean short-term forecasts inside agent workflows without distributing OpenAPI keys.
When should I use korea-weather?
Use it during Build integrations when users ask for Seoul, Busan, or lat/lon-based domestic forecasts, or when you are wiring Korea-specific context into ops or product demos.
Is korea-weather safe to install?
Forecast traffic goes to your configured or default proxy over the network; review the Security Audits panel on this page before trusting hosted third-party infrastructure.
SKILL.md
READMESKILL.md - Korea Weather
# Korea Weather ## What this skill does 기상청 단기예보 조회서비스를 `k-skill-proxy` 경유로 조회해서 한국 날씨를 요약한다. 사용자는 개인 OpenAPI key를 직접 발급할 필요가 없고, proxy 서버에만 `KMA_OPEN_API_KEY` 를 둔다. ## When to use - "서울 시청 근처 지금 날씨 어때?" - "부산 날씨 알려줘" - "위도/경도 기준으로 한국 단기예보 보고 싶어" ## Prerequisites - optional: `jq` - optional: `KSKILL_PROXY_BASE_URL` (self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted `https://k-skill-proxy.nomadamas.org` 를 사용한다.) ## Required environment variables - 없음. `KSKILL_PROXY_BASE_URL` 은 선택 사항이며, 비우면 기본 hosted `https://k-skill-proxy.nomadamas.org` 를 사용한다. 사용자가 공공데이터포털 기상청 API key를 직접 다룰 필요는 없다. `/v1/korea-weather/forecast` route는 기본 hosted proxy에서 호출하고, upstream `KMA_OPEN_API_KEY` 는 proxy 서버에서만 관리한다. 별도 proxy를 쓰는 경우에만 `KSKILL_PROXY_BASE_URL` 을 설정한다. ## Inputs - 격자 좌표: `nx`, `ny` - 또는 위도/경도: `lat`, `lon` - 선택 사항: `baseDate`, `baseTime` `baseDate` / `baseTime` 을 생략하면 proxy 가 KST 기준 최신 단기예보 발표 시각을 자동으로 고른다. ## Workflow ### 1. Resolve the proxy base URL `KSKILL_PROXY_BASE_URL` 이 있으면 그 값을 사용하고, 없거나 비어 있으면 기본 hosted proxy `https://k-skill-proxy.nomadamas.org` 를 사용한다. ### 2. Query the short-term forecast endpoint 격자 좌표가 이미 있으면 그대로 넣고, 위도/경도만 있으면 proxy 에 그대로 넘긴다. ```bash BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}" curl -fsS --get "${BASE}/v1/korea-weather/forecast" \ --data-urlencode 'lat=37.5665' \ --data-urlencode 'lon=126.9780' ``` 격자 좌표 예시: ```bash BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}" curl -fsS --get "${BASE}/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 - proxy upstream key 미설정 또는 hosted/self-host 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` 를 참고한다.