kyopark2014/agent-manus/korea-weather

Korea Weather

기상청 날씨누리(weather.go.kr) 행정동 단위 동네예보·현재날씨와 에어코리아 대기질을 조회합니다.

When to Use

• 한국 날씨 / 기온 / 강수 / 습도 / 바람 문의
• 미세먼지·초미세먼지 등 대기질 문의
• 지역명을 주지 않은 "날씨 알려줘", "우산 필요해?" 류 요청
• 특정 동·구·시 날씨 (예: 반포3동, 서초구, 부산 해운대)

Script Location

application working directory 기준 전체 경로를 사용하세요.

IMPORTANT: scripts/...로 줄이지 말고 위 전체 경로를 사용하세요.

Critical Rules

1. 지역명이 없으면 먼저 memory로 집/거주 주소를 조회하세요.

``bash python skills/korea-weather/scripts/recall_home_location.py ``

• 주소가 나오면 그 값으로 get_weather.py를 실행하세요.
• LOCATION_NOT_FOUND이면 get_weather.py를 location 없이 실행해 IP 대략 위치를 시도하세요.
• 먼저 사용자에게 지역을 묻지 마세요.

1. 위치 해석 순서: memory(집 주소) → 공인 IP 대략 위치 → LOCATION_NEEDED
2. 결과가 LOCATION_NEEDED로 시작하면 그때만 지역명을 물어보세요. 도시를 임의로 지어내지 마세요.
3. 사용자 답변에서 기온·강수확률·습도 등에 ** / * 마크다운 강조를 쓰지 마세요. 예: 최고 30℃, 강수확률 60%.
4. 스크립트 stdout의 기상청 날씨 아이콘은 ![설명](https://www.weather.go.kr/...) 마크다운 그대로 답변에 포함하세요. HTML <img>로 바꾸지 마세요. 이 채팅은 img 태그를 글자로 보여 줍니다. 아이콘 URL을 지우거나 텍스트로만 바꾸지 마세요. 별도의 그래프·이미지는 만들지 마세요.

Quick Start

지역명 없음 → memory 먼저

# 1) memory에서 집/거주 주소
loc=$(python skills/korea-weather/scripts/recall_home_location.py)
 
# 2) 주소가 있으면 그 지역으로 날씨 조회
if [ "$loc" != "LOCATION_NOT_FOUND" ]; then
  python skills/korea-weather/scripts/get_weather.py "$loc"
else
  # memory 실패 시 IP 폴백(스크립트 내부)
  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

Usage (agent)

import subprocess
RECALL = "skills/korea-weather/scripts/recall_home_location.py"
WEATHER = "skills/korea-weather/scripts/get_weather.py"
# 지역 미지정 → memory 조회 후 날씨
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:
    # memory 실패 → IP 폴백
    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)
# stnId
result = subprocess.run(["python", WEATHER, "--stnid", "159"], capture_output=True, text=True)
print(result.stdout)

Response Contents

스크립트 stdout에 다음이 포함됩니다.

• 행정동명·위치 해석 메모(memory / IP)
• 기상청 날씨누리 날씨 아이콘(현재·오늘/내일 오전·오후, 일별·시간대 표). 64×64 PNG를 마크다운 이미지로 출력합니다.
• 현재 기온·체감·습도·바람
• 오늘/내일 날씨·최저·최고·강수확률
• 시간대별 요약 표
• 일별 예보 표
• 대기질(해당 권역)
• 광역 단기예보 참고(있을 때)
• 날씨누리·에어코리아 링크

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 모두 실패했습니다. 사용자에게 지역명을 요청하세요.

네트워크 오류

날씨누리/에어코리아 일시 장애일 수 있습니다. 잠시 후 재시도하세요.