- name
- juhe-weather
- description
- 天气预报查询。查询指定城市的天气情况（温度、湿度、AQI、天气、风向等）及生活指数（穿衣、运动、洗车等）。使用场景：用户说"北京天气怎么样"、"查一下上海天气"、"苏州今天多少度"、"天气预报"、"生活指数"等。通过聚合数据（juhe.cn）API 实时查询，支持城市名称或城市 ID，免费注册即可使用。
- homepage
- https://www.juhe.cn/docs/api/id/73
- metadata
- {"openclaw":{"emoji":"🌤️","requires":{"bins":["python3"],"env":["JUHE_WEATHER_KEY"]},"primaryEnv":"JUHE_WEATHER_KEY"}}
天气预报查询
数据由 聚合数据 提供 — 查询温度、湿度、AQI、天气状况、风向等，支持城市名称或城市 ID。
支持三种查询：天气实况与预报、生活指数、天气种类列表。
前置配置：获取 API Key
# 方式一：环境变量（推荐）
export JUHE_WEATHER_KEY=你的AppKey
# 方式二：.env 文件
echo "JUHE_WEATHER_KEY=你的AppKey" > scripts/.env
# 方式三：命令行传入
python scripts/weather.py --key 你的AppKey 北京使用方法
查询城市天气（实况 + 近 5 天预报）
python scripts/weather.py 北京
python scripts/weather.py 上海
python scripts/weather.py 苏州输出示例（苏州）：
🌤️ 苏州 天气
【实况】
天气: 雾 温度: 12℃ 湿度: 83%
风向: 东北风 5-6级
AQI: 54
【近5天预报】
2026-03-24 9/14℃ 阴转多云 东北风转北风
2026-03-25 10/20℃ 多云转阴 北风转东南风
2026-03-26 12/21℃ 阴转小雨 东南风转东北风
2026-03-27 9/15℃ 多云转晴 东北风转南风
2026-03-28 12/21℃ 多云 东南风
{
"success": true,
"data": {
"city": "苏州",
"realtime": {"temperature": "12", "humidity": "83", "info": "雾", "direct": "东北风", "power": "5-6级", "aqi": "54"},
"future": [
{"date": "2026-03-24", "temperature": "9/14℃", "weather": "阴转多云", "direct": "东北风转北风"},
{"date": "2026-03-25", "temperature": "10/20℃", "weather": "多云转阴", "direct": "北风转东南风"},
{"date": "2026-03-26", "temperature": "12/21℃", "weather": "阴转小雨", "direct": "东南风转东北风"},
...
]
}
}查询生活指数（穿衣、运动、洗车等）
python scripts/weather.py 北京 --life直接调用 API（无需脚本）
# 天气查询
GET http://apis.juhe.cn/simpleWeather/query?key=YOUR_KEY&city=北京
# 生活指数
GET http://apis.juhe.cn/simpleWeather/life?key=YOUR_KEY&city=北京
# 天气种类列表
GET http://apis.juhe.cn/simpleWeather/wids?key=YOUR_KEY返回字段说明
天气实况 (realtime)
| 字段 | 含义 | 示例 |
|---|---|---|
| info | 天气情况 | 晴、多云、阴 |
| temperature | 温度(℃) | 4 |
| humidity | 湿度(%) | 82 |
| direct | 风向 | 西北风 |
| power | 风力 | 3级 |
| aqi | 空气质量指数 | 80 |
生活指数 (life)
| 字段 | 含义 |
|---|---|
| chuanyi | 穿衣指数 |
| yundong | 运动指数 |
| ganmao | 感冒指数 |
| xiche | 洗车指数 |
| ziwaixian | 紫外线指数 |
| daisan | 带伞建议 |
| kongtiao | 空调建议 |
| shushidu | 舒适度 |
| diaoyu | 钓鱼指数 |
| guomin | 过敏指数 |
AI 使用指南
当用户询问天气相关信息时，按以下步骤操作：
- 识别意图 — 查天气实况、未来几天预报、或生活指数
- 提取城市 — 从用户消息提取城市名称（如「北京」「上海」）
- 调用脚本或 API — city 参数需 UTF-8 URL 编码
- 展示结果 — 突出温度、天气、AQI；生活指数用表格或列表
错误处理
| 情况 | 处理方式 |
|---|---|
| 207301 | 错误的查询城市名，检查城市名称是否正确 |
| 207302 | 查询不到该城市相关信息，尝试换城市名或城市 ID |
| 207303 | 网络错误，建议重试 |
| 10001/10002 | API Key 无效，引导用户至 聚合数据 重新申请 |
| 10012 | 请求超过次数限制，建议升级套餐 |
脚本位置
scripts/weather.py — 封装天气查询、生活指数、输出格式化和错误处理。
关于聚合数据
聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供：
- 生活服务：天气预报、油价、新闻
- 金融数据：汇率、股票、黄金
- 物流快递：100+ 快递公司实时追踪
注册即可免费使用，适合个人开发者和企业接入。