wttr-weather

How to check weather forecasts using wttr.in service. Make sure to use this skill whenever the user mentions weather, forecast, temperature, or wants to chec...

Security Scan

The skill's code, documentation, and runtime behavior match its stated purpose (querying wttr.in); nothing in the package appears to perform unrelated or covert actions, though it makes outbound HTTP requests and expects common CLI tools to be present.

Purpose & Capability

Name/description (wttr.in weather queries) align with the included SKILL.md, reference docs, and the Python script. The script implements queries to wttr.in (v2/v3), PNG/JSON/prometheus formats, moon data, multi-location queries, and examples exactly as described.

Instruction Scope

Instructions and the script only perform network requests to wttr.in (and v2/v3 subdomains) and local file writes for PNG downloads. There is no instruction to read unrelated local files or other credentials. However, the tool accepts arbitrary location strings (including IPs or domain-like inputs) and will issue HTTP requests for them — this can be used to probe reachable network hosts if a user passes such locations.

Install Mechanism

No install spec (instruction-only plus a helper script). Nothing in the package downloads or executes remote code at install time.

Credentials

The skill declares no required env vars or credentials, which is appropriate. Minor mismatch: registry metadata lists no required binaries, but the Python script invokes external tools (curl and wget) via subprocess; those runtime binaries are assumed present but not declared. No secrets or unrelated credentials are requested.

Persistence & Privilege

always is false and the skill does not attempt to modify other skills or system-wide agent settings. It does not persist credentials or request elevated privileges.

Assessment

This skill appears to be what it says: a wttr.in client. Before installing, be aware: (1) it makes outbound HTTP requests to wttr.in (and subdomains) and will request whatever host/name you provide — avoid passing sensitive internal hostnames or IPs you don't want probed; (2) the Python script invokes curl and wget at runtime, so those utilities (and Python) must be available on the host even though they aren't listed as required binaries; (3) the skill does not request credentials, and it doesn't modify other skills or system config. If you plan to allow autonomous agent invocation, remember the agent could use this skill to make network calls; if that concerns you, restrict autonomous use or run in a sandboxed environment.

wttr.in 天气查询服务

💡 快捷工具：本 skill 包含辅助脚本和参考文档

• Python 脚本: scripts/weather.py - 多功能天气查询工具（统一使用）
• 参考指南: references/quick-reference.md - 速查手册

核心功能

wttr.in 是一个功能强大的基于控制台天气预报服务，支持多种输出格式和全球位置查询。

主要能力

1. 天气预报查询 - 支持全球任意地点的天气预报
2. 多格式输出 - ANSI 终端、HTML、PNG 图片、JSON、Prometheus 指标
3. 多语言支持 - 54+ 种语言，包括中文
4. 天文信息 - 月相、日出日落时间
5. 自定义格式 - 灵活配置输出内容
6. 一行输出 - 适合集成到 tmux、状态栏等

---

基本用法

标准查询（使用 Python 脚本）

# 当前位置（基于 IP）
python scripts/weather.py

# 指定城市
python scripts/weather.py Beijing
python scripts/weather.py Shanghai
python scripts/weather.py "New+York"
python scripts/weather.py London

# 使用 ~ 查询特殊地点（景点、山脉等）
python scripts/weather.py "~Eiffel+Tower"
python scripts/weather.py "~Mount+Everest"

# 机场代码查询
python scripts/weather.py PEX    # 北京首都机场
python scripts/weather.py PVG    # 上海浦东机场
python scripts/weather.py LAX    # 洛杉矶机场

单位设置

# 公制单位（摄氏度，默认除美国外）
python scripts/weather.py Beijing -u m

# 英制单位（华氏度）
python scripts/weather.py Beijing -u u

# 公制 + m/s 风速
python scripts/weather.py Beijing -u M

---

输出格式

1. 终端 ANSI/纯文本

# 标准输出（自动检测）
python scripts/weather.py Beijing

# 强制纯文本（无颜色）
python scripts/weather.py Beijing -f plain

# 限制为标准控制台字符
python scripts/weather.py Beijing -f compact

2. PNG 图片格式

# 下载 PNG 天气图
python scripts/weather.py Beijing -f png -o weather.png

