Logistics Freight Intelligence

物流货运情报 MCP 服务

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

---

快速开始

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

{
  "mcpServers": {
    "logistics-freight-intelligence-mcp": {
      "url": "https://ryanclinton--logistics-freight-intelligence-mcp.apify.actor/mcp"
    }
  }
}

---

面向 AI Agent 的物流货运情报——此 MCP 服务通过 8 个专用工具提供实时路线中断预测、贸易制裁筛查、货运成本波动分析和边境延误预测。它专为 3PL、报关行、供应链分析师和货运代理打造，帮助他们将结构化风险数据直接集成到 AI 工作流中。

此服务并行协调 9 个权威数据源——NOAA、GDACS、OFAC、OpenSanctions、UN COMTRADE、Exchange Rates、BLS、World Bank 和 OECD——并将每次查询综合为带评分和标签的结果。每条响应都包含数值风险评分（0-100）、分类结论，以及一组通俗易懂的信号，用于说明评分依据。无需订阅，无需管理 API 密钥，也无需配置仪表板——连接 MCP 客户端即可开始查询。

可以访问哪些数据？

数据点	来源	示例
📦 国际贸易流	UN COMTRADE	来自中国的电子产品贸易额为 $4.2B，HHI：3,100
🚫 美国制裁名单	OFAC SDN	“Baltic Freight GmbH”——匹配分数 87
🌐 多司法管辖区监控名单	OpenSanctions	实体被标记于 EU + UN + OFAC 数据集中
🌩 强天气预警	NOAA	3 条极端风暴预警——墨西哥湾沿岸货运走廊
🌋 自然灾害事件	GDACS	红色预警气旋——南海港口区域
💱 货币汇率	Exchange Rate Tracker	USD/CNY CV：6.4%——货运成本不确定性高
📊 生产者价格指数	BLS	运输业 PPI 上涨 8.2%——直接影响货运成本的因素
🏗 贸易物流指标	World Bank	物流绩效指数：2.4（基础设施水平低）
📈 国际贸易统计	OECD	贸易量收缩 -7%——路线需求受阻
⚠ 路线中断评分	综合模型	评分：72 / 严重——启用应急路线
🛡 贸易合规等级	HHI + 制裁	需要审核——贸易 HHI 为 1,800 + 1 条监控名单匹配
🧮 供应链脆弱性	加权综合评分	评分：61 / 高风险——4 个叠加信号

为什么使用物流货运情报 MCP 服务？

如今，要将供应链风险功能集成到 AI Agent 中，通常需要整合六个或更多 API、规范化其架构、编写评分逻辑并持续更新凭据——还没开始编写任何业务逻辑。这通常需要两到四周的工程工作，而数据集每天都在变化。

此 MCP 服务可省去这些开发时间。将它连接到 Claude Desktop、Cursor 或任何兼容 MCP 的客户端后，你的 Agent 就能像调用计算器一样调用结构化货运情报工具。此服务会透明地处理并行数据获取、规范化和风险评分。

• 定时任务 — 通过 Apify 内置的调度程序，零基础设施成本地执行每日路线中断扫描或每周承运商筛查
• API 访问 — 使用 Apify API，通过 Python、JavaScript 或任何 HTTP 客户端以编程方式调用任意工具
• 无需管理凭据 — 所有 9 个底层数据源均通过 Apify 的 Actor 基础设施访问；除 Apify 令牌外，无需 API 密钥
• 监控 — 通过 Apify Webhook，在供应链脆弱性评分超过指定阈值时接收 Slack 或电子邮件提醒
• 集成 — 将结果传入 Zapier、Make、HubSpot 或任何兼容 Webhook 的目标，供下游物流工作流使用

功能

