Critical Minerals Dependency

关键矿产依赖 MCP 服务

在 ApifyForge 上查看 | 在 Apify Store 上使用

---

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf）：

{
  "mcpServers": {
    "critical-minerals-dependency-mcp": {
      "url": "https://ryanclinton--critical-minerals-dependency-mcp.apify.actor/mcp"
    }
  }
}

---

关键矿产供应链风险情报——量化、有来源，随时可供 AI Agent 使用。此 MCP 服务通过并行协调 8 个公共数据源，为锂、钴、稀土、镓及另外 16 种关键矿产提供依赖风险评分：联合国 COMTRADE 贸易流量数据、OFAC 和 OpenSanctions 观察名单、USPTO 和 EPO 专利数据库、世界银行治理指标、IMF 宏观经济数据以及 OECD 统计数据。国防团队、电动汽车供应链管理人员和产业政策分析师用它快速回答一个问题：我们的风险敞口有多大？

7 个 MCP 工具涵盖关键矿产依赖的各个维度——从赫芬达尔-赫希曼指数（HHI）供应集中度和地缘政治脆弱性评分，到替代方案专利布局和制裁筛查。每个工具都会返回结构化 JSON，其中包含风险判定标签（从 CRITICAL_DEPENDENCY 到 LOW_RISK）、子项评分和优先级建议。无需订阅，也无需配置仪表板——连接 MCP 客户端、调用工具，即可获取情报。

可以访问哪些数据？

数据点	来源	示例
📦 按国家和商品划分的国际贸易流量	联合国 COMTRADE	中国：钴矿石出口占比 68%，HHI 为 4,840
🚫 美国财政部制裁实体	OFAC SDN 名单	Novatek PJSC——受制裁的俄罗斯能源实体
🌐 覆盖 100 多个项目的全球制裁匹配结果	OpenSanctions	在欧盟、联合国和 OFAC 项目中命中 3 条
📄 美国替代材料专利	USPTO 专利搜索	钠离子电池正极替代方案，2024 年申请
📄 欧洲替代材料专利	EPO 专利搜索	合成石墨负极，优先权日为 2023 年
🏛️ 国家治理和稳定性指标	世界银行指标	刚果民主共和国法治评分：-1.72（脆弱）
📉 生产国宏观经济风险数据	IMF 经济数据	刚果通胀率 12.3%，债务占 GDP 比率为 87%
📊 贸易和经济统计数据	OECD 统计数据	稀土贸易集中度，OECD 成员国

为什么使用 Critical Minerals Dependency MCP？

手动评估关键矿产风险敞口，需要提取 COMTRADE 数据、交叉核对制裁数据库、查阅世界银行治理评分并搜索专利申请——每种矿产都要耗费高级分析师 2-3 天完成一轮研究。商业供应链风险平台的企业许可费用每年高达 $25,000-$100,000。

此 MCP 服务通过一次工具调用自动完成整个流程。AI Agent 可以在几秒钟内评估电动汽车供应链的锂依赖情况，包括 HHI 集中度、针对刚果民主共和国矿业实体的制裁风险敞口，以及根据 USPTO/EPO 专利申请评估的替代准备度——所有结果都集中在一份结构化 JSON 响应中。

平台从第一天起即可提供以下优势：

• 定时任务 — 按固定计划每周运行供应链风险监控，跟踪评分变化
• API 访问 — 通过 Apify API 从 Python、JavaScript 或任何 HTTP 客户端触发评估
• 支出限额 — 为每次运行设置最高预算；达到限额后服务将停止计费
• 监控 — 当运行失败或返回意外判定时，接收 Slack 或电子邮件提醒
• 集成 — 通过 Webhook 将结果连接到 Zapier、Make、Google Sheets 或内部风险仪表板

功能

