weathercli

核心用法

weathercli 是一款轻量级命令行天气查询工具，通过简单的 CLI 指令即可获取全球任意地点的实时天气与预报信息。核心功能包括三大模块：当前天气查询（weathercli current）返回温度、体感温度、湿度、风速风向、气压、云量、UV 指数、降水量及天气状况；天气预报（weathercli forecast）支持 1-16 天逐日预报或最长 384 小时逐小时预报；地点搜索（weathercli search）提供坐标、时区等地理信息。所有输出支持 --json 结构化格式，便于程序解析与自动化处理。

地点输入高度灵活，支持城市名、城市+国家/地区组合，系统自动进行地理编码解析。输出采用本地化时区，温度默认摄氏度，风速公里/小时，并可通过 --no-color 禁用颜色输出以适应纯文本场景。

显著优点

零配置开箱即用是最大亮点——无需注册账号、无需申请 API 密钥，直接调用免费的 Open-Meteo 开源气象 API。功能设计精准聚焦天气场景，涵盖从日常出行到长途旅行的多元需求：UV 指数提示防晒、降水概率辅助决策、日出日落时间规划行程。JSON 输出与 jq 等工具链无缝集成，适合开发者构建自动化工作流。代码采用 Go 语言编写，单二进制文件部署，跨平台兼容性强。

潜在缺点与局限性

作为新兴项目（2026 年 1 月创建），社区生态尚未成熟，GitHub Stars 与 Forks 均为零，长期维护持续性有待观察。功能相对单一，缺乏历史天气查询、气象警报推送、多单位自动转换（华氏度/英里需手动计算）等进阶特性。依赖单一外部 API，若 Open-Meteo 服务变更或限流，将直接影响可用性。此外，命令行交互模式对非技术用户存在门槛，无图形界面或自然语言对话能力。

适合的目标群体

• 开发者与运维人员：需要快速获取结构化天气数据集成到脚本或监控告警
• 效率工具爱好者：偏好命令行工作流，追求极简工具组合
• 旅行规划者：需要批量查询多目的地天气，对比决策
• 自动化场景：CI/CD 流程、定时任务中嵌入天气判断逻辑

使用风险

• 网络依赖：必须保持互联网连接，离线场景无法使用
• API 稳定性：免费服务存在隐性速率限制，高频调用可能触发限流
• 数据精度：气象数据来自第三方聚合源，极端天气场景下准确性受限
• 项目成熟度：作者为个人开发者，项目更新频率与长期支持存在不确定性

核心用法

weathercli 是一个命令行天气查询工具 Skill，通过调用外部 weathercli 二进制程序获取全球任意地点的实时天气与预报数据。主要功能包括：

• 实时天气：温度、体感温度、湿度、风速风向、气压、云量、UV指数、降水量、天气状况
• 多日预报：支持 1-16 天每日预报（默认7天），含最高/最低温、降水概率、日出日落
• 小时预报：支持最长 384 小时逐小时预测
• 位置搜索：自动地理编码，支持城市名、城市+国家/地区、模糊名称等灵活输入格式
• 结构化输出：默认彩色可读格式，支持 --json 输出供程序解析

显著优点

1. 零配置即用：无需注册 API Key，开箱即用
2. 全球覆盖：基于 Open-Meteo 开放气象数据，支持全球任意坐标
3. 数据丰富：提供 WMO 标准天气代码、UV指数、体感温度等专业指标
4. 时区智能：自动转换目标地点本地时间，无需手动计算
5. 输出灵活：JSON 格式便于 Agent 程序化解析和批量处理
6. 纯文档安全：SKILL.md 仅含使用说明，无可执行代码，获 S+ 顶级安全评级

局限性与注意事项

• 外部工具依赖：需用户自行安装 weathercli 二进制程序（Go 安装或 GitHub releases 下载），Skill 本身不包含实现
• 网络依赖：必须联网使用，无离线缓存能力
• 温度单位为摄氏度：华氏度需自行换算（°F = °C × 9/5 + 32）
• 数据源单一：仅依赖 Open-Meteo，无多源校验机制
• 更新频率：实时天气约15分钟更新，非实时分钟级
• 速率限制：虽声明适合个人/Agent 使用，但高频调用可能受限于 Open-Meteo 免费层

适合人群

• 需要快速获取天气信息的个人用户与开发者
• 构建旅行规划、户外活动建议等 Agent 应用的场景
• 对 API Key 申请流程敏感、追求极简配置的用户
• 重视安全、希望避免代码执行风险的谨慎型用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 代码执行风险 | 🟢 无 | 纯文档型 Skill，无可执行代码 |

| 数据泄露风险 | 🟢 低 | 仅传输位置与天气数据至 Open-Meteo，无敏感信息收集 |

| 供应链风险 | 🟡 低 | 依赖外部 weathercli 工具，需从可信渠道安装并持续更新 |

| 可用性风险 | 🟡 中 | 依赖 Open-Meteo 免费服务，极端情况下可能受限 |

| 准确性风险 | 🟡 中 | 气象预报本身存在不确定性，建议结合多源验证重要决策 |

> 使用建议：从官方 GitHub releases 安装 weathercli，定期检查上游更新，关键出行决策建议交叉验证官方气象数据源。