# 透明背景
python scripts/weather.py Beijing -f png --transparent -o weather.png

# 自定义透明度 (0-255)
python scripts/weather.py Beijing -f png --transparent --transparency 150

3. JSON 格式（API 使用）

# 完整 JSON 数据
python scripts/weather.py Beijing -f json

# 精简 JSON（不含小时数据）
python scripts/weather.py Beijing -f json-lite

JSON 输出包含：

• current_condition: 当前天气状况
• weather: 天气预报数据
• astronomy: 天文信息（日出、日落、月相）

4. Prometheus 监控指标

# Prometheus 格式
python scripts/weather.py Beijing -f prometheus

---

一行输出格式（format 参数）

适合集成到 tmux、weechat、状态栏等。

预设格式

# 格式 1: 当前天气
python scripts/weather.py Beijing -f oneline --custom-format "1"
# 🌦 +11⁰C

# 格式 2: 详细信息
python scripts/weather.py Beijing -f oneline --custom-format "2"
# 🌦   🌡️+11°C 🌬️↓4km/h

# 格式 3: 位置 + 天气
python scripts/weather.py Beijing -f oneline --custom-format "3"
# Beijing: 🌦 +11⁰C

# 格式 4: 完整信息
python scripts/weather.py Beijing -f oneline --custom-format "4"
# Beijing: 🌦   🌡️+11°C 🌬️↓4km/h

自定义格式（%-notation）

代码	含义	代码	含义
%c	天气状况图标	%C	天气状况文本
%x	天气符号（纯文本）	%h	湿度
%t	实际温度	%f	体感温度
%w	风速和方向	%l	位置名称
%m	月相 🌑🌒🌓🌔🌕🌖🌗🌘	%M	月龄
%p	降水量 (mm/3h)	%P	气压 (hPa)
%u	UV 指数 (1-12)	%D	黎明时间*
%S	日出时间*	%z	天顶时间*
%s	日落时间*	%d	黄昏时间*
%T	当前时间*	%Z	本地时区

*时间以本地时区显示

# 自定义输出示例
python scripts/weather.py Beijing --custom-format "%l:+%c+%t+%h+%w\n"
# Beijing: ⛅️ +7°C 45% ↓12km/h

# 多地点查询
python scripts/weather.py "Beijing:Shanghai:Guangzhou" -f oneline --custom-format "3"

---

数据丰富格式 (v2)

实验性功能，提供详细天气和天文信息。

# 使用 v2 格式
python scripts/weather.py Beijing -f v2

# 使用 Nerd Fonts（日间模式）
python scripts/weather.py Beijing -f v2-day

# 使用 Nerd Fonts（夜间模式）
python scripts/weather.py Beijing -f v2-night

包含信息：

• 温度和降水变化预测
• 月相（今天及未来 3 天）
• 当前天气状况、温度、湿度、风速、气压
• 时区信息
• 黎明、日出、正午、日落、黄昏时间
• 精确地理坐标

---

地图视图 (v3)

显示地理区域的天气信息。

# PNG 格式（浏览器）
python scripts/weather.py California -f v3

# Sixel 格式（支持内联图像的终端）
python scripts/weather.py Bayern -f v3

---

月相查询

# 当前位置月相
python scripts/weather.py -f moon

# 指定日期
python scripts/weather.py -f moon --moon-date 2025-12-25

# 作为天气查询的一部分
python scripts/weather.py Beijing --custom-format "%m"
# 🌖

---

多语言支持

# 通过语言参数设置
python scripts/weather.py Beijing -l zh
python scripts/weather.py Paris -l fr
python scripts/weather.py Berlin -l de
python scripts/weather.py Tokyo -l ja

# 查询非英文名称位置
python scripts/weather.py "станция+Восток"
python scripts/weather.py "~长城"

支持 54+ 种语言，包括：zh（中文）、en（英语）、fr（法语）、de（德语）、ru（俄语）、ja（日语）等。

---

集成示例

tmux 状态栏

# ~/.tmux.conf
set -g status-interval 60
# 使用 Python 脚本查询天气
WEATHER='#(python /path/to/weather.py Beijing -f oneline --custom-format "%%l:+%%c+%%t&period=60")'
set -g status-right "$WEATHER | %Y-%m-%d %H:%M"