• 赫芬达尔-赫希曼指数（HHI）计算：基于联合国 COMTRADE 实时贸易流量计算。HHI 根据各供应国市场份额的平方计算；得分高于 2,500 时会触发 MONOPOLISTIC 标记
• 五个集中度等级：DIVERSIFIED、MODERATE、CONCENTRATED、HIGHLY_CONCENTRATED、MONOPOLISTIC；根据 HHI 和明确的阈值逻辑得出
• 地缘政治脆弱性评分：综合 OFAC 制裁命中情况、OpenSanctions 匹配结果、世界银行治理指标（法治、政治稳定性、监管质量）和 IMF 宏观经济信号
• 追踪 20 种关键矿产：锂、钴、镍、锰、石墨、稀土、钨、钛、钒、镓、锗、铟、锑、钽、铌和铂族金属
• 高风险供应国名单：明确标记中国、刚果民主共和国（DRC）、俄罗斯、缅甸、朝鲜和伊朗；来自这些国家的供应会提高地缘政治评分
• 受制裁国家暴露检测：对受制裁国家存在任何供应链依赖，都会触发更高的脆弱性信号，无论供应量多少
• 替代准备度指数：通过专利申请速度衡量；统计 USPTO 和 EPO 中包含“substitut”“replac”“alternative”“recycl”“synthetic”“sodium”“iron phosphate”“solid state”等关键词的替代材料专利
• 专利受让人多样性：作为研发广度的代理指标；申请替代材料专利的独立组织越多，表明替代方案的竞争格局越充分
• 综合依赖风险评分（0-100）：加权计算：供应集中度 35% + 地缘政治脆弱性 35% + 替代缺口 30%
• 覆盖逻辑：集中度为 MONOPOLISTIC 且制裁命中数达到 2 次或以上时，无论综合评分如何，都会自动将结论升级为 CRITICAL_DEPENDENCY
• 优先级建议：为每项评估生成具体行动建议，包括供应链多元化阈值、战略储备指导和研发投资信号
• 并行数据源编排：通过 Promise.all 同时查询全部 8 个数据源，可在 60 秒内完成完整评估
• 支出限额执行：每个工具在执行前都会检查 Actor.charge()；达到限额时返回结构化错误

关键矿产供应链风险分析的使用场景

国防与航空航天供应链评估

国防采购部门和主承包商使用 mineral_dependency_report 量化对受对手控制的矿产供应的暴露情况。只需调用一次钨或稀土钕的数据，即可获取 HHI 集中度评分、对 DRC 和中国的暴露比例以及替代准备度，为季度供应链风险审查提供结构化数据。

电动汽车电池与储能供应链监控

电池制造商和电动汽车原始设备制造商每周使用 supply_concentration_analysis 分析锂、钴、镍和石墨。随着新矿山投产或地缘政治事件改变贸易流量，HHI 评分可追踪集中度变化。supplier_country_risk 可在 DRC 治理状况恶化演变为采购危机之前发出标记。

半导体与电子材料采购

芯片制造商和电子企业使用 compare_mineral_risks 分析镓、锗和铟。这些矿产的供应近乎由中国垄断，且替代选择有限；substitution_patent_landscape 可直接根据 USPTO 和 EPO 的申请活动量化其风险状况。

大宗商品交易与结构化融资

交易部门使用 supply_concentration_analysis，将供应中断概率纳入期权和远期合约定价。执行交易或融资协议前，使用 sanctions_exposure_check 根据 OFAC 和 OpenSanctions 筛查矿业交易对手。

产业政策与政府研究

政策分析师和政府研究机构使用 industry_impact_assessment 评估哪些矿产值得纳入战略储备投资。该工具将贸易流集中度与下游产业依赖度进行映射，识别出一旦供应中断会导致最高 GDP 风险敞口的矿产。

ESG 与负责任采购合规

ESG 团队使用 supplier_country_risk 为矿产生产国的治理指标评分，作为年度负责任采购披露的一部分。世界银行的法治和政治稳定性评分，再加上制裁风险敞口，直接纳入 ESG 风险矩阵。

如何分析关键矿产依赖

1. 连接 MCP 客户端 — 将服务 URL（https://critical-minerals-dependency-mcp.apify.actor/mcp）和 Apify API 令牌添加到 Claude Desktop、Cursor 或 Windsurf 配置中。
2. 选择工具 — 使用 mineral_dependency_report 获取完整评估，或使用 supply_concentration_analysis、sanctions_exposure_check 等专项工具分析特定维度。
3. 指定矿产和背景 — 提供矿产名称（例如“钴”），还可选择提供行业背景（例如“电动汽车电池”）。服务会并行查询 8 个来源。
4. 查看结论 — 结果以结构化 JSON 格式返回，包含从 CRITICAL_DEPENDENCY 到 LOW_RISK 的结论、子评分、风险信号和具体建议。

