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
Get Weather Forecast
Simple bash example
Response Format
Real-time Weather Response
Forecast Response
Example Interactions
User: "北京今天天气怎么样?"
Agent Response:
User: "上海未来三天天气"
User: "深圳会下雨吗?"
Best Practices
-
Location Names: Always use Chinese characters for location names
-
Error Handling: Check if the location is valid before displaying results
-
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
-
Caching: Weather data is updated regularly but can be cached for short periods
-
Fallbacks: If a specific district doesn't work, try the city name
Common Use Cases
1. Weather-based Recommendations
2. Multi-city Weather Comparison
3. Travel Weather Check
Troubleshooting
Issue: Location not found
- Solution: Try using the main city name instead of district
- Example: Use "北京" instead of "朝阳区"
Issue: No forecast data
- Solution: Verify the location name is correct
- Try standard city names: 北京, 上海, 广州, 深圳, etc.
Issue: Data seems outdated
- Solution: The API updates regularly, but weather can change quickly
- Check the
updatedtimestamp in the response
Supported Locations
The weather API supports most cities and districts in China, including:
- Provincial capitals: 北京, 上海, 广州, 深圳, 成都, 杭州, 南京, 武汉, etc.
- Major cities: 苏州, 青岛, 大连, 厦门, etc.
- Districts: 海淀区, 朝阳区, 浦东新区, etc.

