dvcrn 极速数据今日油价（Jisu Oil）
基于 今日油价 API 的 OpenClaw 技能，支持：
- 省市油价查询（
/oil/query） - 全部省市列表（
/oil/province）
适合在对话中回答「今天河南的 92 号油多少钱」「列一下支持查询油价的所有省份」等问题。
使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/oil/
环境变量配置
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
脚本路径
脚本文件：skills/oil/oil.py
使用方式
1. 省市油价查询（query）
python3 skills/oil/oil.py query '{"province":"河南"}'
2. 全部省市列表（province）
python3 skills/oil/oil.py province
请求参数（/oil/query）
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| province | string | 是 | 省名（如：河南、浙江、北京） |
示例 JSON：
{
"province": "河南"
}
返回结果示例
/oil/query
脚本直接输出接口的 result 字段，典型结构（节选自官网示例）：
{
"province": "河南",
"oil89": null,
"oil92": "7.98",
"oil95": "8.52",
"oil98": "9.17",
"oil0": "7.62",
"oil90": null,
"oil93": "7.98",
"oil97": "8.52",
"updatetime": "2022-12-14 00:00:00"
}
字段含义：
| 字段名 | 类型 | 说明 |
|---|---|---|
| province | string | 省名称 |
| oil89 | string | 89 号油价 |
| oil90 | string | 90 号油价 |
| oil92 | string | 92 号油价 |
| oil93 | string | 93 号油价 |
| oil95 | string | 95 号油价 |
| oil97 | string | 97 号油价 |
| oil98 | string | 98 号油价 |
| oil0 | string | 0 号柴油价 |
| updatetime | string | 更新时间 |
/oil/province
返回值为字符串数组，每项为一个省/直辖市名称，例如：
[
"安徽",
"北京",
"广东",
"浙江",
"重庆"
]
错误返回示例
{
"error": "api_error",
"code": 201,
"message": "省份为空"
}
常见错误码
来源于 极速数据今日油价文档：
| 代号 | 说明 |
|---|---|
| 201 | 省份为空 |
| 202 | 没有信息 |
系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无权限、104 超过次数限制、105 IP 被禁止、106 IP 超限、107 接口维护中、108 接口已停用。
在 OpenClaw 中的推荐用法
- 用户：「查一下浙江今天的 92 号油价」→ 构造
query '{"province":"浙江"}'，解析oil92并附带更新时间返回。 \n - 用户：「支持哪些省份的油价查询？」→ 调用
province，将数组直接展示或用于后续自动补全。 \n - 用户：「帮我对比一下河南和广东今天油价」→ 连续调用
query两次，分别取出oil92/oil95/oil0等字段，按表格形式汇总给用户。