MCP 工具

工具	价格	描述
mineral_dependency_report	$0.045	完整依赖报告：HHI 集中度、地缘政治脆弱性、替代就绪度。涵盖全部 8 个来源。结论从 CRITICAL_DEPENDENCY 到 LOW_RISK。
supply_concentration_analysis	$0.045	基于 COMTRADE 贸易流的 HHI 供应集中度分析。检测垄断型供应商，并标记单一来源依赖。
supplier_country_risk	$0.045	国家层面的脆弱性：世界银行治理指标、IMF 宏观经济数据、OFAC/OpenSanctions 筛查。
sanctions_exposure_check	$0.045	对矿业公司、生产国和贸易实体进行 OFAC 和 OpenSanctions 筛查。
substitution_patent_landscape	$0.045	替代材料和回收技术的 USPTO + EPO 专利布局。提供替代就绪指数。
industry_impact_assessment	$0.045	下游产业对供应中断的脆弱性。分析特定产业与矿产组合的贸易流。
compare_mineral_risks	$0.045	矿产综合风险概况：集中度、脆弱性、替代水平及建议。

工具输入参数

工具	参数	类型	必填	描述
mineral_dependency_report	mineral	string	是	关键矿产名称（例如，“lithium”“cobalt”“gallium”）
mineral_dependency_report	industry	string	否	行业背景（例如，“EV batteries”“semiconductor”“defense”）
supply_concentration_analysis	mineral	string	是	要分析的矿产或大宗商品
supply_concentration_analysis	region	string	否	贸易流的区域筛选条件
supplier_country_risk	country	string	是	供应国名称或 ISO 代码
supplier_country_risk	mineral	string	否	评估所涉及的矿产
sanctions_exposure_check	entity	string	是	矿业公司、国家或贸易实体名称
sanctions_exposure_check	mineral	string	否	矿产供应链背景
substitution_patent_landscape	mineral	string	是	要查找替代材料专利的矿产
substitution_patent_landscape	application	string	否	应用领域（例如，“batteries”“semiconductors”“magnets”）
industry_impact_assessment	mineral	string	是	关键矿产输入
industry_impact_assessment	industry	string	是	下游行业（例如，“EV”“semiconductor”“defense”“aerospace”）
compare_mineral_risks	mineral	string	是	要评估的矿产
compare_mineral_risks	context	string	否	行业或供应链背景

输入示例

EV 电池矿产的完整依赖报告：

{
  "tool": "mineral_dependency_report",
  "arguments": {
    "mineral": "cobalt",
    "industry": "EV batteries"
  }
}

HHI 供应集中度分析：

{
  "tool": "supply_concentration_analysis",
  "arguments": {
    "mineral": "gallium"
  }
}

对矿业实体进行制裁筛查：

{
  "tool": "sanctions_exposure_check",
  "arguments": {
    "entity": "Glencore Congo Operations",
    "mineral": "cobalt"
  }
}

输入提示

• 首次评估时使用完整依赖报告 — mineral_dependency_report 会并行运行全部 8 个数据源并返回综合评分，这是最具可操作性的起点
• 结合行业背景缩小范围 — 添加行业参数（例如，“EV batteries”“defense”）可聚焦 COMTRADE 查询，并返回更相关的贸易流数据
• 使用针对性工具进行持续监测 — 完成基线评估后，每周运行 supply_concentration_analysis，每月运行 sanctions_exposure_check，无需每次都付费获取完整报告即可跟踪变化
• 贸易前筛查实体 — 执行供应协议前，对矿业公司和贸易对手方运行 sanctions_exposure_check；OFAC 和 OpenSanctions 命中结果将以原始匹配项的形式返回，供你审核

输出示例