• 8 个专用 MCP 工具，涵盖航线中断、贸易合规、承运商风险、货运成本波动、边境延误预测、受制裁货物筛查、航线比较和综合脆弱性评估
• 9 个并行数据源，每次查询均使用 Promise.all 同时获取数据——NOAA、GDACS、OFAC、OpenSanctions、UN COMTRADE、Exchange Rate Tracker、BLS、World Bank 和 OECD
• 赫芬达尔-赫希曼指数（HHI）贸易集中度评分——计算贸易伙伴的市场集中度；HHI 高于 2,500 表示供应链高度集中
• 筛查 12 种与物流相关的天气威胁类型，涵盖每条 NOAA 警报中的风暴、洪水、飓风、龙卷风、暴风雪、冰冻、强风、雾、降雪、霜冻、高温和沙尘
• 复合灾害检测——极端天气与活跃灾害事件同时发生时，会在单项评分的基础上触发级联中断乘数
• OFAC 匹配置信度阈值——仅将评分达到 70+（合规）或 60+（边境延误）的匹配计为制裁命中，从而减少误报
• 贸易航线分析中的 8 个受制裁辖区标记：伊朗、朝鲜、叙利亚、古巴、克里米亚、俄罗斯、缅甸和朝鲜民主主义人民共和国
• 加权综合评分——供应链脆弱性评分汇总航线中断（25%）、贸易合规（30%）、货运成本（25%）和边境延误（20%）
• 5 级分类结论，各维度均提供通俗易懂的信号：中断风险分为 CLEAR/MINOR/MODERATE/SEVERE/CRITICAL；合规程度从 COMPLIANT 到 BLOCKED；成本波动性从 STABLE 到 EXTREME
• 承运商风险评估采用合规与成本 60/40 的加权模型，得出 ACCEPTABLE、ELEVATED 或 HIGH_RISK 判定
• 航线比较引擎接受 2-5 条贸易航线，按所有维度为每条航线评分，并返回排序列表和风险最低的推荐航线
• 支出限额执行——每次工具调用都会在获取数据前检查 Apify 费用限额，防止超出预算
• 待机模式服务——在 Apify 平台上作为持久运行的 HTTP 服务，为客户端连接提供亚秒级 MCP 握手

物流货运情报的应用场景

为供应链团队优化贸易航线

比较运输走廊的供应链分析师需要客观、多维度的风险数据，以便向管理层说明航线决策的依据。compare_trade_routes 工具最多接受 5 条航线，例如美国-上海、美国-鹿特丹和美国-孟买，并返回涵盖中断风险、合规、成本波动和边境延误的比较排名。推荐字段会自动显示综合风险最低的航线。

为报关行和货运代理进行制裁合规筛查

每周筛查数百票货物的报关行，如果收货人或托运人出现在 OFAC SDN 名单或国际观察名单上，将面临严重的法律责任。sanctions_cargo_check 工具会同时使用 OFAC 和 OpenSanctions 筛查实体，并可选择筛查其目的地国家，返回匹配数量、合规等级以及触发结果的具体信号。

货运成本预测与套期保值

CFO 和物流财务团队需要在锁定费率或货币对冲之前，获取前瞻性的货运成本信号。freight_cost_volatility 工具结合货币变异系数分析、BLS 燃料和运输生产者价格指数（PPI）数据，以及 OECD 贸易量指标，生成波动性评分和状态标签（从 STABLE 到 EXTREME），并提供具体信号，说明哪项驱动因素占主导。

面向准时制运营的边境延误规划

采用精益库存模式的制造商无法承受意外的海关延误。border_delay_predictor 工具结合 NOAA 和 GDACS 的实时警报与制裁筛查积压指标，预测特定口岸或港口的延误风险，让采购团队有时间提前清关文件，或绕开受影响的口岸。

面向采购团队的承运商尽职调查

采购团队在引入新的物流合作伙伴时，需要证据证明承运商未受到制裁影响，并且运营路线经过经济稳定的地区。carrier_risk_assessment 工具根据制裁筛查（OFAC + OpenSanctions + COMTRADE）和经济稳定性（BLS 运输生产者价格指数）生成综合承运商风险评分，并给出有据可依的“可接受”“较高”或“高风险”判定。

供应链韧性报告

风险管理团队为管理层、保险公司或监管机构准备季度韧性报告时，需要一个有证据支持、可供审计的单一脆弱性数值。supply_chain_vulnerability 工具会针对贸易实体或运输走廊运行全部 9 个数据源，并返回完整的综合评分细目、各维度评分、所有信号和具体建议，可直接粘贴到董事会演示文稿或审计报告中。

如何使用 Logistics Freight Intelligence MCP Server

1. 连接 MCP 客户端 — 将服务 URL https://logistics-freight-intelligence-mcp.apify.actor/mcp 添加到 MCP 客户端配置中。对于 Claude Desktop，请将其添加到 claude_desktop_config.json 的 mcpServers 下。添加 Apify API 令牌作为 Bearer 标头。
2. 选择工具 — 用自然语言向 AI 助手提问，例如“墨西哥湾沿岸货运走廊的路线中断风险如何？”或“根据 OFAC 和 OpenSanctions 筛查 Meridian Cargo Solutions。”助手会自动选择合适的工具。
3. 查看结构化响应 — 每个工具都会返回数值评分、类别标签，以及解释评分依据的具体信号列表。supply_chain_vulnerability 工具还会返回可执行的建议。
4. 自动执行定期检查 — 使用 Apify 的调度程序，按每日或每周的频率运行脆弱性评估。设置 Webhook，在评分超过风险阈值时通知团队。