Shell 别名

# ~/.bashrc 或 ~/.zshrc
alias weather='python /path/to/weather.py'
alias weather-json='python /path/to/weather.py -f json'

Python 程序集成

from weather import WeatherQuery

weather = WeatherQuery("Beijing")

# 获取 JSON 数据
data = weather.json_full()
print(f"当前温度：{data['current_condition'][0]['temp_C']}°C")

# 获取一行输出
print(weather.oneline("3"))

---

使用建议

最佳实践

1. 自动查询场景（如 tmux）设置合理更新间隔（60-300 秒）
2. 多地点查询 使用 : 分隔，配合 period 参数
3. 脚本集成 使用 JSON 格式 (format=j1) 便于解析
4. 终端显示 确保字体支持 emoji（推荐 Noto Color Emoji）

常见问题

Emoji 显示问题：

• 安装 Noto Color Emoji 字体
• 配置 fontconfig 优先使用 emoji 字体
• 运行 fc-cache -f -v 刷新字体缓存

终端不支持：

• 使用 ?T 参数强制纯文本
• 使用 ?d 限制为标准字符

---

API 参考

端点

端点	用途
wttr.in	标准天气预报
v2.wttr.in	数据丰富格式
v3.wttr.in	地图视图

查询参数

参数	说明
?m	公制单位
?u	英制单位
?M	公制 + m/s
?T	纯文本
?d	限制字符
?format=X	输出格式
?lang=XX	语言代码
period=N	更新周期（秒）

天气代码

代码	描述
113	晴朗/少云
116	局部多云
119	多云
122	阴天
176/263/266/293/296/299/302/305/308/353/356/359/386/389	各种降雨/雷暴
179/311/314/317/320/323/326/329/332/335/338/350/377	各种降雪/冰雹
143/182/248/260	雾/霾

---

相关资源

• 官方文档：https://wttr.in/:help
• 源码仓库：https://github.com/chubin/wttr.in
• 翻译贡献：/translation

---

使用流程总结

当用户需要查询天气时：

1. 确定位置 - 城市名、机场代码、特殊地点（加~）
2. 选择格式 - 终端显示、JSON API、PNG 图片
3. 设置参数 - 单位、语言、自定义输出
4. 执行查询 - 使用 curl/wget/httpie 或辅助脚本
5. 解析结果 - 直接显示或程序处理

---

辅助脚本使用

Python 脚本 (scripts/weather.py)

功能丰富的查询工具，支持多种输出格式：

# 标准天气查询
python scripts/weather.py Beijing

# JSON 格式（适合程序处理）
python scripts/weather.py Beijing -f json

# 精简 JSON（不含小时数据）
python scripts/weather.py Beijing -f json-lite

# 一行输出（适合状态栏）
python scripts/weather.py Beijing -f oneline

# 自定义格式
python scripts/weather.py Tokyo --custom-format "%l: %c %t"

# 下载 PNG 图片
python scripts/weather.py Paris -f png -o weather.png

# 详细预报 (v2)
python scripts/weather.py Beijing -f v2

# 地图视图 (v3)
python scripts/weather.py California -f v3

# 月相查询
python scripts/weather.py -f moon

# 指定日期月相
python scripts/weather.py -f moon --moon-date 2025-12-25

参数说明

参数	说明
location	地点名称（可选，默认为当前位置）
-f, --format	输出格式：terminal, json, json-lite, oneline, png, v2, v2-day, v2-night, v3, plain, compact, prometheus, moon
-l, --lang	语言代码（默认 zh）
-u, --unit	单位：m=公制，u=英制，M=公制+m/s
-o, --output	输出文件路径（PNG 格式用）
--custom-format	自定义 format 参数（%-notation）
--moon-date	月相查询日期 (YYYY-MM-DD)
--transparent	PNG 透明背景
--transparency	PNG 透明度 (0-255)

参考指南 (references/quick-reference.md)

速查手册，包含：

• 常用命令速查表
• 自定义格式代码对照
• 预设格式示例
• 支持的语言代码
• 天气代码对照表
• tmux 配置示例
• 故障排除指南

建议：查询具体参数或忘记语法时，参考 references/quick-reference.md