从实时天气到未来预报,从空气质量到天文数据, 一个二进制文件搞定所有天气查询需求。
温度、体感温度、风力风向、相对湿度、能见度、云量、气压等实时气象要素,支持全球城市查询。
台风、暴雨、暴雪、高温、寒潮、大雾等各类实时预警信息,覆盖中国全境,确保安全提前知晓。
未来 2 小时内每 5 分钟的降水强度预报,精确到分钟级别,支持中国地区高精度降水预测。
实时 AQI 指数、主要污染物浓度(PM2.5/PM10/O3/NO2/SO2/CO)、未来逐日和逐小时空气质量预报。
穿衣、洗车、运动、感冒、紫外线、钓鱼、旅游等 16 项生活指数预报,为日常生活提供参考。
基于经纬度坐标的高分辨率天气数据,空间精度可达 3-5 公里,支持逐日和逐小时精确预报。
支持城市名称搜索、POI 兴趣点查询、热门城市排行、经纬度反向地理编码,精准定位查询目标。
日出日落时间、月升月落时间、月相变化、太阳高度角和方位角等天文数据,满足特殊场景需求。
通过命令和子命令的组合,轻松查询各类天气数据。 支持城市名称、Location ID 和经纬度三种定位方式。
# 实时天气 qw weather now --city 北京 # 未来 7 天预报(支持 3/7/10/15/30 天) qw weather daily 7 --city 上海 # 未来 24 小时逐时预报(支持 24/72/168 小时) qw weather hourly 72 --city 深圳 # 分钟级降水预报(中国地区) qw precipitation --lon 116.40 --lat 39.90
# 格点实时天气(高精度 3-5km) qw grid now --lon 116.40 --lat 39.90 # 格点逐日预报(支持 3/7 天) qw grid daily 7 --lon 121.47 --lat 31.23 # 格点逐时预报(支持 24/72 小时) qw grid hourly 72 --lon 114.06 --lat 22.55
# 实时空气质量 qw air now --city 北京 # 未来 5 天空气质量预报 qw air daily 5 --city 上海 # 监测站数据 qw air station --city 广州
# 今日生活指数 qw indices --city 北京 # 未来 3 天生活指数 qw indices --city 杭州 --days 3d # 类型包括:穿衣、洗车、运动、感冒、紫外线、 # 钓鱼、旅游、过敏、晾晒等 16 项指数
# 日出日落(日期格式 yyyyMMdd,最多未来 60 天) qw sun --city 北京 --date 20260615 # 月升月落与月相 qw moon --city 上海 --date 20260615 # 太阳高度角 qw solar --lon 116.40 --lat 39.90 \ --date 20260615 --time 1200 --tz 0800 --alt 43
无论你是终端新手还是资深开发者,都能找到适合自己的安装方式。
推荐方式,一行命令完成安装
curl -sSL https://raw.githubusercontent.com/yinguobing/qweather-skill/main/install.sh | bash
从 crates.io 安装发布版本
cargo install qweather
从 GitHub 仓库直接编译
cargo install --git https://github.com/yinguobing/qweather-skill.git
使用 JWT 认证方式,支持环境变量和命令行参数两种配置方式。请在和风天气控制台获取凭证。
export QWEATHER_KID="YOUR_KID" export QWEATHER_PROJECT_ID="YOUR_PROJECT_ID" export QWEATHER_PRIVATE_KEY="/path/to/private.pem" export QWEATHER_BASE_URL="https://your-host.qweatherapi.com/v7" export QWEATHER_GEO_URL="https://your-host.qweatherapi.com/geo/v2"