- name
- Gold Price Inquiry - 黄金价格查询
- description
- 查询上金所、上期所、港金、银行渠道、伦敦金银及品牌金店等多源黄金参考价；涨跌字段可辅助说明走势（非投资建议）。当用户说：今天黄金多少钱一克？银行金条什么价？周大福金价？伦敦金走势怎样？或类似金价问题时，使用本技能。
- metadata
- { "openclaw": { "emoji": "🥇", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }
国内金价查询 · 极速数据黄金（Gold）
数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。
何时使用本技能（触发条件）
当用户询问以下任一主题时，应触发本技能：
- 金价、黄金价格、今日金价、现在黄金多少钱
- 金店价格、品牌金价（如周大福、老凤祥等零售价）
- 银行金条、银行黄金、账户金、纸黄金（对应接口：银行账户黄金等）
- 国际金价、伦敦金、伦敦银、外盘黄金
- 黄金走势、金价涨跌、未来趋势、后市怎么看（基于返回的涨跌幅、开高低收等作说明，勿编造未在数据中出现的结论）
技术前提： 使用脚本 skills/gold/gold.py，配置环境变量 JISU_API_KEY。
接口与数据范围：
- 上海黄金交易所价格（
/gold/shgold） - 上海期货交易所价格（
/gold/shfutures） - 香港金银业贸易场价格（
/gold/hkgold） - 银行账户黄金价格（
/gold/bank） - 伦敦金、银价格（
/gold/london） - 金店金价（
/gold/storegold）
前置配置：获取 API Key
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"脚本路径
脚本文件：skills/gold/gold.py
使用方式
1. 上海黄金交易所价格（/gold/shgold）
python3 skills/gold/gold.py shgold2. 上海期货交易所价格（/gold/shfutures）
python3 skills/gold/gold.py shfutures3. 香港金银业贸易场价格（/gold/hkgold）
python3 skills/gold/gold.py hkgold4. 银行账户黄金价格（/gold/bank）
python3 skills/gold/gold.py bank5. 伦敦金、银价格（/gold/london）
python3 skills/gold/gold.py london6. 金店金价（/gold/storegold）
# 不指定日期：默认当天（仅支持最近 7 天）
python3 skills/gold/gold.py storegold
# 指定日期：
python3 skills/gold/gold.py storegold '{"date":"2023-09-20"}'请求 JSON（仅 storegold 支持）：
{
"date": "2023-09-20"
}返回结果示例（节选）
上海黄金交易所价格
[
{
"type": "Au(T+D)",
"typename": "黄金延期",
"price": "238.05",
"openingprice": "241.00",
"maxprice": "241.50",
"minprice": "237.50",
"changepercent": "-0.90%",
"lastclosingprice": "240.22",
"tradeamount": "45998.0000",
"updatetime": "2015-10-26 15:29:13"
}
]上海期货交易所价格
[
{
"type": "AU1512",
"typename": "黄金1512",
"price": "238.7",
"changequantity": "-0.949",
"buyprice": "238.7",
"buyamount": "5",
"sellprice": "238.75",
"sellamount": "100",
"tradeamount": "210274",
"openingprice": "241.5",
"lastclosingprice": "239.649",
"maxprice": "241.5",
"minprice": "237.799",
"holdamount": "188302",
"increaseamount": "-6086"
}
]银行账户黄金价格
[
{
"typename": "人民币黄金",
"midprice": "408.92",
"buyprice": "408.67",
"sellprice": "409.17",
"maxprice": "409.16",
"minprice": "407.58",
"updatetime": "2020-07-21 12:19:54"
}
]伦敦金、银价格
[
{
"type": "伦敦金",
"price": "1818.6899",
"changepercent": "+0.05%",
"changequantity": "+0.9199",
"openingprice": "1817.95",
"maxprice": "1820.29",
"minprice": "1815.8199",
"lastclosingprice": "1817.77",
"updatetime": "2020-07-21 12:23:35"
}
]金店金价
{
"list": [
{
"store_name": "周大福",
"date": "2023-09-20",
"gold": "612.00",
"platinum": "387.00",
"goldbar": "602.00",
"jewelry": "612.00",
"solid_gold": null
}
]
}当无数据时，脚本会输出：
{
"error": "api_error",
"code": 201,
"message": "没有信息"
}常见错误码
来源于 极速数据黄金文档：
| 代号 | 说明 |
|---|---|
| 201 | 没有信息 |
系统错误码：
| 代号 | 说明 |
|---|---|
| 101 | APPKEY 为空或不存在 |
| 102 | APPKEY 已过期 |
| 103 | APPKEY 无请求权限 |
| 104 | 请求超过次数限制 |
| 105 | IP 被禁止 |
推荐用法
- 比价类：用户问「现在黄金价格大概是多少？上海金交所和金店各多少？」
- 依次调用：python3 skills/gold/gold.py shgold、python3 skills/gold/gold.py storegold（可按需加 bank、london）。 - 从结果中摘取常见品种（如 AU9999、黄金延期）及主流金店克价，对比 国内盘面 vs 金店零售 vs 银行渠道。
- 走势 / 趋势类：用户问「黄金走势怎样？后面还会涨吗？」
- 拉取 shgold、shfutures、london、bank 等中与用户场景相关的接口，用返回的 涨跌幅、昨收、最高最低 等字段归纳「当前数据反映的强弱」，并明确 数据时效与免责；禁止捏造 API 未提供的预测结论。
关于极速数据
极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：
- 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
- 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
- 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
- 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
- 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
- 位置服务：基站查询，经纬度地址转换，坐标系转换
在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。