MCP 工具

工具	价格	参数	描述
route_disruption_forecast	$0.045	region	根据天气和自然灾害预测路线中断风险
trade_compliance_screen	$0.045	entity，commodity（可选）	筛查制裁、观察名单匹配情况和贸易集中风险
carrier_risk_assessment	$0.045	carrier	评估承运商合规性和经济稳定性风险
freight_cost_volatility	$0.045	corridor，commodity（可选）	根据货币、燃油和贸易指标预测成本波动
border_delay_predictor	$0.045	crossing	根据天气和合规筛查积压预测港口和边境延误
sanctions_cargo_check	$0.045	entity，destination（可选）	根据 OFAC + OpenSanctions 筛查托运人、收货人或目的地
compare_trade_routes	$0.045	routes（数组，2-5）	按综合风险为 2-5 条贸易路线排序，并推荐最安全的路线
supply_chain_vulnerability	$0.045	entity	基于全部 9 个数据源进行综合脆弱性评估并提供建议

工具参数详情

参数	类型	必填	工具	描述
region	string	是	route_disruption_forecast	地理区域或货运走廊，例如 “Gulf Coast” 或 “US-Mexico border”
entity	string	是	trade_compliance_screen、carrier_risk_assessment、sanctions_cargo_check、supply_chain_vulnerability	要筛查或评估的实体名称、国家或贸易伙伴
commodity	string	否	trade_compliance_screen、freight_cost_volatility	HS 编码或商品描述，例如 “electronics” 或 “8471”
corridor	string	是	freight_cost_volatility	贸易走廊或货币对，例如 “US-EU” 或 “USD/CNY”
crossing	string	是	border_delay_predictor	边境口岸、港口或海关检查站名称
destination	string	否	sanctions_cargo_check	用于额外筛查的目的地国家或港口
routes	string[]	是	compare_trade_routes	由 2-5 个贸易路线字符串组成的数组，例如 ["US-Shanghai", "US-Rotterdam"]
carrier	string	是	carrier_risk_assessment	要评估的承运商名称或货运实体

输入示例

筛查贸易实体是否涉及制裁并进行合规检查：

{
  "tool": "trade_compliance_screen",
  "arguments": {
    "entity": "Meridian Cargo Solutions GmbH",
    "commodity": "electronics"
  }
}

比较三条贸易路线：

{
  "tool": "compare_trade_routes",
  "arguments": {
    "routes": ["US-Shanghai", "US-Rotterdam", "US-Mumbai"]
  }
}

全面评估供应链脆弱性：

{
  "tool": "supply_chain_vulnerability",
  "arguments": {
    "entity": "Taiwan Strait electronics corridor"
  }
}

输出示例

以下是 supply_chain_vulnerability 对高风险贸易实体返回的代表性响应：

{
  "entity": "Taiwan Strait electronics corridor",
  "compositeScore": 63,
  "verdict": "HIGH_RISK",
  "routeDisruption": {
    "score": 48,
    "weatherAlerts": 7,
    "disasterCount": 2,
    "disruptionLevel": "MODERATE",
    "signals": [
      "7 weather alerts — widespread logistics impact",
      "2 high-severity disasters — supply chain infrastructure at risk"
    ]
  },
  "tradeCompliance": {
    "score": 72,
    "sanctionHits": 1,
    "tradePartnerHHI": 2810,
    "complianceLevel": "HIGH_RISK",
    "signals": [
      "1 sanctions/watchlist matches — trade compliance review required",
      "Trade HHI 2810 — highly concentrated supply chain"
    ]
  },
  "freightCost": {
    "score": 55,
    "currencyVolatility": 25,
    "commodityPressure": 16,
    "economicStress": 10,
    "volatilityLevel": "MODERATE",
    "signals": [
      "Currency CV 6.4% — high freight cost uncertainty",
      "PPI 8.2% — producer cost inflation impacts freight rates"
    ]
  },
  "borderDelay": {
    "score": 44,
    "weatherDisruptions": 4,
    "complianceRisk": 1,
    "delayLevel": "MODERATE",
    "signals": [
      "4 severe weather/disaster events — port/border closure risk",
      "1 watchlist flags — customs enhanced screening delays likely"
    ]
  },
  "allSignals": [
    "7 weather alerts — widespread logistics impact",
    "2 high-severity disasters — supply chain infrastructure at risk",
    "1 sanctions/watchlist matches — trade compliance review required",
    "Trade HHI 2810 — highly concentrated supply chain",
    "Currency CV 6.4% — high freight cost uncertainty",
    "PPI 8.2% — producer cost inflation impacts freight rates",
    "4 severe weather/disaster events — port/border closure risk",
    "1 watchlist flags — customs enhanced screening delays likely"
  ],
  "recommendations": [
    "Highly concentrated supply chain — diversify sourcing to reduce dependency"
  ]
}

