---
name: weather-calendar-life-data
description: "当用户需要使用咕咕数据公开 API 完成生活服务、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
---

# 天气日历与生活数据 Skill

面向天气、空气质量、农历节气、日出日落和生活信息查询的公开 API 组合。

## 业务场景

用于天气查询、空气质量、农历节气、日出日落、生活服务和内容日历。适合出行提醒、城市页面、活动运营、农业生活服务和日历工具。

- 数据范围：覆盖天气、空气质量、农历、节气、日出日落和日期相关生活数据。
- 关键数据维度：时间维度：日期、时区、农历、节气、日出、日落和更新时间。；地点维度：城市、区域、经纬度和天气观测地点。；天气维度：天气现象、温度、空气质量、风力和生活提示。

## 何时使用

- 查询城市天气、空气质量、日出日落、农历和节气信息。
- 为内容日历、活动安排、出行提醒和生活服务生成上下文。
- 把日期、地区和天气信息组合成用户可读提示。

## 不适用场景

- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

## 用户需要提供的信息

- 城市、地区、日期、时间范围、天气或日历类型。
- 是否需要天气、空气质量、农历节气、日出日落或生活提醒。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先确定城市、日期或经纬度。
2. 再按天气、空气质量、节气或日出日落选择接口。
3. 面向日历或提醒产品时，把天气和节气数据组合展示。

## 参数传递关系

- 城市或坐标先确定天气观测位置，再组合日期查询天气、空气质量、农历、节气和日出日落。
- 跨天、跨城市或历史查询需要统一日期和时区。
- 天气结果应保留观测时间，生活建议只基于当前数据生成。

## 典型任务模板

- 城市天气：输入城市和日期；输出天气、温度、空气质量和更新时间。
- 内容日历：输入日期和城市；输出农历、节气、日出日落和天气摘要。
- 出行提醒：输入地点和日期；输出天气风险和官方复核提示。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 全国天气预报信息

- 业务角色：天气预报
- 调用阶段：天气
- 接口地址：`GET https://api.gugudata.com/weather/weatherinfo`
- 产出用途：用于查询全国天气预报信息。
- 参数来源：时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
- 接口详情页：https://www.gugudata.com/api/details/weatherinfo
- 接口 Markdown：https://www.gugudata.com/api/details/weatherinfo/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `code` | 是 | `string` | YOUR_VALUE | 地区编码，可通过前置接口查询获得地区编码。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `days` | 否 | `integer` | 1 | 获取天气预报的天数，默认为1，即为当天数据。最大值为7。 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

### 全国城市实时空气质量指数

- 业务角色：空气质量
- 调用阶段：天气
- 接口地址：`GET https://api.gugudata.com/Weather/AirQuality`
- 产出用途：用于查询全国城市实时空气质量指数。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果
- 接口详情页：https://www.gugudata.com/api/details/airquality
- 接口 Markdown：https://www.gugudata.com/api/details/airquality/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `city` | 是 | `string` | 北京 | 需要查询的中国城市名称，例如：北京、南京、上海、广州、深圳。接口会按城市名称实时匹配当前可用监测数据，不再限制为旧版固定城市列表。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |

### 农历与二十四节气

- 业务角色：农历节气
- 调用阶段：日历
- 接口地址：`GET https://api.gugudata.com/weather/lunarcalendar`
- 产出用途：用于查询农历与二十四节气。
- 参数来源：时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
- 接口详情页：https://www.gugudata.com/api/details/lunarcalendar
- 接口 Markdown：https://www.gugudata.com/api/details/lunarcalendar/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `date` | 是 | `string` | YOUR_VALUE | 请求转换的日期，格式为: yyyymmdd，如 20220101 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

### 日出与日落时间

- 业务角色：日出日落
- 调用阶段：天文
- 接口地址：`GET https://api.gugudata.com/weather/sunriseandsunset`
- 产出用途：用于查询日出与日落时间。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果；时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
- 接口详情页：https://www.gugudata.com/api/details/sunrisesunset
- 接口 Markdown：https://www.gugudata.com/api/details/sunrisesunset/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `city` | 是 | `string` | YOUR_VALUE | 查询城市名，如北京、南京、保定等 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `date` | 是 | `string` | YOUR_VALUE | 查询的日期，格式为 yyyymmdd，如 20220701 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

## 数据校验与使用边界

- 天气和空气质量有时效性，输出时必须说明观测或更新时间。
- 跨城市、跨时区或历史日期查询要明确日期口径。
- 生活建议只作为提醒，不替代专业预警和官方公告。

## 输出建议

- 输出天气结果时包含城市、日期、天气、温度和更新时间。
- 内容日历场景可组合农历、节气、天气和日出日落。
- 对极端天气和空气质量提示官方信息复核。

## 常见问题

- 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
- 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
- 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
- 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
- 问：天气日历与生活数据 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。