YunShu/skills/msn-weather-api/SKILL.md

---
name: msn-weather-api
description: MSN 天气 API 详细知识
---

# MSN 天气 API 参考

## 接口地址

| 接口 | URL |
|------|-----|
| 当前天气 | `https://assets.msn.cn/service/weather/current` |
| 每日预报 | `https://assets.msn.cn/service/weather/dailyforecast` |
| 逐小时预报 | `https://assets.msn.cn/service/weather/hourlyforecast` |

## 必须参数

- `apiKey`: `j5i4gDqHL6nGYwx5wi5kRhXjtf2c5qgFX9fzfk0TOo`（固定值，不可修改）
- `lat` / `lon`: 经纬度（WGS84）
- `locale`: `zh-cn`
- `units`: `C`（摄氏）

## 可选参数

- `days`: 预报天数（最大 10，仅 dailyforecast 和 hourlyforecast 可用）

## 必须请求头

```
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)
Referer: https://www.msn.com/zh-cn/weather
```

## 响应数据结构

### current 接口
```
value[].responses[].weather[].current.{
  temp, cap, feels, rh, baro, windSpd, windDir,
  windGust, uv, uvDesc, vis, dewPt, aqi,
  aqiSeverity, cloudCover, created
}
```

### dailyforecast 接口
```
value[].responses[].weather[].days[].daily.{
  valid, tempLo, tempHi, precip, windMax,
  windMaxDir, rhHi, rhLo, icon, symbol, uv, uvDesc
}
```

### hourlyforecast 接口
返回未来 10 天每天逐小时预报（今天从当前小时开始，后续每天 24 个点）。

```
value[].responses[].weather[].days[].hourly[].{
  valid,          // ISO 时间戳，如 "2026-05-11T07:00:00+08:00"
  temp,           // 温度 °C
  feels,          // 体感温度 °C
  cap,            // 天气描述（中文）
  precip,         // 降水概率 %
  rh,             // 相对湿度 %
  baro,           // 气压 hPa
  windSpd,       // 风速 km/h
  windDir,        // 风向（度）
  windGust,       // 阵风 km/h
  uv,             // 紫外线指数
  cloudCover,     // 云量 %
  vis,            // 能见度 km
  dewPt,          // 露点 °C
  rainAmount,     // 降雨量 mm
  snowAmount,     // 降雪量 mm
  icon, symbol,   // 天气图标代码
  sky, wx         // 天空状况代码
}
```

## 注意事项
- 数据源为微软 MSN 天气后台接口
- 国内访问速度快（msn.cn 国内节点）
- apiKey 可能随时更换
- 不可用于商业产品