{
  "mineral": "cobalt",
  "compositeScore": 78,
  "verdict": "HIGH_RISK",
  "supplyConcentration": {
    "score": 82,
    "hhi": 4210,
    "topSupplierShare": 0.68,
    "supplierCount": 4,
    "concentrationLevel": "MONOPOLISTIC",
    "signals": [
      "HHI 4210 — highly concentrated supply",
      "Top supplier controls 68% of trade — single-source dependency",
      "Only 4 supplier countries — critical vulnerability"
    ]
  },
  "geopolitical": {
    "score": 74,
    "sanctionedExposure": 3,
    "fragileStateExposure": 5,
    "fragilityLevel": "FRAGILE",
    "signals": [
      "3 sanctions hits — supply chain sanctions risk",
      "Multiple fragile state indicators — governance and stability concerns",
      "Macroeconomic instability in supplier countries"
    ]
  },
  "substitution": {
    "score": 38,
    "patentCount": 47,
    "alternativeMaterials": 9,
    "readinessLevel": "DEVELOPING",
    "signals": [
      "9 alternative material patents — active substitution R&D",
      "12 recent patents — accelerating innovation in alternatives"
    ]
  },
  "allSignals": [
    "HHI 4210 — highly concentrated supply",
    "Top supplier controls 68% of trade — single-source dependency",
    "Only 4 supplier countries — critical vulnerability",
    "3 sanctions hits — supply chain sanctions risk",
    "Multiple fragile state indicators — governance and stability concerns",
    "9 alternative material patents — active substitution R&D"
  ],
  "recommendations": [
    "Diversify supply chain — HHI indicates dangerous concentration",
    "Sanctions risk — establish alternative sourcing from allied nations",
    "Single-source dependency — negotiate strategic reserves or long-term contracts",
    "Supplier country instability — build inventory buffer and monitor closely"
  ]
}

输出字段

字段	类型	描述
mineral	string	分析的矿物
compositeScore	number	依赖风险评分，范围为 0-100（分数越高 = 依赖程度越高、风险越大）
verdict	string	风险判定：CRITICAL_DEPENDENCY、HIGH_RISK、ELEVATED、MANAGEABLE 或 LOW_RISK
supplyConcentration.score	number	供应集中度评分，范围为 0-100
supplyConcentration.hhi	number	赫芬达尔-赫希曼指数（0-10,000；高于 2,500 表示高度集中）
supplyConcentration.topSupplierShare	number	最大单一供应国的市场份额（0-1）
supplyConcentration.supplierCount	number	贸易数据中不同供应国的数量
supplyConcentration.concentrationLevel	string	DIVERSIFIED、MODERATE、CONCENTRATED、HIGHLY_CONCENTRATED 或 MONOPOLISTIC
supplyConcentration.signals	array	易于理解的集中度风险信号
geopolitical.score	number	地缘政治脆弱性评分，范围为 0-100
geopolitical.sanctionedExposure	number	供应链实体在 OFAC 和 OpenSanctions 中的命中次数
geopolitical.fragileStateExposure	number	世界银行数据中的脆弱国家指标数量
geopolitical.fragilityLevel	string	STABLE、LOW_RISK、MODERATE、FRAGILE 或 CRITICAL
geopolitical.signals	array	易于理解的地缘政治风险信号
substitution.score	number	替代准备度评分，范围为 0-100（分数越高 = 可用替代品越多）
substitution.patentCount	number	在 USPTO 和 EPO 中找到的替代材料专利总数
substitution.alternativeMaterials	number	专门针对替代或置换的专利数量
substitution.readinessLevel	string	NO_ALTERNATIVES、EARLY_RESEARCH、DEVELOPING、AVAILABLE 或 MATURE
substitution.signals	array	易于理解的替代方案格局信号
allSignals	array	汇总三个评分模型的信号
recommendations	array	按优先级排列的供应链风险缓解措施

分析关键矿产依赖需要多少费用？

此 MCP 服务采用按事件付费定价方式——每次工具调用收费 $0.045。平台计算费用已包含在内。没有月度最低消费、订阅套餐或设置费。

场景	工具调用次数	每次调用费用	总费用
单种矿产快速检查	1	$0.045	$0.045
定向评估（3 个工具）	3	$0.045	$0.135
全面矿产审查（全部 7 个工具）	7	$0.045	$0.315
每周监测（5 种矿产）	35	$0.045	$1.58
月度投资组合（20 种矿产，全部工具）	140	$0.045	$6.30

你可以为每次运行设置最高支出限额以控制费用。达到预算后，服务会停止收费，并返回结构化错误，以便 Agent 妥善处理限额。