输出字段

字段	类型	描述
entity	string	已评估的实体、走廊或路线
compositeScore	number	加权脆弱性评分，范围为 0-100（中断 25%、合规 30%、货运成本 25%、边境延误 20%）
verdict	string	总体风险标签：LOW_RISK、MANAGEABLE、ELEVATED、HIGH_RISK 或 CRITICAL
routeDisruption.score	number	路线中断子评分，范围为 0-100
routeDisruption.weatherAlerts	number	与物流相关的 NOAA 天气警报数量
routeDisruption.disasterCount	number	GDACS 当前灾害事件数量
routeDisruption.disruptionLevel	string	CLEAR、MINOR、MODERATE、SEVERE 或 CRITICAL
routeDisruption.signals	string[]	对中断因素的通俗说明
tradeCompliance.score	number	贸易合规子评分，范围为 0-100
tradeCompliance.sanctionHits	number	达到置信度阈值的 OFAC 和 OpenSanctions 匹配项数量
tradeCompliance.tradePartnerHHI	number	贸易伙伴集中度的赫芬达尔-赫希曼指数（0-10000）
tradeCompliance.complianceLevel	string	COMPLIANT、LOW_RISK、REVIEW、HIGH_RISK 或 BLOCKED
tradeCompliance.signals	string[]	具体合规调查结果
freightCost.score	number	货运成本波动子评分，范围为 0-100
freightCost.currencyVolatility	number	货币变异系数评分（0-25）
freightCost.commodityPressure	number	OECD/World Bank 贸易指标压力评分
freightCost.economicStress	number	BLS PPI 和燃料成本压力评分
freightCost.volatilityLevel	string	STABLE、LOW、MODERATE、HIGH 或 EXTREME
freightCost.signals	string[]	具体成本波动因素
borderDelay.score	number	边境延误风险子评分，范围为 0-100
borderDelay.weatherDisruptions	number	口岸附近的恶劣天气与高级别警报灾害事件数量
borderDelay.complianceRisk	number	可能导致筛查积压风险的监控名单标记数量
borderDelay.delayLevel	string	MINIMAL、LOW、MODERATE、HIGH 或 SEVERE
borderDelay.signals	string[]	具体边境延误因素
allSignals	string[]	汇总所有维度的信号
recommendations	string[]	达到关键阈值后触发的可执行建议

漏洞评分参考

评分	判定	说明
0-19	LOW_RISK	各维度识别出的风险极低
20-39	MANAGEABLE	存在一些天气或合规信号；适合正常运营
40-59	ELEVATED	存在活跃的干扰因素或制裁风险；建议加强监控
60-79	HIGH_RISK	多种风险因素叠加；建议采取缓解措施
80-100	CRITICAL	多因素导致严重脆弱性；需要立即采取运营应对措施

运行物流货运情报查询需要多少费用？

此 MCP 服务采用按事件付费定价——每次工具调用费用为 $0.045。费用包含计算成本。只有成功调用工具时才会收费；连接和空闲时间免费。

场景	工具调用次数	单次调用费用	总费用
检查单条路线中断情况	1	$0.045	$0.045
对 5 家承运商进行制裁筛查	5	$0.045	$0.23
比较 3 条贸易路线	3	$0.045	$0.14
每周漏洞扫描（10 条走廊）	10	$0.045	$0.45
每月合规筛查（100 个实体）	100	$0.045	$4.50

你可以为每次运行设置最高支出限额以控制费用。达到预算后，服务将停止收费。Apify 免费计划每月包含 $5 额度——按每次 $0.045 计算，每月约可免费调用 111 次工具。

相比之下，Oracle Transportation Management 或 SAP TM 等企业 TMS 平台每月费用为 $2,000-5,000，而 World-Check 等独立制裁筛查服务每月费用为 $500-1,500。使用此 MCP，大多数物流团队每月只需花费 $5-20，且无需订阅。

如何连接此 MCP 服务

Claude Desktop

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

