| name | search-weather |
| description | Search real-time weather information by city name using OpenWeatherMap API. Use when the user asks about weather, current temperature, forecasts, or climate conditions for a specific city (e.g., "서울 날씨", "Tokyo weather", "뉴욕 기온"). Always pass city names in English to the script. |
Search Weather
OpenWeatherMap API를 활용하여 도시별 실시간 날씨 정보를 검색하는 skill.
Quick Start
python skills/search-weather/scripts/weather_search.py "Seoul"
python skills/search-weather/scripts/weather_search.py "Tokyo" --format text
중요: 항상 전체 경로 skills/search-weather/scripts/weather_search.py를 사용한다.
도시명은 반드시 영문으로
사용자가 한글로 도시를 요청하더라도, 스크립트에는 영문 도시명을 전달한다.
- "서울 날씨" ->
"Seoul"
- "도쿄 날씨" ->
"Tokyo"
- "뉴욕 날씨" ->
"New York"
명령어 옵션
city (필수): 영문 도시명 (e.g., Seoul, Tokyo, New York)--format [json|text]: 출력 형식 (기본값: json)
JSON 응답 필드
| 필드 | 설명 |
|---|
city | 도시 이름 |
overall | 날씨 요약 (e.g., Clear, Clouds, Rain) |
description | 상세 날씨 설명 |
current_temp | 현재 기온 |
feels_like | 체감 온도 |
min_temp / max_temp | 최저/최고 기온 |
humidity | 습도 |
pressure | 기압 |
wind_speed | 풍속 (m/s) |
wind_direction | 풍향 (도) |
clouds | 구름량 |
visibility | 가시거리 |
last_updated | 마지막 업데이트 시각 (UTC) |
status | success 또는 error |
error | 에러 메시지 (status가 error일 때만 포함) |
Agent 통합
import subprocess
import json
WEATHER_SCRIPT = "skills/search-weather/scripts/weather_search.py"
result = subprocess.run(
["python", WEATHER_SCRIPT, city_name, "--format", "json"],
capture_output=True,
text=True
)
response = json.loads(result.stdout)
API Key
OpenWeatherMap API key는 다음 순서로 조회된다:
utils.weather_api_key (AWS Secrets Manager에서 로드)- 환경변수
OPENWEATHERMAP_API_KEY
요구사항
- Python 3.6+
requests 라이브러리- OpenWeatherMap API key
- 인터넷 연결