Resilinc、Everstream Analytics 和 Bloomberg Supply Chain Intelligence 等商业供应链风险平台，提供类似的关键矿产数据，每年收费 $25,000-$100,000。使用此 MCP 服务，大多数研究团队每月只需花费 $5-$20，无需任何承诺。

Apify 免费套餐包含 $5 的月度额度——在需要付款前，足以运行约 110 次工具调用。

连接此 MCP 服务

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "critical-minerals-dependency": {
      "url": "https://critical-minerals-dependency-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

Cursor / Windsurf / Cline

在编辑器的 MCP 设置面板中添加 MCP 服务：

• URL：https://critical-minerals-dependency-mcp.apify.actor/mcp
• 身份验证：使用你的 Apify API 令牌作为 Bearer token

Python（通过 HTTP）

import httpx
import json

response = httpx.post(
    "https://critical-minerals-dependency-mcp.apify.actor/mcp",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_APIFY_TOKEN",
    },
    json={
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "mineral_dependency_report",
            "arguments": {
                "mineral": "cobalt",
                "industry": "EV batteries"
            }
        },
        "id": 1
    }
)

result = response.json()
report = json.loads(result["result"]["content"][0]["text"])
print(f"Mineral: {report['mineral']}")
print(f"Verdict: {report['verdict']} (Score: {report['compositeScore']})")
print(f"HHI: {report['supplyConcentration']['hhi']}")
print(f"Recommendations: {report['recommendations']}")

JavaScript

const response = await fetch(
  "https://critical-minerals-dependency-mcp.apify.actor/mcp",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_APIFY_TOKEN",
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      method: "tools/call",
      params: {
        name: "supply_concentration_analysis",
        arguments: { mineral: "gallium" },
      },
      id: 1,
    }),
  }
);

const data = await response.json();
const result = JSON.parse(data.result.content[0].text);
console.log(`Concentration: ${result.supplyConcentration.concentrationLevel}`);
console.log(`HHI: ${result.supplyConcentration.hhi}`);
console.log(`Top supplier share: ${(result.supplyConcentration.topSupplierShare * 100).toFixed(0)}%`);

cURL

# Full dependency report
curl -X POST "https://critical-minerals-dependency-mcp.apify.actor/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"mineral_dependency_report","arguments":{"mineral":"lithium","industry":"EV batteries"}},"id":1}'

# Sanctions check for a mining entity
curl -X POST "https://critical-minerals-dependency-mcp.apify.actor/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"sanctions_exposure_check","arguments":{"entity":"Congo Dongfang Mining","mineral":"cobalt"}},"id":2}'

关键矿产依赖 MCP 的工作原理

阶段 1：并行数据源编排

每次工具调用都会使用 Promise.all 向相关数据源并行发送请求。完整的 mineral_dependency_report 工具会同时查询全部 8 个数据源：UN COMTRADE（查询内容为 {mineral} ore mineral）、OFAC 制裁名单、OpenSanctions、USPTO 专利、EPO 专利、世界银行指标、IMF 经济数据和 OECD 统计数据。即使 8 个数据源全部启用，并行执行也能将总延迟控制在 60 秒以内。supply_concentration_analysis 等专用工具仅查询 COMTRADE 和 OECD，完成速度更快。

阶段 2：HHI 集中度评分

供应集中度模型按报告国汇总 COMTRADE 贸易额，计算各国在贸易总量中的占比，并将各国占比的平方相加，计算以 0–10,000 为范围的 Herfindahl-Hirschman 指数。随后将 HHI 归一化为 0–100 分。贡献分解如下：HHI 分数（最高 50 分）+ 高风险国家敞口（最高 30 分，按对 6 个标记国家的贸易占比加权）+ 供应商多样性惩罚（最高 20 分，供应国少于 3 个时风险取最高值）。集中度等级标签根据 HHI 的 1,500、2,500、4,000 和 8,000 阈值确定。

阶段 3：地缘政治脆弱性评分

地缘政治模型结合 4 项信号：OFAC 和 OpenSanctions 命中项（最高 35 分，每项 5 分）；世界银行治理指标分析（在指标名称中扫描「governance」「stability」「rule of law」「conflict」和「fragil」等词，最高 25 分）；IMF 宏观经济不稳定性（通胀率高于 10%、债务与 GDP 之比高于 80%以及储备为负，最高 20 分）；以及 OECD 治理代理指标（有正向治理数据时扣分；未返回 OECD 数据时默认为中等分数，最高 20 分）。

