天气查询 - 即刻数据

天气查询。根据省份、城市、区县查询当前天气实况、未来7天和未来15天天气预报。适用场景：用户说“查一下深圳南山区天气”“广州未来7天天气怎么样”“北京未来15天会不会下雨”等。数据由即刻数据（jikeapi.cn）开放接口提供。

Security Scan

This skill is coherent with its stated purpose (querying weather from jikeapi.cn using an AppKey); it requires python3 and an AppKey and the included script calls the jikeapi.cn endpoints — only minor metadata/env inconsistencies were found.

Purpose & Capability

Name, description, required binary (python3), and required primary credential (AppKey) match the included script and declared functionality (current/7d/15d weather from jikeapi.cn). No unrelated credentials or binaries are requested.

Instruction Scope

SKILL.md instructs the agent to extract region info and run the provided script, which is consistent. The script will also read a local .env file (if present) to obtain the AppKey and accepts a CLI --key override; that behavior is not fully emphasized in SKILL.md. The script uses the API base host api.jikeapi.cn by default and makes direct HTTP GET requests to jikeapi endpoints (appkey is sent as a query parameter).

Install Mechanism

This is an instruction-only skill with a small Python script included; there is no install spec, no downloads, and no archive extraction — low install risk.

Credentials

The declared required env is JIKE_WEATHER_QUERY_KEY (primary). The code also accepts JIKE_APPKEY as an alternative and will read JIKE_API_BASE_URL if set — these extra env names are not fully reflected in registry metadata. Overall the only secret needed is the AppKey, which is proportional to the purpose.

Persistence & Privilege

The skill does not request always:true and does not modify other skills or system-wide config. It runs on-demand and requires no elevated or persistent privileges.

Assessment

This skill appears to do what it says: call jikeapi.cn weather endpoints and format results. Before installing, consider: 1) The AppKey (JIKE_WEATHER_QUERY_KEY or JIKE_APPKEY) is required — treat it as a secret and avoid reusing high-privilege keys. 2) The script will send the AppKey as a URL query parameter (visible in logs and network captures); if you need stricter confidentiality, check whether the provider supports headers or other auth. 3) The script will read a local .env file and the JIKE_API_BASE_URL env var (undocumented in registry metadata) — remove or protect any .env files you don't want read. 4) Confirm you trust the homepage (https://www.jikeapi.cn/) and the provider’s API behavior and limits. 5) You can pass a key via --key for temporary use. Overall the footprint is small and proportionate, but verify/trust the AppKey handling and the API host before use.

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

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

---

前置配置：获取 AppKey

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

export JIKE_WEATHER_QUERY_KEY=你的AppKey

也可以使用通用 Key：

export JIKE_APPKEY=你的AppKey

---

使用方法

当前天气

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

未来7天

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

未来15天

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

输出 JSON

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

直接调用 API

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天预报的接口路由、参数解析和结果展示。