| name | korea-weather |
| description | 기상청 날씨누리 동네예보·현재날씨와 에어코리아 대기질로 한국 날씨를 조회합니다. 사용자가 "날씨", "오늘 날씨", "우산", "미세먼지", "기온", "비 오나요", "현재 위치 날씨" 등을 묻거나 특정 지역(동/구/시) 날씨를 요청할 때 사용합니다. API 키 불필요. |
Korea Weather
기상청 날씨누리(weather.go.kr) 행정동 단위 동네예보·현재날씨와 에어코리아 대기질을 조회합니다.
When to Use
- 한국 날씨 / 기온 / 강수 / 습도 / 바람 문의
- 미세먼지·초미세먼지 등 대기질 문의
- 지역명을 주지 않은 "날씨 알려줘", "우산 필요해?" 류 요청
- 특정 동·구·시 날씨 (예: 반포3동, 서초구, 부산 해운대)
Script Location
application working directory 기준 전체 경로를 사용하세요.
| 스크립트 | 용도 |
|---|
skills/korea-weather/scripts/recall_home_location.py | 지역명 미지정 시 memory에서 집/거주 주소 조회 |
skills/korea-weather/scripts/get_weather.py | 기상청 동네예보·현재날씨·대기질 조회 |
IMPORTANT: scripts/...로 줄이지 말고 위 전체 경로를 사용하세요.
Critical Rules
- 지역명이 없으면 먼저 memory로 집/거주 주소를 조회하세요.
python skills/korea-weather/scripts/recall_home_location.py
- 주소가 나오면 그 값으로
get_weather.py를 실행하세요.
LOCATION_NOT_FOUND이면 get_weather.py를 location 없이 실행해 IP 대략 위치를 시도하세요.- 먼저 사용자에게 지역을 묻지 마세요.
- 위치 해석 순서: memory(집 주소) → 공인 IP 대략 위치 →
LOCATION_NEEDED
- 결과가
LOCATION_NEEDED로 시작하면 그때만 지역명을 물어보세요. 도시를 임의로 지어내지 마세요.
- 사용자 답변에서 기온·강수확률·습도 등에
** / * 마크다운 강조를 쓰지 마세요. 예: 최고 30℃, 강수확률 60%.
- 그래프·이미지를 만들지 마세요. 텍스트 요약 + 표 + 링크만 전달하세요.
Quick Start
지역명 없음 → memory 먼저
loc=$(python skills/korea-weather/scripts/recall_home_location.py)
if [ "$loc" != "LOCATION_NOT_FOUND" ]; then
python skills/korea-weather/scripts/get_weather.py "$loc"
else
python skills/korea-weather/scripts/get_weather.py
fi
JSON 상세 결과:
python skills/korea-weather/scripts/recall_home_location.py --json
현재 위치 별칭(스크립트 내부 memory→IP)
python skills/korea-weather/scripts/get_weather.py "현재위치"
지역명 지정
python skills/korea-weather/scripts/get_weather.py "서울 서초구 반포3동"
python skills/korea-weather/scripts/get_weather.py "부산 해운대"
python skills/korea-weather/scripts/get_weather.py "제주"
예보구역 stnId
python skills/korea-weather/scripts/get_weather.py --stnid 109
| stnId | 대표 지역 |
|---|
| 108 / 109 | 서울·인천·경기 |
| 105 | 강원 |
| 131 | 충북 |
| 133 | 대전·세종·충남 |
| 146 | 전북 |
| 156 | 광주·전남 |
| 143 | 대구·경북 |
| 159 | 부산·울산·경남 |
| 184 | 제주 |
Usage (agent)
import subprocess
RECALL = "skills/korea-weather/scripts/recall_home_location.py"
WEATHER = "skills/korea-weather/scripts/get_weather.py"
mem = subprocess.run(["python", RECALL], capture_output=True, text=True)
loc = mem.stdout.strip()
if mem.returncode == 0 and loc and loc != "LOCATION_NOT_FOUND":
result = subprocess.run(["python", WEATHER, loc], capture_output=True, text=True)
else:
result = subprocess.run(["python", WEATHER], capture_output=True, text=True)
print(result.stdout)
result = subprocess.run(["python", WEATHER, "강남구"], capture_output=True, text=True)
print(result.stdout)
result = subprocess.run(["python", WEATHER, "--stnid", "159"], capture_output=True, text=True)
print(result.stdout)
Response Contents
스크립트 stdout에 다음이 포함됩니다.
- 행정동명·위치 해석 메모(memory / IP)
- 현재 기온·체감·습도·바람
- 오늘/내일 날씨·최저·최고·강수확률
- 시간대별 요약 표
- 일별 예보 표
- 대기질(해당 권역)
- 광역 단기예보 참고(있을 때)
- 날씨누리·에어코리아 링크
Dependencies
requests, beautifulsoup4 (application 환경에 이미 포함)- API 키 불필요
- memory 조회:
application/mcp_memory.py (AgentCore), AGENTCORE_USER_ID 환경변수(선택)
- 공인 IP 지오로케이션(
ip-api.com) — memory 실패 시 폴백
Troubleshooting
지역을 찾을 수 없음
동·구·시까지 구체적으로 다시 조회하세요. 예: 서울 서초구, 반포3동.
LOCATION_NOT_FOUND (memory)
저장된 집 주소가 없습니다. get_weather.py로 IP 폴백을 시도하거나, 사용자에게 지역명을 요청하세요.
LOCATION_NEEDED
memory·IP 모두 실패했습니다. 사용자에게 지역명을 요청하세요.
네트워크 오류
날씨누리/에어코리아 일시 장애일 수 있습니다. 잠시 후 재시도하세요.
