核心用法
weather-china 是一款基于中国天气网(weather.com.cn)的天气查询工具,采用纯 Python 实现,无需 API Key 即可使用。通过命令行调用 Python 脚本,支持两种输出模式:格式化文本便于快速阅读,JSON 格式便于数据集成。
基本调用:
python3 skills/weather-china/lib/weather_cn.py query <城市名> # 文本输出 python3 skills/weather-china/lib/weather_cn.py json <城市名> # JSON 输出
城市名称支持自动搜索匹配,60+ 常用城市(北京、上海、广州等)内置代码加速查询,其他城市通过搜索接口动态解析。提供 7 天逐日预报(天气状况、高低温、风向风力)及 6 项生活指数(感冒、运动、过敏、穿衣、洗车、紫外线)。
显著优点
- 零配置使用:无需注册账号或申请 API Key,开箱即用
- 数据源权威:直接对接中国天气网,数据覆盖全面、更新及时
- 智能城市匹配:自动搜索城市代码,无需手动维护映射表
- 中文原生优化:针对中文城市名和描述设计,符合国内用户习惯
- 轻量纯 Python:无额外依赖,兼容标准 Python 3 环境
潜在局限
- 网络依赖性强:必须能访问 www.weather.com.cn,海外或受限网络环境可能无法使用
- 无实时数据:基于网页解析,存在分钟级延迟,非专业气象 API 级别时效
- 解析脆弱性:依赖网页 DOM 结构,若天气网改版可能导致数据抓取失败
- 功能边界:仅支持预报查询,无历史数据、无分钟级降水预报、无雷达图等专业功能
适合人群
- 需要快速获取国内城市天气的日常用户
- 构建本地化助手、不愿对接商业 API 的开发者
- 对数据延迟容忍度在分钟级的场景(出行建议、穿衣指南等)
常规风险
- 服务可用性风险:数据源单点依赖,天气网服务中断或反爬升级将导致功能失效
- 数据准确性风险:生活指数基于气象条件推算,非医学/专业建议,仅供参考
- 隐私合规风险:查询行为会暴露至 weather.com.cn 服务器日志
- 爬虫政策风险:长期使用需关注天气网 robots.txt 及反爬策略变化