weather-query

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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

```python
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

```python
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

```bash
# 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

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

### Forecast Response

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

## Example Interactions

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

**Agent Response:**
```python
weather = get_realtime_weather('北京')
response = f"""
☁️ 北京今日天气

天气状况：{weather['weather']}

From zhouguoqing/QianYuan.AIAgenticFramework, MIT.

More from zhouguoqing/QianYuan.AIAgenticFramework