用途:通过和风天气(QWeather)API 查询实时天气、天气预报与生活指数,并支持城市搜索。触发场景包括天气、气温、下雨、预报、穿什么、洗车、紫外线、UV、空气等,以及“[城市] 天气”格式的输入。
主要能力:提供 lookup(城市搜索,解析为 LocationID)、now(实时天气)、forecast(天气预报)、indices(生活指数)等命令。实时天气数据每 10-20 分钟更新一次。
使用方式:先确保已设置 QWEATHER_API_KEY 和 QWEATHER_API_HOST 环境变量,两者可在 https://console.qweather.com 获取,API host 为开发者专属,可在 https://console.qweather.com/setting 查看。在本技能目录下运行 bun scripts/weather.ts --help 查看帮助,并从 references/command-map.md 中选择匹配命令。若用户给出城市名(如“北京”“Shanghai”),先运行 lookup 获取 LocationID,再用该 LocationID 调用 now、forecast 或 indices,最后以自然语言返回结果。常见城市映射示例:北京 101010100、上海 101020100、广州 101280101、深圳 101280601;不熟悉的城市名应始终使用 lookup 获取正确 LocationID。
限制:该技能以脚本为主,不运行 MCP 服务器;必须配置上述两个环境变量;未提供其他平台支持、收费或价格信息。