ClawHub

Weather Forecast - 全国天气预报

v1.0.2

查询实时天气、7 天预报、24 小时逐时、空气质量与生活指数，可查城市列表。当用户说：上海今天天气怎样？北京明天会下雨吗？带伞吗？或类似天气预报问题时，使用本技能。

⭐ 9· 409·0 current·0 all-time
by极速数据@jisuapi
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description, SKILL.md and the code all target the JisuAPI weather endpoints. Requiring JISU_API_KEY and python3 is expected for this functionality. The code talks only to https://api.jisuapi.com which matches the documented provider.
✓
Instruction Scope
SKILL.md instructs the agent to run the included script with a small JSON payload or the 'cities' subcommand. The instructions do not request unrelated files, system configuration, or additional environment variables beyond JISU_API_KEY.
ℹ
Install Mechanism
There is no install spec (instruction-only), which minimizes install risk. The shipped script uses the Python 'requests' library but the SKILL.md does not document installing that dependency; this is an operational omission (not a security risk) that could cause runtime failures if 'requests' is missing.
✓
Credentials
Only JISU_API_KEY is required (declared as primaryEnv). No other secrets, system config paths, or unrelated credentials are requested; this is proportionate to calling the Jisu weather API.
✓
Persistence & Privilege
The skill is not forced-always, does not request system-wide changes, and does not modify other skills. It runs when invoked by the agent or user per platform defaults.
Assessment
This skill appears to do only what it claims: call JisuAPI for weather. Before installing: 1) Confirm you trust the JisuAPI provider and protect your JISU_API_KEY (do not share it publicly). 2) Ensure the runtime has python3 and the 'requests' package installed (SKILL.md doesn't list this dependency). 3) Expect the skill to make outbound HTTPS requests to api.jisuapi.com (network egress required). 4) Check your JisuAPI account rate limits and permissions. If you require stricter guarantees, review the script locally (it's small and readable) before enabling autonomous use.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

☁️ Clawdis
Binspython3
EnvJISU_API_KEY
Primary envJISU_API_KEY
latestvk97dxd0cqzeg0zzcmpw4rq2b4x8455ne
409downloads
9stars
3versions
Updated 2w ago
v1.0.2
MIT-0
极速数据@jisuapi
latest
Download

极速数据全国天气预报（Jisu Weather）

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。

  • 当前实时天气
  • 未来 7 天预报（daily）
  • 未来 24 小时逐小时预报（hourly）
  • 空气质量 AQI 指数
  • 生活指数（穿衣、运动、洗车等）
  • 城市列表（/weather/city）

前置配置：获取 API Key

  1. 前往 极速数据官网 注册账号
  2. 进入 全国天气预报 API 页面，点击「申请数据」
  3. 在会员中心获取 AppKey
  4. 配置 Key：
# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/weather/weather.py

使用方式

1. 按城市名称查询天气

python3 skills/weather/weather.py '{"city":"杭州"}'

2. 按城市 ID / 城市代号查询

python3 skills/weather/weather.py '{"cityid":111}'
python3 skills/weather/weather.py '{"citycode":"101260301"}'

3. 按经纬度或 IP 查询

# 经纬度：纬度在前，逗号分隔
python3 skills/weather/weather.py '{"location":"39.983424,116.322987"}'

# IP
python3 skills/weather/weather.py '{"ip":"8.8.8.8"}'

请求 JSON 中至少要提供 city / cityid / citycode / location / ip 中的一个字段。

4. 获取支持的城市列表

对应极速数据 /weather/city 接口：

python3 skills/weather/weather.py cities

返回值为数组，每一项形如：

{
  "cityid": "1",
  "parentid": "0",
  "citycode": "101010100",
  "city": "北京"
}

请求参数（天气查询 JSON）

字段名类型必填说明
citystring否城市名称，如 "杭州"
cityidint否城市 ID
citycodestring否城市天气代号
locationstring否经纬度，纬度在前，逗号分隔，如 "39.983424,116.322987"
ipstring否IP 地址

至少需要提供上述 5 个字段中的一个，否则脚本会报错并退出。

示例请求：

{
  "city": "安顺",
  "cityid": 111,
  "citycode": "101260301"
}

返回结果示例

脚本直接输出接口的 result 字段（JSON），典型结构与官网示例一致：

{
  "city": "安顺",
  "cityid": "111",
  "citycode": "101260301",
  "date": "2015-12-22",
  "week": "星期二",
  "weather": "多云",
  "temp": "16",
  "temphigh": "18",
  "templow": "9",
  "humidity": "55",
  "windspeed": "14.0",
  "winddirect": "南风",
  "windpower": "2级",
  "index": [
    {
      "iname": "空调指数",
      "ivalue": "较少开启",
      "detail": "您将感到很舒适，一般不需要开启空调。"
    }
  ],
  "aqi": {
    "aqi": "35",
    "primarypollutant": "PM10",
    "quality": "优",
    "timepoint": "2015-12-09 16:00:00"
  },
  "daily": [
    {
      "date": "2015-12-22",
      "week": "星期二",
      "sunrise": "07:39",
      "sunset": "18:09",
      "night": {
        "weather": "多云",
        "templow": "9",
        "img": "1",
        "winddirect": "无持续风向",
        "windpower": "微风"
      },
      "day": {
        "weather": "多云",
        "temphigh": "18",
        "img": "1",
        "winddirect": "无持续风向",
        "windpower": "微风"
      }
    }
  ],
  "hourly": [
    {
      "time": "16:00",
      "weather": "多云",
      "temp": "14",
      "img": "1"
    }
  ]
}

当出现错误（如城市不存在、没有天气信息等）时，脚本会输出：

{
  "error": "api_error",
  "code": 202,
  "message": "城市不存在"
}

常见错误码

来源于极速数据文档部分错误码：

代号说明
201城市和城市ID和城市代号都为空
202城市不存在
203此城市没有天气信息
210没有信息

系统错误码：

代号说明
101APPKEY 为空或不存在
102APPKEY 已过期
103APPKEY 无请求权限
104请求超过次数限制
105IP 被禁止

推荐用法

  1. 用户输入：「查下杭州今天的天气和未来几天下雨情况」。
  2. 代理构造 JSON：{"city":"杭州"} 并调用：
    python3 skills/weather/weather.py '{"city":"杭州"}'
  3. 从返回 JSON 中提取当前天气、daily / hourly 的降水相关字段，为用户生成自然语言总结。
  4. 如需城市编码或城市 ID，可先调用：python3 skills/weather/weather.py cities，在结果中查找目标城市后再发起天气查询。

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

  • 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
  • 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
  • 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
  • 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
  • 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
  • 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。

Comments

Loading comments...