← 返回 Skills 市场
1266
总下载
11
收藏
6
当前安装
7
版本数
在 OpenClaw 中安装
/install futures
功能描述
查询上期所、大商所、郑商所、中金所、广期所等期货品种价格行情。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？或类似期货行情问题时，使用本技能。
使用说明 (SKILL.md)
\r \r
极速数据期货查询（Jisu Futures）\r
\r
数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r 每个接口返回品种代号、品种名称、最新价、涨跌幅、最高/最低价、开盘价、昨收盘价、总成交量、持仓量、买卖价量、更新时间等字段，可用于期货行情展示与简单分析。\r \r
前置配置：获取 API Key\r
\r
# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/futures/futures.py`\r
\r
## 使用方式\r
\r
当前脚本通过不同子命令调用不同交易所接口：\r
\r
### 1. 上海期货交易所（/futures/shfutures）\r
\r
```bash\r
python3 skills/futures/futures.py shfutures\r
```\r
\r
### 2. 大连商品交易所（/futures/dlfutures）\r
\r
```bash\r
python3 skills/futures/futures.py dlfutures\r
```\r
\r
### 3. 郑州商品交易所（/futures/zzfutures）\r
\r
```bash\r
python3 skills/futures/futures.py zzfutures\r
```\r
\r
### 4. 中国金融期货交易所（/futures/zgjrfutures）\r
\r
```bash\r
python3 skills/futures/futures.py zgjrfutures\r
```\r
\r
### 5. 广州期货交易所（/futures/gzfutures）\r
\r
```bash\r
python3 skills/futures/futures.py gzfutures\r
```\r
\r
上述接口均无需额外 JSON 参数，脚本会直接输出接口 `result` 对象，其内部按品种名称分组，例如 `{"燃油": [...合约列表...], "铜": [...合约列表...]}`。\r
\r
## 返回结果示例（节选）\r
\r
```json\r
{\r
"燃油": [\r
{\r
"type": "FU2309",\r
"typename": "燃料油2309",\r
"price": "2948.00",\r
"changepercent": "+6.27%",\r
"changequantity": "+174",\r
"maxprice": "2975.00",\r
"minprice": "2777.00",\r
"openingprice": "2782.00",\r
"lastclosingprice": "2774.000",\r
"tradeamount": "704525",\r
"holdamount": "295063",\r
"buyamount": "47",\r
"buyprice": "2947.000",\r
"sellamount": "66",\r
"sellprice": "2948.000",\r
"updatetime": "2023-04-03 15:46:43"\r
}\r
]\r
}\r
```\r
\r
## 常见错误码\r
\r
业务错误码（参考官网错误码参照）： \r
\r
| 代号 | 说明 |\r
|------|----------|\r
| 201 | 没有信息 |\r
\r
系统错误码：\r
\r
| 代号 | 说明 |\r
|------|--------------------------|\r
| 101 | APPKEY 为空或不存在 |\r
| 102 | APPKEY 已过期 |\r
| 103 | APPKEY 无请求此数据权限 |\r
| 104 | 请求超过次数限制 |\r
| 105 | IP 被禁止 |\r
| 106 | IP 请求超过限制 |\r
| 107 | 接口维护中 |\r
| 108 | 接口已停用 |\r
\r
## 推荐用法\r
\r
1. 用户提问：「帮我看看今天 PTA、燃油、工业硅这几个期货的价格和涨跌情况。」 \r
2. 代理按交易所调用对应命令，例如：`python3 skills/futures/futures.py shfutures`、`python3 skills/futures/futures.py dlfutures`、`python3 skills/futures/futures.py gzfutures`。 \r
3. 从返回的 `result` 中按品种名称（如 `PTA`、`燃油`、`工业硅`）筛选相关合约，读取 `price`、`changepercent`、`maxprice`、`minprice`、`tradeamount` 等字段，为用户总结当前价格区间与涨跌幅，并必要时提醒仅作行情参考。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r
安全使用建议
This skill appears to do exactly what it claims: call JisuAPI futures endpoints and return the JSON result. Before installing/run: 1) Ensure you have a valid JISU_API_KEY from jisuapi.com and understand its quota/pricing. 2) Confirm your runtime has the Python 'requests' package (or add an install step) — absence will cause the script to fail. 3) Restrict the API key to this use and avoid sharing it; treat it as a secret. 4) If you require stronger assurance, review the script yourself (it’s short and readable) or run it in an isolated environment; it only performs HTTPS GETs to api.jisuapi.com and prints the returned JSON. 5) If you want a smoother installation, ask the author to include dependency/install instructions (e.g., pip install requests) so the environment is reproducible.
功能分析
Type: OpenClaw Skill
Name: futures
Version: 1.0.6
The skill is a standard implementation for querying Chinese futures market data via the JisuAPI service. The Python script (futures.py) retrieves an API key from environment variables and performs HTTPS GET requests to legitimate endpoints at api.jisuapi.com. There is no evidence of data exfiltration, unauthorized execution, or malicious prompt injection in the documentation or code.
能力评估
Purpose & Capability
Name and description say it queries futures from JisuAPI; the script issues HTTPS GET requests to api.jisuapi.com and requires JISU_API_KEY — this aligns with the stated purpose. No unrelated services or credentials are requested.
Instruction Scope
SKILL.md instructs setting JISU_API_KEY and running the included Python script with one of five subcommands. The script only reads the JISU_API_KEY env var, command-line argument, and makes requests to the documented API. It does not read other files, system configs, or send data to unknown endpoints.
Install Mechanism
There is no install spec (instruction-only), which minimizes install-time risk. The included code imports the third-party Python 'requests' library, but SKILL.md and registry metadata do not declare this dependency or provide an install step — operationally this may fail unless the runtime has requests available. No downloads from unknown URLs or archive extraction are present.
Credentials
Only JISU_API_KEY is required and declared as primaryEnv; that matches the API usage in the code. No other credentials, secrets, or system config paths are requested or accessed.
Persistence & Privilege
Skill is not always-enabled and does not request persistent/system privileges. It does not modify other skills or system configuration.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install futures - 安装完成后，直接呼叫该 Skill 的名称或使用
/futures触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.6
- 更新名称与描述，更加清晰表述技能用途和适用场景
- 优化 API 申请步骤说明，更便于用户理解
- 增加部分例句，明确用户提问场景与推荐用法
- 强化文档整体结构，无接口及返回参数变更
v1.0.5
- 文档优化：简化环境配置说明，突出获取 API Key 步骤，增加引导性说明
- 精简描述，将数据服务及数据范围介绍前置，便于理解
- 推荐用法、错误码、样例等细节未变，结构更加清晰
- 其他内容与此前版本一致，接口和使用方法无改动
v1.0.4
- Documentation update: Added a new "关于极速数据" section to introduce JisuAPI, its services, and instructions for obtaining API credentials.
- No code or behavior changes in this release.
v1.0.3
- No functional or documentation changes in this version.
- No file changes detected compared to the previous release.
v1.0.2
- No file changes detected in this release.
- Documentation and usage instructions remain up to date.
- No new features, bug fixes, or interface updates in this version.
v1.0.1
- Updated script file path from skill/futures/futures.py to skills/futures/futures.py throughout the documentation.
- Adjusted usage instructions and example commands to reflect the new script path.
- No changes to core functionality or API usage.
v1.0.0
Initial release of jisu-futures for OpenClaw:
- Provides real-time futures price queries for major Chinese exchanges including Shanghai, Dalian, Zhengzhou, China Financial Futures, and Guangzhou.
- Supports command-line usage to fetch data from each exchange via simple subcommands.
- Returns rich market data: contract code, name, latest price, change %, highs/lows, volume, open/close, bid/ask, and update time.
- Requires a JISU_API_KEY environment variable for API access.
- Includes detailed usage, environment configuration instructions, typical response examples, and error code explanations.
元数据
常见问题
Futures Inquiry - 期货查询 是什么？
查询上期所、大商所、郑商所、中金所、广期所等期货品种价格行情。当用户说：螺纹钢主力什么价？豆粕期货涨了吗？或类似期货行情问题时，使用本技能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1266 次。
如何安装 Futures Inquiry - 期货查询？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install futures」即可一键安装，无需额外配置。
Futures Inquiry - 期货查询 是免费的吗？
是的，Futures Inquiry - 期货查询 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Futures Inquiry - 期货查询 支持哪些平台？
Futures Inquiry - 期货查询 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Futures Inquiry - 期货查询？
由 极速数据（@jisuapi）开发并维护，当前版本 v1.0.6。
推荐 Skills