核心用法
jisu-gold 是基于极速数据（JisuAPI）的黄金价格查询工具，支持 Python3 环境运行，需配置 JISU_API_KEY 环境变量。提供六大黄金市场数据源：
| 市场 | 命令 | 数据源特点 |
|:---|:---|:---|
| 上海黄金交易所 | `shgold` | 国内现货黄金定价基准，含 Au(T+D)、Au9999 等品种 |
| 上海期货交易所 | `shfutures` | 黄金期货合约实时行情，含持仓量、成交量 |
| 香港金银业贸易场 | `hkgold` | 香港现货黄金市场报价 |
| 银行账户黄金 | `bank` | 工行、建行等纸黄金买卖价格 |
| 伦敦金/银 | `london` | 国际现货黄金白银美元报价 |
| 金店零售价 | `storegold` | 周大福、老凤祥等品牌金饰实时价格（支持近7天历史查询） |
显著优点
- 数据源权威：直连上海黄金交易所、上期所等官方渠道，非爬虫二次加工
- 市场覆盖全：从国际伦敦金到国内金店零售，满足投资、消费、研究多场景
- 使用门槛低：Python 单文件脚本，无需复杂依赖，返回结构化 JSON
- 金店历史回溯：唯一支持近7天历史金店价格对比的技能
潜在局限
- 需要 API Key：极速数据采用会员制，免费额度有限（具体以官网为准），高频调用需付费
- 无 WebSocket 推送：仅支持轮询查询，非实时流式行情
- 金店数据延迟：零售端价格更新频率低于交易所，可能存在 10-30 分钟滞后
- 无技术分析指标：纯原始价格数据，需自行计算均线、波动率等
适合人群
- 个人投资者：快速比价银行纸黄金与金店实物金价差
- 财经自媒体：获取标准化金价数据制作每日行情简报
- 贵金属研究者：对比国内外市场价差（如沪金 vs 伦敦金汇率折算后套利空间）
- 中小企业采购：追踪金店批发价走势，优化珠宝库存决策
常规风险
| 风险类型 | 说明 | 缓释建议 |
|:---|:---|:---|
| API 配额耗尽 | 免费额度用尽后请求失败 | 监控调用频率，设置降级缓存 |
| 数据延迟误导 | 行情非交易所毫秒级切片 | 关键交易决策需交叉验证官方终端 |
| 环境变量泄露 | `JISU_API_KEY` 误提交至代码仓库 | 使用 `.env` 文件或密钥管理服务 |
| 金店价格口径差异 | 各品牌工费、纯度标注不一 | 明确对比"足金999"标准克价 |
---
> 认证状态：极速数据为国内老牌数据服务商，数据源经交易所授权，但本技能未执行动态安全扫描，建议生产环境使用前进行代码审计。