Weather Query Skill

This skill enables AI agents to fetch real-time weather information and forecasts for locations in China using the 60s API.

When to Use This Skill

Use this skill when users:

• Ask about current weather conditions
• Want weather forecasts
• Need temperature, humidity, wind information
• Request air quality data
• Plan outdoor activities and need weather info

API Endpoints

1. Real-time Weather

URL: https://60s.viki.moe/v2/weather/realtime
Method: GET

2. Weather Forecast

URL: https://60s.viki.moe/v2/weather/forecast
Method: GET

Parameters

• query (required): Location name in Chinese
  • Can be city name: "北京", "上海", "广州"
  • Can be district name: "海淀区", "浦东新区"

How to Use

Get Real-time Weather

import requests

def get_realtime_weather(query):
    url = 'https://60s.viki.moe/v2/weather/realtime'
    response = requests.get(url, params={'query': query})
    return response.json()

# Example
weather = get_realtime_weather('北京')
print(f"☁️ {weather['location']}天气")
print(f"🌡️ 温度：{weather['temperature']}°C")
print(f"💨 风速：{weather['wind']}")
print(f"💧 湿度：{weather['humidity']}")

Get Weather Forecast

def get_weather_forecast(query):
    url = 'https://60s.viki.moe/v2/weather/forecast'
    response = requests.get(url, params={'query': query})
    return response.json()

# Example
forecast = get_weather_forecast('上海')
for day in forecast['forecast']:
    print(f"{day['date']}: {day['weather']} {day['temp_low']}°C ~ {day['temp_high']}°C")

Simple bash example

# Real-time weather
curl "https://60s.viki.moe/v2/weather/realtime?query=北京"

# Weather forecast
curl "https://60s.viki.moe/v2/weather/forecast?query=上海"

Response Format

Real-time Weather Response

{
  "location": "北京",
  "weather": "晴",
  "temperature": "15",
  "humidity": "45%",
  "wind": "东北风3级",
  "air_quality": "良",
  "updated": "2024-01-15 14:00:00"
}

Forecast Response

{
  "location": "上海",
  "forecast": [
    {
      "date": "2024-01-15",
      "day_of_week": "星期一",
      "weather": "多云",
      "temp_low": "10",
      "temp_high": "18",
      "wind": "东风3-4级"
    },
    ...
  ]
}

Example Interactions

User: "北京今天天气怎么样？"

Agent Response:

weather = get_realtime_weather('北京')
response = f"""
☁️ 北京今日天气

天气状况：{weather['weather']}
🌡️ 温度：{weather['temperature']}°C
💧 湿度：{weather['humidity']}
💨 风力：{weather['wind']}
🌫️ 空气质量：{weather['air_quality']}
"""

User: "上海未来三天天气"

forecast = get_weather_forecast('上海')
response = "📅 上海未来天气预报\n\n"
for day in forecast['forecast'][:3]:
    response += f"{day['date']} {day['day_of_week']}\n"
    response += f"  {day['weather']} {day['temp_low']}°C ~ {day['temp_high']}°C\n"
    response += f"  {day['wind']}\n\n"

User: "深圳会下雨吗？"

weather = get_realtime_weather('深圳')
if '雨' in weather['weather']:
    print("☔ 是的，深圳现在正在下雨")
    print("建议带伞出门！")
else:
    forecast = get_weather_forecast('深圳')
    rain_days = [d for d in forecast['forecast'] if '雨' in d['weather']]
    if rain_days:
        print(f"未来{rain_days[0]['date']}可能会下雨")
    else:
        print("近期没有降雨预报")

Best Practices

1. Location Names: Always use Chinese characters for location names

2. Error Handling: Check if the location is valid before displaying results

3. Context: Provide relevant context based on weather conditions

   • Rain: Suggest bringing umbrella
   • Hot: Recommend staying hydrated
   • Cold: Advise wearing warm clothes
   • Poor AQI: Suggest wearing mask

4. Caching: Weather data is updated regularly but can be cached for short periods

5. Fallbacks: If a specific district doesn't work, try the city name

Common Use Cases

1. Weather-based Recommendations

def give_weather_advice(location):
    weather = get_realtime_weather(location)
    advice = []
    
    temp = int(weather['temperature'])
    if temp > 30:
        advice.append("🔥 天气炎热，注意防暑降温，多喝水")
    elif temp < 5:
        advice.append