{
  "mcpServers": {
    "logistics-freight-intelligence": {
      "url": "https://logistics-freight-intelligence-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

Cursor / Windsurf / Cline

将你的 MCP 客户端配置指向：

https://logistics-freight-intelligence-mcp.apify.actor/mcp

将你的 Apify API 令牌作为 Bearer 授权标头传入。此服务采用标准的 MCP Streamable HTTP 传输协议，与任何符合规范的客户端兼容。

Python

import httpx

MCP_URL = "https://logistics-freight-intelligence-mcp.apify.actor/mcp"
APIFY_TOKEN = "YOUR_APIFY_TOKEN"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {APIFY_TOKEN}",
}

# Screen a trade entity for sanctions and compliance
payload = {
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
        "name": "trade_compliance_screen",
        "arguments": {
            "entity": "Meridian Cargo Solutions GmbH",
            "commodity": "electronics"
        }
    },
    "id": 1
}

response = httpx.post(MCP_URL, json=payload, headers=headers)
result = response.json()

content = result["result"]["content"][0]["text"]
import json
data = json.loads(content)

print(f"Compliance level: {data['complianceLevel']}")
print(f"Sanction hits: {data['sanctionHits']}")
print(f"Trade HHI: {data['tradePartnerHHI']}")
for signal in data["signals"]:
    print(f"  - {signal}")

JavaScript

const MCP_URL = "https://logistics-freight-intelligence-mcp.apify.actor/mcp";
const APIFY_TOKEN = "YOUR_APIFY_TOKEN";

async function assessSupplyChainVulnerability(entity) {
  const response = await fetch(MCP_URL, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": `Bearer ${APIFY_TOKEN}`,
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      method: "tools/call",
      params: {
        name: "supply_chain_vulnerability",
        arguments: { entity },
      },
      id: 1,
    }),
  });

  const result = await response.json();
  const data = JSON.parse(result.result.content[0].text);

  console.log(`Entity: ${data.entity}`);
  console.log(`Composite score: ${data.compositeScore} — ${data.verdict}`);
  console.log(`Route disruption: ${data.routeDisruption.disruptionLevel}`);
  console.log(`Trade compliance: ${data.tradeCompliance.complianceLevel}`);
  console.log(`Freight cost: ${data.freightCost.volatilityLevel}`);
  console.log(`Border delay: ${data.borderDelay.delayLevel}`);
  for (const rec of data.recommendations) {
    console.log(`Recommendation: ${rec}`);
  }
}

assessSupplyChainVulnerability("Taiwan Strait electronics corridor");

cURL

# Screen a carrier for sanctions and economic risk
curl -X POST "https://logistics-freight-intelligence-mcp.apify.actor/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "carrier_risk_assessment",
      "arguments": {
        "carrier": "Pinnacle Freight Services Ltd"
      }
    },
    "id": 1
  }'

# Compare trade routes
curl -X POST "https://logistics-freight-intelligence-mcp.apify.actor/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "compare_trade_routes",
      "arguments": {
        "routes": ["US-Shanghai", "US-Rotterdam", "US-Mumbai"]
      }
    },
    "id": 2
  }'

物流货运情报 MCP 的工作原理

数据收集阶段

收到工具调用后，服务会立即使用 Promise.all 并行请求相关数据源——所有 actor 调用均并行执行，超时时间为 120 秒，每个调用分配 512 MB 内存。对于 supply_chain_vulnerability，全部 9 个 actor 会同时运行：NOAA 和 GDACS 提供天气与灾害数据，OFAC 和 OpenSanctions 用于制裁筛查，UN COMTRADE 用于分析双边贸易流量，Exchange Rate Tracker 提供货币数据，BLS、World Bank 和 OECD 提供经济指标。对于 route_disruption_forecast 等专用工具，只会调用与相应维度相关的 2 个 actor。

风险评分阶段

每个维度都使用专用评分模型，并设有明确的权重和封顶子分，防止任何单一信号占据主导。

路线中断：NOAA 最多计 40 分（每条极端预警计 10 分，每条严重预警计 4 分，最高 40 分）；GDACS 最多计 30 分（每起红色／橙色灾害计 10 分，每起事件计 3 分，最高 30 分）；复合灾害检测最多计 30 分——极端天气与正在发生的灾害同时出现时，触发 15 分的连锁效应加成。

贸易合规：对 OFAC 置信度设置 70 及以上的阈值，并测试是否属于 OpenSanctions 数据集（最多计 35 分）；根据 COMTRADE 双边流量计算贸易伙伴 HHI，阈值分别为 1,000、1,500 和 2,500（最多计 30 分）；检查所有贸易伙伴是否涉及 8 个受制裁司法辖区（最多计 20 分）；若制裁命中与高风险路线同时出现，则额外增加 15 分的综合惩罚。

