SuperAPI AI 工具集

weathercli

通用与其它

查看项目

更新于 10-16 07:12

技能介绍

Weather CLI 是一个用于查询天气的命令行工具,通过 weathercli 命令获取全球任意地点的天气信息。

用途

该工具主要用于在命令行或自动化流程中获取天气数据,适合用户询问天气、温度、预报或天气状况时使用,也适用于活动规划、判断是否会下雨下雪或晴天、旅行规划中的气候信息查询、获取日出日落时间,以及比较不同地点的天气。

主要能力

当前天气:获取实时天气状况,包括温度、体感温度、湿度百分比、风速与风向、气压、云量、紫外线指数、降水量、天气状况描述,以及当地时区的时戳。

预报:支持按天或按小时获取预报。按天预报默认 7 天,最多 16 天;按小时预报最多 384 小时。每天/每小时返回温度(最高/最低或当前)、天气状况、降水概率与降水量、风速与风向、紫外线指数,按天预报还包含日出日落时间。

地点搜索:查找地点的坐标与时区信息,返回地点名称、经纬度、国家、地区/州、时区。

地点格式:地点名称灵活并自动地理编码,支持城市名(如 London、Tokyo、New York)、城市加国家(如 Paris, France)、城市加州/地区(如 Portland, Oregon),对于有歧义的名称可添加国家或地区以提高精度。

使用方式

当前天气:weathercli current "<location>",加 --json 输出结构化 JSON。

预报:weathercli forecast "<location>" --days <N> 获取按天预报;weathercli forecast "<location>" --hourly --hours <N> 获取按小时预报;加 --json 输出 JSON。

地点搜索:weathercli search "<location>",加 --json 输出 JSON。

选项:--json 输出结构化 JSON(推荐用于解析);--no-color 禁用彩色输出(用于纯文本解析);--days N 指定预报天数(1-16,默认 7);--hourly 显示按小时而非按天预报;--hours N 指定按小时预报的小时数(1-384);--verbose 显示详细请求信息。

输出格式:默认人类可读格式,温度带颜色编码,使用表情符号和单位格式化,时间显示为地点当地时区。JSON 格式包含 location(名称、纬度、经度、国家、时区)、time、temperature、apparent、humidity、wind_speed、wind_direction、condition、weather_code、precipitation、cloud_cover、pressure、uv_index 等字段;预报 JSON 包含 location 与 daily 数组,每项含 date、temp_max、temp_min、condition、precip_prob、precipitation、sunrise、sunset、wind_speed_max、wind_direction、uv_index_max。

适用场景

快速天气检查、旅行多日预报、当天逐小时详细规划、多城市天气对比、查找精确地点坐标等。示例包括:weathercli current "London" --json | jq '.temperature, .condition';weathercli forecast "Barcelona" --days 5 --json;weathercli forecast "Seattle" --hourly --hours 24;循环查询多个城市;weathercli search "Springfield" --json。

限制与注意事项

无需 API 密钥,使用免费的 Open-Meteo API;覆盖全球任意地点;温度单位为摄氏度(华氏度换算:°F = °C × 9/5 + 32);风速单位为公里/小时(英里/小时换算:×0.621);所有时间自动转换为当地时区;速率限制适合个人或智能体使用,应避免频繁请求;数据来自多个气象来源;当前天气每 15 分钟更新;需要互联网连接,无法离线使用。weather_code 遵循 WMO 标准(0-99)。

错误处理

地点未找到时返回 location not found 错误,建议检查拼写或添加国家/地区;网络错误时返回 weather API error: network timeout,建议稍后重试;无效输入时返回 invalid days value,需检查 --days 是否在 1-16 之间。

安装

若 weathercli 不可用,可通过 Go 安装:go install github.com/pjtf93/weathercli/cmd/weathercli@latest,或从 releases 页面下载二进制文件(https://github.com/pjtf93/weathercli/releases)。