天气查询 - 即刻数据#

数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力，帮助开发者和 AI 客户端快速接入可靠数据服务。

根据省份、城市、区县查询： 当前天气、未来7天天气、未来15天天气。

---

前置配置：获取 AppKey#

1. 登录即刻数据官网。
2. 申请「天气查询」接口。
3. 在「个人中心 -> 我的 API 应用」中获取接口 AppKey。
4. 配置 Key：

bash

export JIKE_WEATHER_QUERY_KEY=你的AppKey

也可以使用通用 Key：

bash

export JIKE_APPKEY=你的AppKey

---

使用方法#

当前天气#

bash

python3 scripts/weather_query.py --province 广东省 --city 深圳市 --area 南山区

未来7天#

bash

python3 scripts/weather_query.py --type 7d --province 广东省 --city 深圳市 --area 南山区

未来15天#

bash

python3 scripts/weather_query.py --type 15d --province 广东省 --city 深圳市

输出 JSON#

bash

python3 scripts/weather_query.py --type 7d --province 广东省 --city 深圳市 --json

直接调用 API#

text

GET https://api.jikeapi.cn/v1/weather/query/by-area?province=广东省&city=深圳市&area=南山区&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/weather/query/7d?province=广东省&city=深圳市&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/weather/query/15d?province=广东省&city=深圳市&appkey=YOUR_APPKEY

---

AI 使用步骤#

当用户询问天气、温度、降雨、未来几天天气时：

1. 提取地区：识别省份、城市、区县；区县可选。
2. 判断类型：未说明天数时查当前天气；提到未来7天查 --type 7d；提到未来15天查 --type 15d。
3. 调用脚本：执行 python3 scripts/weather_query.py --type <类型> --province <省> --city <市> [--area <区>]。
4. 展示结果：当前天气返回温度、体感、湿度、风向风力；预报返回日期、天气、温度、降水和风力。

参数说明#

参数必填说明示例--type否now 当前天气、 7d 未来7天、 15d 未来15天--type 7d``--province是省份名称广东省``--city是城市名称深圳市``--area否区县名称南山区``--json否输出 JSON--json

返回字段#

字段含义weather天气现象temp当前温度feels_like体感温度humidity湿度wind_dir风向wind_scale风力等级obs_time观测时间list未来天气列表

错误处理#

情况处理方式未配置 AppKey提醒用户配置 JIKE_WEATHER_QUERY_KEY 或 JIKE_APPKEY地区缺失提醒用户提供省份和城市未查询到天气提示用户检查省市区名称是否准确网络超时建议稍后重试或检查网络

---

脚本位置#

scripts/weather_query.py：封装了当前天气、7天预报、15天预报的接口路由、参数解析和结果展示。