贵金属实时查价

要解决什么问题

做风控、报价或对账时，你往往要在同一时刻对齐金、银、铂、钯：既要看到 COMEX/NYMEX 期货，也要对照上期所合约和国内金条、品牌零售或回收价。各站字段不统一，还要单独申请商业 API，脚本和 Agent 很难用同一套约定拉数。

本技能把查询收成零配置 CLI：可选参数、默认覆盖四大金属，标准输出为 JSON（失败时 exit code 1 且返回 {"error": "message"}），也可格式化为 Markdown 表格。同一查询在分钟级缓存内结果一致，便于脚本与 LLM 工具重复调用。

工作方式与数据

• 输入：命令行参数均可选；不传则查全部金属。
• 输出：stdout 为 JSON 或表格；成功 exit code 0。
• 行情来源：新浪财经提供 COMEX GC/SI、NYMEX XPT/XPD 及上期所 AU/AG 等，无需鉴权、偏实时；xxapi.cn 补充国内银行金条、品牌零售与回收价，更新频率多为日级。

从 Shell、Python 或 Agent 工具调用时，只需约定参数与 JSON 结构，不必维护本地插件或 API Key。

适用边界

• 上金所现货（如 AU9999） 无免费实时直连；技能用上期所 nf_AU0 等期货作近似，与现货仍有基差。
• 亚洲时段国际期货 多为 Globex，价有效但流动性弱于美盘，点差可能更宽。
• 国内铂钯零售：xxapi.cn 有品牌零售价；SGE Pt99.95 实时需商业接口。
• 避免亚秒级轮询；新浪与聚合源虽无明确限额，高频请求仍可能被封或不稳定。