货运成本波动：计算汇率样本的变异系数——CV 超过 5% 时触发 25 分的货币信号（最多计 30 分）；BLS PPI 和燃料序列超过阈值时最多增加 25 分；OECD／World Bank 贸易指标最多增加 25 分；若货币与经济压力同时出现，则增加 20 分的综合加分。

边境延误：根据过境地点的天气严重程度和灾害预警级别综合评分（最多计 35 分）；根据观察名单标记评估合规筛查风险（最多计 35 分）；若天气与合规风险同时存在，则增加 30 分的综合延误系数。

综合评分整合

四个维度的分数按固定权重合并：贸易合规（30%）、路线中断（25%）、货运成本（25%）和边境延误（20%）。综合分数对应五个判定等级：LOW_RISK（0–19）、MANAGEABLE（20–39）、ELEVATED（40–59）、HIGH_RISK（60–79）和 CRITICAL（80–100）。只有在达到特定关键阈值时才会附加建议——CRITICAL 中断等级、BLOCKED 合规等级、EXTREME 成本波动或 SEVERE 边境延误——确保输出具有可执行性，而非冗长繁杂。

最佳实践提示

1. 先使用 supply_chain_vulnerability 进行初步评估，再深入分析。 首先运行完整的综合评估，确定哪些维度风险较高，然后调用更具针对性的工具（route_disruption_forecast、trade_compliance_screen 等），并提供更具体的参数，以获取问题领域的深入信号数据。

2. 使用天气工具时提供具体的地区名称。 与「USA」相比，「Gulf Coast」和「US-Mexico border Laredo crossing」能返回更有针对性的 NOAA 警报。对于海上航线，请使用港口名称或海域名称，例如「South China Sea」或「Strait of Hormuz」。

3. 在贸易合规查询中加入 HS 商品编码。 在实体名称旁传入 commodity: "8471"（计算机），即可获取该特定商品类别的 COMTRADE 双边流量数据，从而提高商品特定供应链的 HHI 准确度。

4. 确定费率前，先结合航线比较。 在签订货运合同前，使用 compare_trade_routes 比较预选的运输走廊。输出会按综合风险对航线进行排名，并指出造成差异的维度。

5. 为关键运输走廊安排每日中断预测。 使用 Apify 的调度器，每天早晨对关键运输走廊运行 route_disruption_forecast。设置 Webhook，在中断级别达到 SEVERE 或 CRITICAL 时发送 Slack 通知。

6. 每季度筛查承运商，而不只是在合作初期筛查。 制裁风险会发生变化。六个月前还符合 COMPLIANT 标准的承运商，之后可能已被列入监控名单。carrier_risk_assessment 的费用为 $0.045；每月筛查 20 家主要承运商的费用为 $0.90。

7. 使用 sanctions_cargo_check 时传入 destination 参数。 单独筛查目的地国家，可以发现仅筛查实体时会遗漏的基于航线的制裁风险，例如，合法托运人通过受制裁的中转港运输货物。

与其他 MCP 服务和 Apify Actor 结合使用

Actor / MCP 服务	组合使用方式
出口合规筛查 MCP	在制裁货物筛查的同时执行出口管制检查，适用于两用物品
制裁网络分析 MCP	trade_compliance_screen 命中制裁名单后，绘制该实体的所有权网络，以发现间接风险
WHOIS 域名查询	根据声称的注册成立国家，核验货运合作伙伴的域名注册信息
公司深度研究	对 HIGH_RISK 承运商评估结果进行全面的公司情报调查
AML 实体筛查 MCP	将贸易制裁筛查与 AML 负面媒体和 PEP 检查结合，进行全面尽职调查
OpenSanctions 搜索	在 MCP 工作流之外直接查询 OpenSanctions，以批量筛查实体
OFAC 制裁搜索	使用自定义置信度阈值直接查询 OFAC，为合规审计留存记录

局限性

