隆众 - 价格行情
隆众资讯大宗商品价格查询技能。隆众资讯基于商品市场的交易特点和规律，依托大宗商品交易信息基础数据优势，编制科学、权威、准确、全面的基准价格，致力于帮助全球客户监测市场运行、提高市场透明度、引导市场有序竞争，确保客户在现货、长约谈判和金融市场交易活动中据可依。价格体系覆盖企业出厂价、国内市场价、国际市场价、主营批发价、批零限价等多种价格类型，支持按品种、区域、规格、市场等维度精确定位指标并获取历史价格序列。
未配置API密钥时的引导回复
当用户查询价格数据但尚未配置API密钥时，请按以下引导回复用户：
看起来还没有配置 API 密钥。要使用隆众价格查询，需要先获取一个隆众 API Key。
获取方式： 获取 API 秘钥请打开 隆众资讯大宗商品行业Skills开放平台，点击「获取秘钥」按钮获取您的专属秘钥。
请问您是否已有隆众数据的 API Key？如果有，请直接告诉我，我会自动保存并立即为您查询。
用户提供API密钥后的处理流程
- 调用
python scripts/price_search.py --api-key "<密钥>" <子命令> ...保存密钥并执行查询 - 保存成功后告知用户密钥已保存，后续可直接使用
API 密钥配置
脚本支持多级 API Key 获取方式（按优先级）：
- 环境变量（优先级最高）：设置环境变量
oilchem_skill_auth_key - 配置文件（次优）：在
references/api_key.md文件第一行写入 API 密钥 - 对话输入（兜底）：通过
--api-key参数传入，自动保存到references/api_key.md供后续使用
查询链路（三步漏斗，重要）
价格查询按 搜索指标 → 确认指标 → 查价格 的链路进行，每一步的 ID 都来自上一步的返回值：
search(关键词) --获得指标编码--> info(确认指标含义) --锁定编码--> data(查价格数据)
- search：用品种/区域/价格类型组合词搜索指标清单（如"华东 硫磺"、"brent"、"出厂价"），返回候选指标及编码
- info：按编码查看指标完整元信息（品种/规格/价格类型/区域/市场/计价单位/标准/用途/生产工艺等），确认是否为目标指标
- data：按编码查日期区间内的价格序列（含价格值/涨跌值/涨跌幅）
严禁凭空构造或猜测指标编码，编码一律从 search 的返回值中获取。
Quick Start
# 第一步:搜索指标
python scripts/price_search.py search --keyword "华东 硫磺"
# 第二步:确认指标元信息(单次最多100个编码)
python scripts/price_search.py info --codes "ID00112688"
# 第三步:查询价格数据(单次最多50个编码)
python scripts/price_search.py data --codes "ID00112688" --start-date 2026-09-01 --end-date 2026-09-23
Query Capabilities
1. 价格数据查询
- 现货价格：实时报价、区域价格、企业报价（主流价口径）
- 历史数据：任意日期区间的价格序列、趋势分析、周期对比
- 价格类型：2企业价格 3市场价格 4国际价格 5主营批发价 6批零限价
2. 指标元信息
- 品种/规格/区域/省份/市场/会员/计价单位/标准/用途/品牌/生产工艺全维度元数据
- 多候选指标时用 info 精确筛选目标编码
3. 多指标对比
- 单次最多 50 个编码并行取数,支持多品种/多区域价格对比分析
注意事项
- 价格值为原样字符串透传,可能存在空串、横线等非数值脏值,统计计算前需自行校验
- 企业/市场/国际价格取主流价,主营批发价取中石油/中石化/中海油/中化,批零限价取批发限价
- 价格项名称与计价单位需通过 info 获取,data 接口不重复返回
- 关键词最少 2 个字符;结果不理想时更换关键词重搜(如加区域、价格类型限定词)
API Reference
详细参数说明参见 api_reference.md。
回复格式
- 价格数据以表格呈现(日期/价格/涨跌值/涨跌幅),标明指标编码与计价单位
- 需要详细标明数据所引用的指标(indexCode)与价格项口径
