Qweather

使用和风天气API查询国内城市的实时天气、逐小时天气、每日天气及空气质量、预警等信息。Use when the user asks about current weather, forecasts, temperature, precipitation, wind, or air quality for a location in China。

和风天气查询

使用和风天气 API 查询中国城市天气信息。支持实时天气、逐小时预报、每日预报、空气质量及天气预警。

前置配置检查

开始任何天气查询之前，先读取 skill 目录下的 qweather_config.json 文件（与 SKILL.md 同目录）：

{
  "api_host": "",
  "api_key": ""
}

若文件不存在，或 api_host 为空，或 api_key 为空，立即退出，向用户输出：

未配置和风天气 API，请在 skill 目录下的 qweather_config.json 中填写以下信息：

- api_host：API 请求地址。登录 https://console.qweather.com ，在「设置」→「API Host」获取。
- api_key：API 密钥。登录 https://console.qweather.com ，在「凭据管理」获取。

格式示例：
{
  "api_host": "your-api-host",
  "api_key": "your-api-key"
}

配置有效后，所有 API 请求的基地址为 https://{api_host}，认证方式为在 URL 查询参数中附加 key={api_key}。

核心查询流程

必须严格遵循以下顺序，不可跳过步骤：

第一步：GeoAPI 获取城市 LocationID

使用城市名称（中文）调用 GeoAPI 获取精确位置信息。禁止直接使用城市名称调用天气 API。

GET https://{api_host}/geo/v2/city/lookup?location={城市名}&range=cn&number=3&key={api_key}

从返回的 JSON 中提取：

• location[0].id → LocationID（用于实时天气、逐日、逐小时 API）
• location[0].name → 城市名称（用于输出）
• location[0].lat → 纬度（用于空气质量、预警 API）
• location[0].lon → 经度（用于空气质量、预警 API）

若返回 location 数组为空或 code 不为 200，告知用户未找到该城市，终止查询。

第二步：根据用户关注的信息类型调用对应 API

分析用户意图，选择对应的 API。必要时可同时调用多个 API 获取完整信息。

用户关注	API 端点	参数来源
实时天气	/v7/weather/now?location={LocationID}	GeoAPI 的 id
逐小时预报	/v7/weather/24h?location={LocationID}	GeoAPI 的 id
每日预报	/v7/weather/7d?location={LocationID}	GeoAPI 的 id
空气质量	/airquality/v1/current/{lat}/{lon}	GeoAPI 的 lat/lon
天气预警	/weatheralert/v1/current/{lat}/{lon}?localTime=true	GeoAPI 的 lat/lon

详细的 API 请求格式、参数和返回字段说明见 references/api_reference.md。

第三步：格式化输出

严格按以下格式输出，字段缺失时直接省略对应行，不要臆造数据。

输出格式

实时天气

**地点**：{name}
**时间**：{obsTime 格式化，如 2026年6月10日}
**天气**：{text}
**温度**：{temp}°C
**体感温度**：{feelsLike}°C
- 降水概率：{pop}%（若从逐小时 API 获取了降水概率，否则省略此行）
- 风速：{windDir} {windScale} 级
- 相对湿度：{humidity}%
- 空气质量：{category}（若同时查询了空气质量，否则省略此行）

**来源：和风天气**

逐日预报

按日期分组，每组之间空一行：

**地点**：{name}

**{fxDate}**：{textDay}，{tempMin}°C ~ {tempMax}°C，{windDirDay} {windScaleDay} 级

**{fxDate}**：{textDay}，{tempMin}°C ~ {tempMax}°C，{windDirDay} {windScaleDay} 级

**来源：和风天气**

逐小时预报

按时间分组，每组之间空一行：

**地点**：{name}

**{fxTime 小时部分} 时**：{text}，{temp}°C，{windDir} {windScale} 级，降水概率 {pop}%

**{fxTime 小时部分} 时**：{text}，{temp}°C，{windDir} {windScale} 级，降水概率 {pop}%

**来源：和风天气**

空气质量

**地点**：{name}
**AQI**：{aqi}，{category}
- PM2.5：{pm2p5 浓度} μg/m³
- PM10：{pm10 浓度} μg/m³
- 首要污染物：{primaryPollutant}（若为空则省略）

**来源：和风天气**

天气预警

**地点**：{name}

**{headline}**
- 类型：{eventType.name}
- 状态：{messageType 状态描述}
- 生效时间：{effectiveTime} ~ {expireTime}
- 内容：{description}

**来源：和风天气**

若无预警（metadata.zeroResult 为 true），输出：

**地点**：{name}
当前无生效中的天气预警。

**来源：和风天气**

通用规则

1. 多地点或多时段分组：按地点或时间分组展示，组与组之间空一行。
2. API 失败处理：若某个 API 调用失败（code 不为 200）或返回空数据，直接省略该部分，不臆造数据。
3. 字段缺失处理：若某些字段为空或不存在，直接从输出中省略对应行，保持输出简洁。
4. 禁止替代查询：绝不要通过 WebSearch 或其他方式自行补做天气查询。所有天气数据必须来自和风天气 API。
5. 来源标注：每次输出末尾必须保留 **来源：和风天气**。
6. 时间格式化：将 ISO 8601 格式时间转换为用户友好的中文格式（如 2026年6月10日 14:30）。
7. curl 调用加 --compressed：和风天气返回 Gzip 压缩数据，curl 必须使用 --compressed 选项。
8. 查询范围：range=cn 仅查询中国境内的城市。若用户查询海外城市，告知当前仅支持中国城市查询。