• 不提供实时集装箱或船舶追踪。 此服务提供航线和实体的风险情报，不提供集装箱实时位置或 AIS 船舶数据。如需实时追踪，请使用 project44 或 FourKites 等专用平台。
• NOAA 的天气覆盖以美国和沿海地区最为全面。 国际内陆货运走廊（例如中亚公路路线）返回的天气预警可能少于类似的美国走廊。
• OFAC 和 OpenSanctions 的匹配置信度为近似值。 评分模型使用底层数据提供方的名称匹配算法。包含常见词语的模糊实体名称可能导致误报；暂停发货前，务必通过 OFAC 官方资源确认匹配结果。
• UN COMTRADE 数据存在报告延迟。 大多数 COMTRADE 双边贸易数据会延迟 3-6 个月报告。HHI 分析反映的是近期但非当前的贸易流量；它是结构性风险指标，而非实时流量传感器。
• 汇率波动率根据可用样本计算。 变异系数计算至少需要 2 个汇率样本；如果查询仅返回单个汇率，系统将显示保守的低波动率分数，而不会报错。
• 此服务需要有效的 Apify 账户和令牌。 不支持匿名访问。Apify 免费计划每月提供 5 美元额度，约可支持 111 次工具调用。
• 结果仅供参考，不构成法律合规认证。 trade_compliance_screen 和 sanctions_cargo_check 的输出是用于确定审核优先级的风险评分工具，不构成法律合规判定。请咨询合格的贸易法律顾问，再决定是否仅根据这些评分暂停发货。
• compare_trade_routes 每次调用最多接受 5 条航线。 如需处理更多航线，请分多次调用，并手动比较综合评分。

集成

• Apify API — 通过 Python、JavaScript 或 cURL 以编程方式调用任意 MCP 工具；将结果传入内部仪表板或 TMS 系统
• Webhooks — 当供应链漏洞评分超过指定阈值时，触发 Slack、电子邮件或 PagerDuty 警报
• Zapier — 将航线中断预测连接到自动化货运预订工作流或采购通知
• Make — 构建无代码供应链监控管道，在触发采购订单前检查制裁和天气情况
• LangChain / LlamaIndex — 将 MCP 工具调用封装为 LangChain 工具或 LlamaIndex 查询引擎，用于物流感知型 RAG 应用
• Claude Desktop — 直接在 Claude 界面中，以自然语言询问航线风险、承运商合规性和成本波动

故障排除

• 工具在预期存在风险时返回空信号 — 底层 Actor 会查询公共 API，而这些 API 对于不常见的实体名称或非常具体的地区名称，可能不会返回匹配记录。尝试使用更宽泛的搜索词：例如，用“墨西哥边境”替代具体的口岸名称，或用国家名称替代城市名称。如果问题仍然存在，请在 Apify 账户设置中启用运行共享，以便 Actor 开发者检查底层 Actor 调用的输出。

• compare_trade_routes 响应缓慢 — 此工具会依次为每条路线并行调用 Actor（由于路线比较逻辑中的 for 循环），因此比较 5 条路线最多涉及 30 次独立的 Actor 调用。比较 5 条路线时，请预留 60-90 秒。若要更快获得结果，请将比较路线数限制为 3 条。

• 制裁货物检查标记了你认为没有问题的实体 — OpenSanctions 汇总了 40 多个观察名单，其中一些包含范围较广的地理或行业指定。查看 signals 数组，了解具体是哪个名单触发了匹配。如果因常见名称而产生误报，请使用 commodity 参数缩小 COMTRADE 查询范围，然后重新运行。

• freight_cost_volatility 在市场明显承压时仍返回 STABLE — 货币波动率计算需要汇率样本存在可测量的变化。如果 Exchange Rate Tracker 对查询的走廊仅返回一条汇率记录，变异系数的默认分数会较低。请尝试在 corridor 参数中指定更具体的货币对，例如使用“USD/EUR”而不是“US-EU”。

• MCP 客户端无法连接 — 请确认服务 URL 为 https://logistics-freight-intelligence-mcp.apify.actor/mcp，并且 Authorization 标头格式为 Bearer YOUR_TOKEN（而非 token YOUR_TOKEN）。服务要求使用 POST 请求；按设计，GET 请求会返回 405 错误。

负责任地使用

• 此服务访问的所有数据源均可从官方政府机构和政府间组织公开获取。
• 制裁筛查结果是咨询性质的风险评分，并非法律认定。采取合规行动前，请咨询具备资质的出口管制和贸易制裁法律顾问。
• 请勿使用此服务规避制裁执法或查找其漏洞。请遵守 OFAC、EU、UN 以及所有适用的制裁制度。
• 请遵守底层数据提供方的服务条款：NOAA、GDACS、UN COMTRADE、BLS、World Bank 和 OECD。
• 有关网页抓取和数据使用合法性的指引，请参阅 Apify 的指南。

常见问题

Logistics Freight Intelligence MCP 与 TMS 或货运平台有何不同？ Oracle TM 或 SAP TM 等传统 TMS 平台负责管理预订、执行和可见性。此 MCP 提供风险情报输入——制裁筛查、路线中断评分、成本波动预测——供 AI Agent 和自定义应用使用，而非作为独立界面。每次查询的费用仅为几美分，而非每月数千美元。

