核心用法
jisu-gold 是极速数据（JisuAPI）黄金价格查询的 OpenClaw 封装技能，通过 Python 脚本调用官方 API，支持六大类黄金行情数据获取：
| 数据类型 | 命令 | 覆盖范围 |
|---------|------|---------|
| 上海黄金交易所 | `shgold` | Au(T+D)、AU9999、Au100g 等延期及现货品种 |
| 上海期货交易所 | `shfutures` | AU 系列期货合约，含持仓量、成交量 |
| 香港金银业贸易场 | `hkgold` | 港元计价黄金行情 |
| 银行账户黄金 | `bank` | 工/农/中/建等银行纸黄金买卖报价 |
| 伦敦金/银 | `london` | 国际现货黄金、白银美元报价 |
| 金店零售金价 | `storegold` | 周大福、老凤祥、周生生等品牌首饰金/投资金条价（支持近7天历史） |
使用示例
# 查询上金所实时行情
python3 skills/gold/gold.py shgold
# 查询特定日期金店价格
python3 skills/gold/gold.py storegold '{"date":"2024-01-15"}'返回 JSON 格式数据，包含开盘价、最高价、最低价、涨跌幅、更新时间等完整字段。
显著优点
1. 数据源权威：上海黄金交易所、上期所为国内黄金定价核心市场；伦敦金银连接国际市场基准
2. 场景覆盖全：从机构交易（期货、延期）到个人消费（金店首饰），从境内（银行纸黄金）到境外（伦敦金）形成完整价格矩阵
3. 接入成本低：免费额度可满足个人开发者日常查询需求，AppKey 申请流程简单
4. 响应标准化：统一 JSON 输出，便于自动化处理和跨平台集成
潜在缺点与局限性
- 时效性非 tick 级：API 数据存在分钟级延迟，不适用于高频套利交易决策
- 金店数据回溯受限：仅支持最近 7 天历史查询，无法获取长期价格走势
- 区域覆盖不全：缺少纽约 COMEX 期货、东京工业品交易所等国际主要市场
- 依赖第三方服务：极速数据平台稳定性直接影响可用性，存在单点故障风险
- 免费额度有限：高频调用需购买套餐，企业级应用需评估成本
适合人群
- 个人投资者：关注黄金定投、纸黄金买卖的普通用户
- 财经内容创作者：需要实时金价数据支撑文章、报告撰写
- 电商/零售从业者：监测金店金价波动，辅助采购或定价决策
- 金融科技开发者：构建黄金行情监控、价格提醒类应用
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据延迟风险 | API 非实时行情，与交易所实际成交价可能存在偏差 | 关键交易决策需交叉验证交易所官方数据 |
| API 密钥泄露 | JISU_API_KEY 环境变量若配置不当可能被窃取 | 使用专用只读密钥，避免硬编码，定期轮换 |
| 服务中断风险 | 第三方平台故障或额度耗尽导致调用失败 | 实现降级逻辑，缓存近期有效数据 |
| 合规使用风险 | 商业用途需确认极速数据授权范围 | 详细阅读 API 服务协议，必要时购买企业套餐 |
> ⚠️ 本技能返回数据仅供参考，不构成投资建议。黄金交易请以交易所、银行实际成交价格为准。