Weather Query Zrr

查询全球城市实时天气信息，支持当前天气、未来预报和空气质量查询。基于 wttr.in 和 Open-Meteo API，无需 API Key。Use this skill when user asks about weather, temperature, forecast, or air quality for any city.

Weather Query

概述

查询全球城市天气信息的技能。支持三种查询模式：当前天气、未来3天预报、空气质量。默认使用 wttr.in（无需 API Key），也支持 Open-Meteo API 作为备选数据源。

前置条件

• Python 3.10+（系统自带）
• requests 库（pip install requests）
• 网络可访问 wttr.in 或 api.open-meteo.com

核心命令

查询当前天气

python3 scripts/weather.py --city "Beijing" --mode current

查询未来预报

python3 scripts/weather.py --city "Shanghai" --mode forecast

查询空气质量

python3 scripts/weather.py --city "Guangzhou" --mode air

指定数据源

python3 scripts/weather.py --city "Tokyo" --source open-meteo

参数确认

参数	必需	默认值	说明
--city	是	-	城市名（支持中英文，如 "北京" / "Beijing"）
--mode	否	current	查询模式: current / forecast / air
--source	否	wttr	数据源: wttr / open-meteo
--lang	否	zh	输出语言: zh / en
--format	否	text	输出格式: text / json

输出格式

current 模式

🏙️ 北京 (Beijing)
🌡️ 温度: 28°C (体感 30°C)
💧 湿度: 65%
🌬️ 风速: 12 km/h 东南风
☁️ 天气: 多云
👁️ 能见度: 10 km

forecast 模式

🏙️ 上海 未来3天预报:
📅 今天: 30°C / 22°C ☀️ 晴
📅 明天: 28°C / 21°C ⛅ 多云
📅 后天: 25°C / 19°C 🌧️ 小雨

air 模式

🏙️ 广州 空气质量:
🟢 AQI: 52 (良)
PM2.5: 35 μg/m³
PM10: 58 μg/m³
O₃: 42 μg/m³

验证方法

# 验证脚本可执行
python3 scripts/weather.py --city "Beijing" --mode current

# 验证 JSON 输出
python3 scripts/weather.py --city "Beijing" --format json

# 验证中文名查询
python3 scripts/weather.py --city "深圳" --mode forecast

最佳实践

• 城市名优先使用英文，中文城市名会自动转换
• wttr.in 对中国城市支持较好，Open-Meteo 对欧美城市更精确
• 批量查询时建议加 --format json 方便程序解析
• wttr.in 有频率限制，批量查询建议间隔 1 秒

参考文档

• wttr.in — 基于终端的天气服务
• Open-Meteo API — 免费天气 API
• 城市名映射 — wttr.in 多语言支持

注意事项

• wttr.in 为公共服务，偶尔不稳定，可切换 --source open-meteo
• 空气质量数据仅 Open-Meteo 支持，wttr.in 的 air 模式会自动切换数据源
• 中国部分小城市可能无法查询，建议使用地级市名称