从这里开始
一种矿产埋在哪里、在哪里被挖出来、在哪里被加工成可用材料,是三张不同的地图——而供应链真正断裂的地方,是最后那一张。 一个国家可以坐拥巨量储量却依然无能为力,因为精炼产能在别人手里。出口管制几乎总是卡在加工环节,而不是矿山,所以本数据集把两者严格分开:mine——矿石从地下开采出来的地方。refinery——它被加工成可用材料的地方。
读懂集中度数字
每个阶段都带有一个按惯例的 0–10,000 标度的 HHI。数值越高,意味着主导国家越少。作为粗略参照:一种分散在众多生产者手中的商品会落在数百量级;而一种由单一国家掌握全球大部分产能的商品会高达数千。访问方式。 由
GET /api/supply-chain/v1/get-mineral-production 与 MCP get_mineral_production 提供。两者均需 Pro 订阅。数据源
两者均允许衍生合计值。快照存储的是国家份额,而非任一出版物的镜像。
词表
商品清单是定义于scripts/shared/ 的受控集合,初始包含战略组:稀土、锂、钴、铜、镍、石墨、钨、镓、锗、氦、铝和铀。USGS 名称为规范名;BGS 名称通过别名映射解析,因此同一商品绝不会以两种拼写被重复计算。
阶段
每种商品最多携带两个独立快照:mine——开采refinery——加工
mine 或 refinery 属性,既不是 null,也不是显式的不可用阶段对象。客户端应检查字段是否存在,而不是用 === null 判断。
集中度
按阶段,赫芬达尔-赫希曼指数基于国家份额计算:改变解读的三个字段
withheld——来源方压制了该国数据,通常出于商业保密。其份额是未知,而非零。阶段上的 withheldCount 说明受影响的行数;withheld 计数高的阶段,其 HHI 的可信度相应降低。
residual——USGS 的”其他国家”合计项。它是一个集合桶而非生产国,且经常大到足以超过真实国家:在铜的开采产量中它以约 13% 位列第三,将秘鲁挤出前三。排名前请将其滤除,如需展示则单独呈现。
year——每个商品-阶段各自选择自己的年份。由 BGS 补充的商品可能比快照的 dataYear 落后数年。行自身的 year 具有权威性;信封的 dataYear 只是整个集合中最新的年份。
更新频率
年度。种子程序在每次 USGS 发布后写入supply-chain:mineral-production:v1。两次发布之间快照刻意保持静止——年中看到看似陈旧的 dataYear 是预期状态,而非种子程序故障。
