天气日历与生活数据 Skill

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

业务场景

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

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

何时使用

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

不适用场景

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

用户需要提供的信息

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

推荐工作流

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

参数传递关系

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

典型任务模板

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

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 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 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。