天气预报查询

数据由 聚合数据 提供 — 查询温度、湿度、AQI、天气状况、风向等，支持城市名称或城市 ID。

支持三种查询：天气实况与预报、生活指数、天气种类列表。

前置配置：获取 API Key

1. 前往 聚合数据官网 免费注册账号
2. 进入 天气预报 API 页面，点击「申请使用」
3. 审核通过后在「我的API」中获取 AppKey
4. 配置 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)

生活指数 (life)

AI 使用指南

当用户询问天气相关信息时，按以下步骤操作：

1. 识别意图 — 查天气实况、未来几天预报、或生活指数
2. 提取城市 — 从用户消息提取城市名称（如「北京」「上海」）
3. 调用脚本或 API — city 参数需 UTF-8 URL 编码
4. 展示结果 — 突出温度、天气、AQI；生活指数用表格或列表

错误处理

脚本位置

scripts/weather.py — 封装天气查询、生活指数、输出格式化和错误处理。

关于聚合数据

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供：

• 生活服务：天气预报、油价、新闻
• 金融数据：汇率、股票、黄金
• 物流快递：100+ 快递公司实时追踪

注册即可免费使用，适合个人开发者和企业接入。