阶段 4：替代准备度与综合评分

替代模型会扫描 USPTO 和 EPO 专利，查找 10 个替代材料关键词，包括「substitut」「replac」「alternative」「recycl」「synthetic」「biomass」「sodium」「iron phosphate」和「solid state」。模型统计匹配的专利数量（最高 40 分）、独立受让机构数量（作为广度代理指标，最高 30 分）以及专利总量（最高 30 分）。综合评分中，供应集中度权重为 35%，地缘政治脆弱性权重为 35%，替代分数的反向值（100 减去替代准备度）权重为 30%。如果集中度为 MONOPOLISTIC 且制裁命中项不少于 2 项，则无论综合评分如何，覆盖规则都会将结果升级为 CRITICAL_DEPENDENCY。

获得最佳结果的提示

1. 先运行 mineral_dependency_report，再深入分析。 完整报告会并行运行全部 8 个数据源，费用与任何单项工具相同，均为 $0.045。利用综合评分和信号判断哪些维度值得使用专用工具进一步分析。

2. 加入行业背景，让 COMTRADE 查询更有针对性。 在矿物名称旁注明“EV 电池”或“半导体”，可以聚焦贸易流量查询，并返回更相关的数据。仅查询矿物名称会返回范围更广的大宗商品贸易数据。

3. 使用 compare_mineral_risks 构建风险登记表。 对供应链组合中的每种矿物调用一次。每次调用都会返回作为枚举字符串的 concentrationLevel、fragilityLevel 和 substitutionLevel，便于以编程方式排序和排名。

4. 对实体名称而非仅对国家运行 sanctions_exposure_check。 按名称筛查具体矿业公司和贸易交易对手（例如“Glencore Congo Operations”），以发现国家层面筛查会遗漏的实体层面制裁命中。

5. 每周运行 supply_concentration_analysis，监测 HHI 变化。 每周保存 hhi 值，并在其达到 2,500（集中）或 4,000（高度集中）时发出警报。COMTRADE 数据会滚动更新，因此定期检查有助于发现新出现的集中趋势。

6. 结合采购周期评估替代方案的成熟度。 替代成熟度为 DEVELOPING 或 EARLY_RESEARCH，意味着可行替代方案至少还需 5-10 年。长期合同和战略储备决策应将这一点纳入考量。

7. 搭配 Waterfall Contact Enrichment，查找通过供应集中度分析识别出的矿业公司的采购联系人。

与其他 Apify Actor 组合使用

Actor	组合方式
WHOIS Domain Lookup	在使用 sanctions_exposure_check 筛查实体前，验证矿业公司域名
Company Deep Research	深入调查被识别为高集中度供应商的矿业公司
Waterfall Contact Enrichment	查找备选供应商公司的采购联系人
B2B Lead Qualifier	为通过替代分析识别出的备选供应商候选公司评分
Website Tech Stack Detector	对矿业和材料公司进行画像分析，以开展尽职调查
Trustpilot Review Analyzer	结合制裁和治理风险评分评估供应商声誉
Multi-Review Analyzer	获取跨平台声誉数据，用于矿业公司尽职调查

局限性

• COMTRADE 数据滞后 6-12 个月 — 年度贸易统计数据通常在报告期结束 6-12 个月后发布。HHI 反映的是最近可用的数据，而非实时贸易流量。
• 专利搜索基于关键词 — 替代准备度评分取决于专利标题中的关键词匹配。使用非标准术语的高度专业化申请可能会被低估。
• 无实时价格数据 — 不包含大宗商品现货价格和期货曲线。IMF 数据涵盖广泛的宏观经济指标，不包含日内或每周价格变动。
• 制裁筛查不等于法律合规 — sanctions_exposure_check 会返回 OFAC 和 OpenSanctions 中的匹配记录，供研究使用。它不能替代经过认证的 OFAC 合规筛查计划。
• 世界银行治理数据按年更新 — 治理指标每年更新一次，不反映过去 12 个月内发生的突发政治变化、政变或监管调整。
• HHI 需要足够的 COMTRADE 查询结果 — 对于较少见的商品或 COMTRADE 数据稀疏的 HS 编码，HHI 可能会低估供应商多样性。请检查输出中的 supplierCount；低于 5 时应谨慎看待。
• 无矿业公司数据库 — 此服务按国家识别供应集中度，而非按单个矿业公司识别。公司层面的集中度需要单独进行尽职调查。
• 专利受让人去重并不完善 — 替代广度评分使用字符串匹配受让人名称。子公司名称可能会导致受让人数量虚高。