免费套餐每月可以运行多少次物流情报查询？ Apify 免费套餐包含 5 美元的月度额度。每次工具调用费用为 0.045 美元，因此无需付款即可进行约 111 次工具调用。你可以设置每次运行的支出上限，以防意外超支。

物流货运情报评分使用实时数据吗？ NOAA 天气警报和 GDACS 灾害事件会在查询时实时获取，反映当前有效的警报。汇率也是实时数据。BLS、OECD 和 World Bank 数据按各自的发布计划更新，通常为每月到每季度一次，因此经济指标反映的是近期情况，而非实时状况。UN COMTRADE 双边贸易数据的报告延迟为 3-6 个月。 我可以将此 MCP 用于 OFAC 合规审计吗？ sanctions_cargo_check 和 trade_compliance_screen 工具用于风险评分，帮助确定审核优先级。它们会交叉比对 OFAC 和 OpenSanctions 数据，但不构成正式的 OFAC 合规计划。请使用输出结果标记需要人工审核的实体，不要将其作为独立的审计记录。

贸易集中度 HHI 如何计算？ 赫芬达尔-赫希曼指数根据所查询实体的 UN COMTRADE 双边贸易流计算。将各贸易伙伴占贸易总额的份额分别平方后求和。HHI 高于 2,500 表示供应链高度集中（由单一伙伴主导）。高于 1,500 表示存在中度集中风险。低于 1,000 表示贸易基础较为多元。

物流货运情报 MCP 能预测具体货运延误几天吗？ 不能。边境延误预测器会返回风险等级和影响因素，而非以小时或天为单位的具体延误时长。它会根据当前天气、灾害和合规状况，判断口岸发生延误的概率和严重程度——SEVERE 评级表示可能出现严重延误，而不是具体的预计到达时间影响。

使用公开的制裁和贸易数据进行筛查合法吗？ 合法。OFAC 发布 SDN 名单，专供合规用途。OpenSanctions 汇总公开的政府观察名单。UN COMTRADE 提供开放的贸易统计数据。本服务中的所有数据源均面向公众开放，并可在其服务条款范围内用于商业用途。

如果工具调用触及支出上限，会发生什么？ 每个工具都会在执行前检查 Apify 的单次运行费用上限。如果达到上限，工具会返回 JSON 错误消息——{"error": true, "message": "Spending limit reached for [tool_name]"}——而不是静默失败。达到上限后不会再获取数据。

我可以按计划运行物流货运情报查询吗？ 可以。使用 Apify 内置的计划程序，按任意 cron 计划运行 actor（它会启动 MCP 服务）。结合 Webhook，可在评分超过阈值时接收提醒。每日扫描航线中断情况和每周检查承运商合规情况，都是常见用法。

承运商风险评估与完整制裁检查有何不同？ carrier_risk_assessment 是一个复合 60/40 模型，结合合规风险（OFAC + OpenSanctions + COMTRADE）和经济稳定性风险（BLS 运输 PPI），用于承运商准入决策。sanctions_cargo_check 的范围更窄——它仅根据 OFAC 和 OpenSanctions 筛查特定实体及可选目的地，专为逐票筛查工作流优化。

哪些 AI 助手和编码工具支持此 MCP 服务？ 该服务使用标准 MCP Streamable HTTP 传输协议，兼容 Claude Desktop、Cursor、Windsurf、Cline、Continue 及任何其他符合 MCP 规范的客户端。它也支持通过 Python 或 JavaScript 使用标准 HTTP POST 请求进行编程式 MCP 集成。

路线中断评分中的复合灾害检测如何工作？ 当所查询地区同时出现 NOAA 极端天气警报和 GDACS 红色／橙色灾害事件时，评分模型会在单独的天气和灾害评分基础上增加 15 分的连锁影响系数。这反映了经验观察：严重天气与活跃灾害同时发生时，会造成非线性的货运中断——机场关闭、道路施工队被调派，港口运营也会同时停摆，而非各自独立受影响。

帮助我们改进

如果遇到意外结果或空响应，启用运行共享可以帮助我们更快地解决问题：

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

这样，Actor 开发者就能在出现问题时检查底层 Actor 调用的输出。您的数据仅对 Actor 开发者可见，不会公开。

支持

发现 Bug 或有功能建议？请在此 Actor 页面上的 Issues 标签页中提交问题。有关自定义集成、其他数据源或企业物流工作流，请通过 Apify 平台联系我们。