极速数据统一入口（Jisu Unified）
极速数据（官网：https://www.jisuapi.com/）是基础数据 API 接口提供商，提供天气、股票、黄金、菜谱、汇率、快递、车辆等百余类接口。本 Skill 为统一入口：只需配置一个 JISU_API_KEY，即可通过 call 命令按「接口路径 + 参数」调用任意已开通的极速数据 API，无需为每个品类单独安装技能。
适合在 OpenClaw/ClawHub 中作为「结构化数据网关」使用：用户问天气、金价、股票、菜谱等，Agent 先 list 查接口，再 call 调对应 API，一次配置覆盖多类数据。
使用前请在极速数据官网申请 API Key 并开通需要的数据接口；各接口计费与额度以官网为准。
环境变量配置
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
脚本路径
脚本文件：skill/jisu/jisu.py
使用方式
1. 列出支持的接口（list）
python3 skill/jisu/jisu.py list
返回当前支持的 api 列表及简短说明，便于按需选择接口。
2. 统一调用（call）
请求 JSON：{"api": "接口路径", "params": { ... }}。params 可选，无参接口可省略。
无参示例：
python3 skill/jisu/jisu.py call '{"api":"gold/shgold"}'
python3 skill/jisu/jisu.py call '{"api":"stockindex/sh"}'
带参示例：
python3 skill/jisu/jisu.py call '{"api":"stock/query","params":{"code":"300917"}}'
python3 skill/jisu/jisu.py call '{"api":"weather/query","params":{"city":"北京"}}'
python3 skill/jisu/jisu.py call '{"api":"recipe/search","params":{"keyword":"白菜","num":10,"start":0}}'
python3 skill/jisu/jisu.py call '{"api":"exchange/convert","params":{"from":"CNY","to":"USD","amount":100}}'
返回格式与极速数据官网一致：成功时为 result 内容；失败时脚本返回 error、code、message 等。
支持的接口一览（节选）
| 分类 |
api |
说明 |
| 黄金 |
gold/shgold, gold/shfutures, gold/hkgold, gold/bank, gold/london, gold/storegold |
上海黄金/上海期货/香港/银行/伦敦/金店金价 |
| 股票 |
stock/query |
当日行情，params: code |
| 股票 |
stock/list |
列表，params: classid, pagenum, pagesize |
| 股票 |
stock/detail |
详情，params: code |
| 股票历史 |
stockhistory/query |
历史行情，params: code, startdate, enddate |
| 指数 |
stockindex/sh |
上证/深证/创业板等指数 |
| 天气 |
weather/query |
天气预报，params: city 或 cityid 等 |
| 天气 |
weather/city |
支持城市列表 |
| 菜谱 |
recipe/search, recipe/class, recipe/byclass, recipe/detail |
搜索/分类/按分类检索/详情 |
| MBTI |
character/questions |
题目，params 可选 version |
| MBTI |
character/answer |
提交答案，params: answer, version |
| 汇率 |
exchange/convert, exchange/single, exchange/currency, exchange/bank |
换算/单货币/货币列表/银行汇率 |
| 历史上的今天 |
todayhistory/query |
指定月日的历史事件，params: month, day |
| 历史天气 |
weather2/query |
按城市与日期查历史天气，params: date 必填，city 或 cityid 可选 |
| 历史天气 |
weather2/city |
历史天气支持城市列表 |
| 企业联系方式 |
enterprisecontact/query |
企业电话/邮箱等，params: company/creditno/regno/orgno 任填其一 |
| 二维码 |
qrcode/generate, qrcode/read, qrcode/template |
二维码生成/识别/模板样例 |
| 条码 |
barcode/generate, barcode/read |
条形码生成/识别，params: type, barcode, fontsize, dpi, scale, height / barcode |
| 商品条码查询 |
barcode2/query |
商品条码信息查询，params: barcode |
| ip |
ip/location |
IP 归属地，params: ip |
| 手机归属地 |
shouji/query |
手机归属地，params: shouji |
| 身份证查询 |
idcard/query |
身份证查询，params: idcard |
| 银行卡归属地 |
bankcard/query |
银行卡归属地，params: bankcard |
| 快递 |
express/query, express/type |
快递查询、快递公司类型 |
| 车型大全 |
car/brand, car/type, car/car, car/detail, car/search, car/hot, car/rank |
品牌/车型/车款/详情/搜索/热门/销量排行 |
| 限行 |
vehiclelimit/city, vehiclelimit/query |
限行城市、限行查询 |
| 车辆 |
vin/query |
VIN 车辆信息，params: vin |
| 油价 |
oil/query, oil/province |
省市油价、支持省市列表 |
| 白银 |
silver/shgold, silver/shfutures, silver/london |
上海黄金/上海期货/伦敦银价 |
| 万年历 |
calendar/query, calendar/holiday, huangli/date |
万年历、节假日、黄历 |
| 新闻 |
news/get, news/channel |
新闻、新闻频道 |
| 经纬度地址转换 |
geoconvert/coord2addr, geoconvert/addr2coord |
坐标转地址、地址转坐标 |
| 周公解梦 |
dream/search |
搜索，params: keyword, pagenum, pagesize |
| 热搜榜单 |
hotsearch/weibo, hotsearch/baidu, hotsearch/douyin |
微博/百度/抖音热搜榜 |
| 期货 |
futures/shfutures, futures/dlfutures, futures/zzfutures, futures/zgjrfutures, futures/gzfutures |
上海/大连/郑州/中金所/广州期货价格 |
完整列表以 jisu.py list 输出为准；参数含义见 极速数据 API 文档。
错误返回
- 未配置 Key：脚本直接报错退出。
api 缺失：{"error": "missing_param", "message": "api is required"}。- 接口返回业务错误：
{"error": "api_error", "code": xxx, "message": "..."}。
- 网络/解析错误：
request_failed / http_error / invalid_json。
在 OpenClaw 中的推荐用法
- 用户提问：「北京天气怎么样」「300917 股票今天多少钱」「人民币兑美元汇率」等。
- 代理先调用
python3 skill/jisu/jisu.py list 确认接口名，再按需调用 call，例如：
python3 skill/jisu/jisu.py call '{"api":"weather/query","params":{"city":"北京"}}'
python3 skill/jisu/jisu.py call '{"api":"stock/detail","params":{"code":"300917"}}'
python3 skill/jisu/jisu.py call '{"api":"exchange/convert","params":{"from":"CNY","to":"USD","amount":1}}'
- 从返回的
result 中抽取关键字段，用自然语言回复用户；若需更多接口参数说明，可引导用户查看极速数据官网文档。
1---2name: jisu-unified3description: 极速数据统一入口，一个 JISU_API_KEY 调用多类接口：黄金、股票、天气、历史天气、菜谱、汇率、MBTI、快递、车辆、历史上的今天、企业联系方式等，便于 Agent 一站式拉取结构化数据。4---56# 极速数据统一入口（Jisu Unified）78**极速数据**（官网：[https://www.jisuapi.com/](https://www.jisuapi.com/)）是基础数据 API 接口提供商，提供天气、股票、黄金、菜谱、汇率、快递、车辆等百余类接口。本 Skill 为**统一入口**：只需配置一个 `JISU_API_KEY`，即可通过 `call` 命令按「接口路径 + 参数」调用任意已开通的极速数据 API，无需为每个品类单独安装技能。910适合在 OpenClaw/ClawHub 中作为「结构化数据网关」使用：用户问天气、金价、股票、菜谱等，Agent 先 `list` 查接口，再 `call` 调对应 API，一次配置覆盖多类数据。1112使用前请在极速数据官网申请 API Key 并开通需要的数据接口；各接口计费与额度以官网为准。1314## 环境变量配置1516```bash17# Linux / macOS18export JISU_API_KEY="your_appkey_here"1920# Windows PowerShell21$env:JISU_API_KEY="your_appkey_here"22```2324## 脚本路径2526脚本文件：`skill/jisu/jisu.py`2728## 使用方式2930### 1. 列出支持的接口（list）3132```bash33python3 skill/jisu/jisu.py list34```3536返回当前支持的 `api` 列表及简短说明，便于按需选择接口。3738### 2. 统一调用（call）3940请求 JSON：`{"api": "接口路径", "params": { ... }}`。`params` 可选，无参接口可省略。4142**无参示例：**4344```bash45python3 skill/jisu/jisu.py call '{"api":"gold/shgold"}'46python3 skill/jisu/jisu.py call '{"api":"stockindex/sh"}'47```4849**带参示例：**5051```bash52python3 skill/jisu/jisu.py call '{"api":"stock/query","params":{"code":"300917"}}'53python3 skill/jisu/jisu.py call '{"api":"weather/query","params":{"city":"北京"}}'54python3 skill/jisu/jisu.py call '{"api":"recipe/search","params":{"keyword":"白菜","num":10,"start":0}}'55python3 skill/jisu/jisu.py call '{"api":"exchange/convert","params":{"from":"CNY","to":"USD","amount":100}}'56```5758返回格式与极速数据官网一致：成功时为 `result` 内容；失败时脚本返回 `error`、`code`、`message` 等。5960## 支持的接口一览（节选）6162| 分类 | api | 说明 |63|----------|------------------------|------|64| 黄金 | gold/shgold, gold/shfutures, gold/hkgold, gold/bank, gold/london, gold/storegold | 上海黄金/上海期货/香港/银行/伦敦/金店金价 |65| 股票 | stock/query | 当日行情，params: code |66| 股票 | stock/list | 列表，params: classid, pagenum, pagesize |67| 股票 | stock/detail | 详情，params: code |68| 股票历史 | stockhistory/query | 历史行情，params: code, startdate, enddate |69| 指数 | stockindex/sh | 上证/深证/创业板等指数 |70| 天气 | weather/query | 天气预报，params: city 或 cityid 等 |71| 天气 | weather/city | 支持城市列表 |72| 菜谱 | recipe/search, recipe/class, recipe/byclass, recipe/detail | 搜索/分类/按分类检索/详情 |73| MBTI | character/questions | 题目，params 可选 version |74| MBTI | character/answer | 提交答案，params: answer, version |75| 汇率 | exchange/convert, exchange/single, exchange/currency, exchange/bank | 换算/单货币/货币列表/银行汇率 |76| 历史上的今天 | todayhistory/query | 指定月日的历史事件，params: month, day |77| 历史天气 | weather2/query | 按城市与日期查历史天气，params: date 必填，city 或 cityid 可选 |78| 历史天气 | weather2/city | 历史天气支持城市列表 |79| 企业联系方式 | enterprisecontact/query | 企业电话/邮箱等，params: company/creditno/regno/orgno 任填其一 |80| 二维码 | qrcode/generate, qrcode/read, qrcode/template | 二维码生成/识别/模板样例 |81| 条码 | barcode/generate, barcode/read | 条形码生成/识别，params: type, barcode, fontsize, dpi, scale, height / barcode |82| 商品条码查询 | barcode2/query | 商品条码信息查询，params: barcode |83| ip | ip/location | IP 归属地，params: ip |84| 手机归属地 | shouji/query | 手机归属地，params: shouji |85| 身份证查询 | idcard/query | 身份证查询，params: idcard |86| 银行卡归属地 | bankcard/query | 银行卡归属地，params: bankcard |87| 快递 | express/query, express/type | 快递查询、快递公司类型 |88| 车型大全 | car/brand, car/type, car/car, car/detail, car/search, car/hot, car/rank | 品牌/车型/车款/详情/搜索/热门/销量排行 |89| 限行 | vehiclelimit/city, vehiclelimit/query | 限行城市、限行查询 |90| 车辆 | vin/query | VIN 车辆信息，params: vin |91| 油价 | oil/query, oil/province | 省市油价、支持省市列表 |92| 白银 | silver/shgold, silver/shfutures, silver/london | 上海黄金/上海期货/伦敦银价 |93| 万年历 | calendar/query, calendar/holiday, huangli/date | 万年历、节假日、黄历 |94| 新闻 | news/get, news/channel | 新闻、新闻频道 |95| 经纬度地址转换 | geoconvert/coord2addr, geoconvert/addr2coord | 坐标转地址、地址转坐标 |96| 周公解梦 | dream/search | 搜索，params: keyword, pagenum, pagesize |97| 热搜榜单 | hotsearch/weibo, hotsearch/baidu, hotsearch/douyin | 微博/百度/抖音热搜榜 |98| 期货 | futures/shfutures, futures/dlfutures, futures/zzfutures, futures/zgjrfutures, futures/gzfutures | 上海/大连/郑州/中金所/广州期货价格 |99100完整列表以 `jisu.py list` 输出为准；参数含义见 [极速数据 API 文档](https://www.jisuapi.com/)。101102## 错误返回103104- 未配置 Key：脚本直接报错退出。105- `api` 缺失：`{"error": "missing_param", "message": "api is required"}`。106- 接口返回业务错误：`{"error": "api_error", "code": xxx, "message": "..."}`。107- 网络/解析错误：`request_failed` / `http_error` / `invalid_json`。108109## 在 OpenClaw 中的推荐用法1101111. 用户提问：「北京天气怎么样」「300917 股票今天多少钱」「人民币兑美元汇率」等。1122. 代理先调用 `python3 skill/jisu/jisu.py list` 确认接口名，再按需调用 `call`，例如： 113 `python3 skill/jisu/jisu.py call '{"api":"weather/query","params":{"city":"北京"}}'` 114 `python3 skill/jisu/jisu.py call '{"api":"stock/detail","params":{"code":"300917"}}'` 115 `python3 skill/jisu/jisu.py call '{"api":"exchange/convert","params":{"from":"CNY","to":"USD","amount":1}}'` 1163. 从返回的 `result` 中抽取关键字段，用自然语言回复用户；若需更多接口参数说明，可引导用户查看极速数据官网文档。
dvcrn