集成

• Zapier — 根据采购工作流事件触发矿产风险评估，并将 HIGH_RISK 判定结果发送给供应链经理
• Make — 构建自动化监控管道，每周运行 supply_concentration_analysis，并将 HHI 漂移警报发布到 Slack
• Google Sheets — 导出包含综合评分和判定结果的矿产风险清单，用于高管报告
• Apify API — 从 Python 或 JavaScript 供应链风险平台以编程方式调用工具
• Webhooks — 接收运行完成通知，并将 CRITICAL_DEPENDENCY 判定结果推送到事件管理系统
• LangChain / LlamaIndex — 将此 MCP 服务连接到大模型 Agent，实现自主供应链风险监控和报告工作流

故障排除

已知高风险矿物的综合评分低于预期。 HHI 计算取决于 COMTRADE 返回记录的数量和质量。如果 COMTRADE 返回的数据较少（请检查 supplierCount——低于 3 表示数据有限），评分可能会低估集中度。尝试换一种方式表述矿物名称（例如，使用“rare earth elements”而非“REE”，或使用“cobaltite”而非“cobalt ore”），以提高 COMTRADE 匹配率。

sanctions_exposure_check 对我知道已受制裁的实体返回 0 条结果。 OFAC 和 OpenSanctions 使用正式的法律实体名称。尝试使用该实体的完整注册名称，包括法律形式（例如，“JSC Norilsk Nickel”，而非“Norilsk”）。也可以只尝试国家名称，以确认数据源确实能返回结果。

已知有替代方案的矿物，其替代准备度评分为 0 或很低。 该评分通过专利标题中的关键词进行匹配。某些替代技术（例如，作为锂替代品的钠离子电池）提交专利时使用的是应用技术名称，而非被替代的矿物。尝试调用 substitution_patent_landscape，并将 application 参数设为具体技术领域（例如，“batteries”“permanent magnets”），以提高专利召回率。

工具调用超时。 完整的 mineral_dependency_report 调用会并行查询 8 个数据源，在负载较高时可能需要 30-60 秒。如果 MCP 客户端配置了较短的超时时间，请将其延长至至少 90 秒。或者，使用针对单一数据源的工具（supply_concentration_analysis、sanctions_exposure_check）来更快获得响应。

会话中途返回支出限额错误。 如果达到 Apify 账户支出限额或单次运行预算，服务会以结构化 JSON 的形式返回 {"error": true, "message": "Spending limit reached"}。请在 Apify Console 中提高单次运行预算，或将评估拆分到多次运行中。

负责任地使用

• 此 MCP 服务访问的所有数据源都是公开的国际数据库（UN COMTRADE、OFAC、OpenSanctions、USPTO、EPO、World Bank、IMF、OECD）。
• 制裁筛查结果仅供研究和尽职调查之用——这不是经过认证的合规筛查服务，不应作为 OFAC 法律合规决策的唯一依据。
• 请勿使用此服务协助规避制裁、出口管制或其他贸易限制。
• 请遵守各底层数据源的服务条款。
• 有关数据使用合法性的指导，请参阅 Apify 的网络抓取指南。

常见问题

此 MCP 服务可以分析哪些关键矿物？ UN COMTRADE 中有国际贸易数据的任何矿物都可以分析。评分模型针对源代码中明确追踪的 20 种矿物进行了校准——锂、钴、镍、锰、石墨、稀土、钨、钛、钒、镓、锗、铟、锑、钽、铌以及铂族金属（铂、钯、铑、铱、铬）——但这些工具接受任何矿物名称字符串。

这里的赫芬达尔-赫希曼指数（HHI）是如何计算的？ HHI 根据 UN COMTRADE 的贸易流量值计算：将各供应国占贸易总量的份额分别平方，然后对所有供应国求和。结果范围为 0 到 10,000。评分高于 2,500 表示供应高度集中；高于 4,000 则表示接近垄断的状况。服务会将 HHI 归一化至 0-100，用于计算综合评分。 这与 Resilinc 或 Everstream Analytics 等商业平台有何不同？ 商业平台提供专职分析师团队、专有供应商数据库和事件监测服务，年费为 $25,000-$100,000。此 MCP 服务基于公开数据源提供算法驱动的供应链风险评分，每次工具调用费用为 $0.045，适合需要量化评分和信号、而非托管服务的研究团队、政策分析师和 AI Agent。

我可以在一次会话中分析多种矿产吗？ 可以。使用不同的矿产输入多次调用任意工具即可。若要进行对比风险排名，请针对每种矿产使用 compare_mineral_risks，并按 compositeScore 排序。会话不会保留状态，每次调用都是独立的。

用于 HHI 的贸易流数据有多新？ UN COMTRADE 年度数据通常滞后 6-12 个月。月度数据（如有）可能滞后 3-6 个月。supply_concentration_analysis 工具反映的是最新可用数据，而非实时贸易流数据。可用它建立基准集中度评分，并随时间监测变化。

通过此服务使用 OFAC 和 OpenSanctions 数据是否合法？ 合法。OFAC 将其特别指定国民名单作为政府公开数据库发布，而 OpenSanctions 汇总了来自 100 多个公开制裁项目的数据。出于研究和合规尽职调查目的访问并分析这些数据是合法的。此服务并非经过认证的 OFAC 合规项目——有关正式合规要求，请咨询法律顾问。

我可以设置支出上限以避免超支吗？ 可以。每次工具调用都会检查 Actor.charge()，如果达到支出上限，则返回结构化错误 JSON 对象。在触发大型评估会话之前，请在 Apify Console 中设置运行级预算。

一次典型的工具调用需要多长时间？ 专用工具（supply_concentration_analysis、sanctions_exposure_check）通常需要 15-30 秒完成。完整的 mineral_dependency_report 会并行查询全部 8 个来源，通常需要 30-60 秒完成。请将 MCP 客户端超时设置为至少 90 秒。

此服务支持哪些 MCP 客户端？ 此服务通过 StreamableHTTP 传输方式，基于 HTTP 实现 Model Context Protocol。它兼容 Claude Desktop、Cursor、Windsurf、Cline，以及任何支持基于 HTTP 的服务和 Bearer token 身份验证的 MCP 兼容客户端。

我可以在自动化 AI Agent 工作流中使用此服务吗？ 可以。此服务专为 AI Agent 使用而设计。所有工具响应均为结构化 JSON，字段名称和枚举值（CRITICAL_DEPENDENCY、HIGH_RISK 等）保持一致，便于以编程方式解析和路由。可使用 recommendations 数组中的值驱动 Agent 决策逻辑。

如果某个数据源没有返回结果，会发生什么？ 每个来源都会独立查询。如果某个来源返回空数组（由于网络问题或没有匹配记录），评分模型会跳过该来源的贡献，而不是导致整个评估失败。输出会反映实际可用的数据——请检查 supplierCount 和 patentCount，以评估数据完整性。

地缘政治脆弱性评分有多准确？ 该评分是基于世界银行治理指标值、制裁命中次数和 IMF 宏观经济信号计算出的定量代理指标，并非人类分析师的判断。对于有详尽文档记录、世界银行和 IMF 数据覆盖广泛的供应国，该评分最为可靠。对于指标覆盖较少的国家，评分会默认为中等基准值。

帮助我们改进

如果遇到问题，您可以在 Apify 账户中启用运行共享，帮助我们更快地进行调试：

1. 前往 账户设置 > 隐私
2. 启用 与公开 Actor 创建者共享运行

这样一来，出现问题时我们就能查看您的运行详情，从而更快地修复问题。您的数据仅对 Actor 开发者可见，不会公开。

支持

发现 Bug 或有功能请求？请在此 Actor 页面上的 Issues 选项卡中提交问题。如需定制矿产风险模型、企业集成或专属评分校准，请通过 Apify 平台联系我们。