mcpField
M
Maritime Shipping Intelligence

Maritime Shipping Intelligence

远程服务
ryanclinton--maritime-shipping-intelligence-mcp.apify.actor地图与出行032 周前更新

关于 Maritime Shipping Intelligence

面向货运、保险和贸易合规团队的海事风险情报 MCP 服务。它整合 8 个数据源,提供制裁筛查、港口中断预测、航线核查和风险评分报告等工具。

主要功能

  1. 01提供 8 种海事风险分析工具
  2. 02制裁与企业注册信息筛查
  3. 03港口天气及中断预测
  4. 04贸易航线与货物原产地核查
  5. 05加权综合风险评分
  6. 06并行查询多个数据源

适用场景

  1. 01订舱前筛查船舶及其所有者
  2. 02规划到港时评估港口中断风险
  3. 03为保险承保审核交易对手
  4. 04核查货物原产地及航线的制裁风险

MCP 相关

该 MCP 服务提供 8 种工具,用于船舶和交易对手筛查、天气及中断预测、贸易与货物核查以及船队报告。MCP 客户端可获得结构化结果,包括加权综合风险评分和判定。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

海运情报 MCP 服务

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


快速开始

添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf):

{
  "mcpServers": {
    "maritime-shipping-intelligence-mcp": {
      "url": "https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcp"
    }
  }
}

为货运代理、海事保险公司和贸易合规团队提供海运情报,帮助他们在无需订阅昂贵海事数据平台的情况下,进行船舶制裁筛查、港口中断预测和贸易路线风险评估。此 MCP 服务汇总了 8 个实时数据源——OFAC、OpenSanctions、UN COMTRADE、NOAA、GDACS、OpenCorporates、GLEIF 和天气预报服务——并将其整合为单一的工具调用接口,可在 Claude、Cursor 或任何兼容 MCP 的 AI 客户端中运行。每次查询都会返回有评分的风险评估,并以一手来源数据为依据,而非过时的聚合数据流。

只需一步,即可将你的 AI 助手连接到港口天气警报、船舶制裁名单、企业注册信息和国际贸易流数据库。查询会并行访问所有来源,因此只需一次工具调用,即可获得完整的综合海事风险报告,其中包含 0 到 100 的加权综合海事风险评分。

可以访问哪些数据?

数据点来源示例
📋 美国制裁名单OFAC SDN ListOFAC 特别指定国民登记册上的船舶、运营商和受益所有人
🔎 多司法辖区监控名单OpenSanctions40 多个整合项目:EU、UN、UK、OFAC、Interpol——按实体交叉匹配
🚢 国际贸易流UN COMTRADE200 多个国家的双边商品流——用于 HHI 集中度评分
🌀 严重海事天气NOAA影响港口运营的飓风、大风、热带风暴、风暴潮和海啸警报
🌍 自然灾害监测GDACS航道附近的红色/橙色气旋、地震、洪水和海啸事件
🏢 企业注册记录OpenCorporates船舶所有人的注册成立信息、司法辖区、申报数量和解散状态
🔗 法人实体识别编码GLEIF LEILEI 签发状态、注册信息时效性和实体关系链
🌤 航线天气预报Weather Forecast指定航线和区域的风速、能见度和风暴状况
⚖️ 船旗国分类评分模型标记 23 个方便旗,并追踪 13 个高风险司法辖区
📊 综合风险评分所有来源加权 0–100 评分,结论从 CLEAR_TO_PROCEED 到 DO_NOT_ENGAGE

为什么使用 Maritime Shipping Intelligence MCP?

合规分析师以人工方式筛查单艘船舶——交叉核查 OFAC、获取 GLEIF 数据、搜索 OpenCorporates、查看 NOAA 海洋预报、获取 GDACS 数据并运行贸易流查询——每个交易对手都要花费 2-4 小时。在租船前筛查 20 艘船队的船舶,光是数据收集就要整整一周,分析还没开始。

此 MCP 服务可自动完成整个数据收集环节。在 Claude 或 Cursor 中运行的 AI 客户端可以筛查船舶、核实交易对手、检查其运营区域是否有天气扰动、评估其贸易路线的制裁风险,并在每次查询不到 3 分钟内返回评分结果。

除了速度优势,MCP 集成还意味着 AI 助手能够对结果进行推理——提出后续问题、撰写合规备忘录、标记升级事项——而不只是返回原始数据。

  • 定时执行——按计划运行每日港口扰动预报或每周船队制裁筛查,确保风险数据及时更新
  • API 访问——使用 Apify API,通过 Python、JavaScript 或任何 HTTP 客户端触发筛查
  • 代理轮换——所有底层 Actor 查询均通过 Apify 的代理基础设施运行,避免触及公共数据源的速率限制
  • 监控——当工具调用返回 HIGH 或 CRITICAL 结果时,配置 Slack 或电子邮件提醒
  • 集成——通过 webhook 将结果连接到 Zapier、Make、Google Sheets 或合规工作流工具

功能

  • 8 个 MCP 工具,覆盖海事风险的各个方面:制裁、天气、贸易合规、交易对手、船旗国、货物原产地、航线天气和船队报告
  • 综合海事风险评分(0-100),按权重计算:船舶制裁风险 30%、贸易路线合规性 25%、交易对手风险 20%、港口扰动 15%、船旗国风险 10%
  • 5 级结果判定系统——CLEAR_TO_PROCEED、PROCEED_WITH_CAUTION、ENHANCED_REVIEW、HIGH_RISK、DO_NOT_ENGAGE,与标准合规升级工作流保持一致
  • OFAC SDN 筛查,附带匹配置信度评分;置信度达到 80% 及以上的 SDN 匹配将自动归类为 CRITICAL
  • OpenSanctions 交叉匹配,覆盖 40 多个国际观察名单;出现在 2 个或更多名单上的实体将获得更高评分
  • 赫芬达尔-赫希曼指数(HHI)贸易集中度评分——HHI 高于 2500 时,将标记高度集中的路线及其对单一司法管辖区的依赖风险
  • 跟踪 23 个方便旗——包括巴拿马、利比里亚、马绍尔群岛、巴哈马、马耳他、百慕大等 17 个地区,并按监管监督质量加权
  • 13 个高风险司法管辖区,用于检测规避制裁行为——包括朝鲜、伊朗、俄罗斯、叙利亚、委内瑞拉、缅甸、白俄罗斯等,并应用于公司链分析
  • NOAA 海事威胁分类——筛选飓风、热带风暴、大风、海啸、风暴潮、气旋、台风、雾和冰情事件;极端/严重等级会使警报分值权重翻倍
  • GDACS 红色/橙色灾害邻近度评分——航道附近的红色和橙色警报在扰动模型中各计 10 分
  • GLEIF LEI 核验,区分有效、过期和缺失状态——缺失 LEI 会使交易对手风险增加 25 分;过期则增加 10 分
  • 企业不透明度评分——已解散实体、零申报公司、LLP/信托/代持结构以及在方便旗地区注册,都会使不透明度评分递增
  • 并行 Actor 执行——使用 Promise.all 同时查询所有底层数据源,最大限度缩短总延迟
  • 支出限额执行——每个工具在执行前都会检查 Apify 的事件费用限额,防止成本失控
  • 无状态的单请求架构——每个 POST 请求都会创建一个新的 MCP 服务实例,从而支持待机模式下的水平扩展

海事航运情报的使用场景

船舶预订前的制裁合规筛查

货运代理和货主必须在预订前筛查船舶及其受益所有人。vessel_sanctions_screening 工具通过一次调用查询 OFAC SDN、OpenSanctions、OpenCorporates 和 GLEIF,随后对公司关联链进行评分,评估方便旗登记和高风险司法管辖区。Claude 中运行的预订工作流可以自动拒绝被标记的船舶,并生成合规备忘录以供审计。

港口运营与航期中断风险

在易受天气影响的地区规划船舶到港的港口代理、码头运营商和船舶运营商,可使用 port_disruption_forecast 工具,获取指定港口或沿海地区的实时 NOAA 海洋警报和 GDACS 灾害事件。该工具按严重程度对飓风、大风、风暴潮、气旋和海啸事件进行评分,并返回从 CALM 到 EXTREME 的 5 级中断风险,帮助用户主动决定出发时间或是否改道。

海上保险承保与 P&I 评估

评估保费水平的海上保险公司和 P&I 互助协会,可使用 flag_state_risk_check 和 shipping_counterparty_screen 工具,量化监管监督质量和受益所有权透明度。在马绍尔群岛注册、由一家没有 LEI 且没有公司备案记录的 LLP 持有的船舶,会获得较高的不透明度评分,这一评分可直接用于证明保费上调的合理性。

贸易路线合规与货物原产地核验

大宗商品贸易商和货运经纪商的贸易合规团队,可使用 trade_route_compliance 和 cargo_origin_verification 检测经由受制裁司法管辖区的转运情况。系统会将 UN COMTRADE 双边贸易流与 OFAC 和 OpenSanctions 的查询结果进行核对;途经朝鲜、伊朗、俄罗斯或叙利亚的路线会触发受制裁路线标记,并附带经过 HHI 调整的集中度评分。

航运运营商的全船队风险监控

管理 10–100 艘船舶的船舶管理公司和船队所有者,可使用 vessel_fleet_risk_report 工具为每艘船舶或交易对手生成综合海事风险评分。一次工具调用即可并行编排全部 8 个数据源,并返回全部五个风险维度的评分,以及结构化结论和建议列表。与每日 Apify 计划任务集成,可持续维护整个船队的最新风险档案。

AI 辅助海事尽职调查

法律团队和合规顾问可在 Claude 中使用此 MCP 服务,对租船交易对手、船旗国和货物原产地开展结构化尽职调查。由于工具会返回结构化 JSON,AI 助手可以综合多次工具调用的结果,生成格式化的尽职调查报告、标记需要升级至法律团队处理的问题,并起草整改建议——所有操作都可在一次对话中完成。

如何通过 AI 客户端使用海事航运情报

  1. 连接 MCP 服务 — 将服务 URL https://maritime-shipping-intelligence-mcp.apify.actor/mcp 添加到 MCP 客户端配置中。对于 Claude Desktop,将其添加到 claude_desktop_config.json。无需编写代码。
  2. 使用自然语言提问 — 向 AI 提问:“筛查船舶 Pacific Carrier 的制裁风险”或“本周鹿特丹港的中断风险如何?”AI 会自动选择合适的工具。
  3. 查看评分结果 — 工具会返回风险评分、结论和具体信号(例如:“2 条 SDN 匹配记录——OFAC 封锁实体”“HHI 3200——贸易路线高度集中”)。可以让 AI 总结结果或起草合规备忘录。
  4. 导出或升级处理 — 将结果复制到合规系统中,向案例管理工具触发 webhook,或让 AI 生成可供合规专员使用的格式化报告。

MCP 工具

工具价格参数描述
vessel_sanctions_screening$0.045entity、port(可选)根据 OFAC SDN、OpenSanctions 和企业注册信息筛查船舶或航运公司
port_disruption_forecast$0.045port、timeframe(可选)预测恶劣天气、灾害和海事风险导致的港口中断
trade_route_compliance$0.045commodity、country(可选)评估贸易路线合规性:HHI 集中度、受制裁路线检测、贸易流风险
flag_state_risk_check$0.045entity检查船旗国风险:方便旗、高风险司法管辖区、监管监督质量
shipping_counterparty_screen$0.045company筛查航运交易对手:LEI 验证、企业透明度、制裁风险
maritime_weather_risk$0.045route评估航运路线的海事天气风险:风暴追踪、能见度、风力、海况
cargo_origin_verification$0.045commodity、origin验证货物原产地:贸易流分析、转运风险、受制裁原产地检测
vessel_fleet_risk_report$0.045entity、region(可选)提供完整的海事风险报告,涵盖五个维度的综合海事风险评分
工具输入提示
  • 尽可能使用船舶 IMO 编号——例如“IMO 9321483”这样的 IMO 编号,比仅提供船名更容易匹配到准确的 OFAC 和 OpenSanctions 数据
  • 在船队报告中注明运营区域——在实体名称旁传入 region: "Persian Gulf",可显著提升天气和灾害数据的相关性
  • 贸易合规检查使用商品 HS 编码——commodity: "2709 crude oil" 比纯文本描述能提供更准确的 COMTRADE 结果

输出示例

vessel_fleet_risk_report 工具会返回以下结构,用于完整的综合评估:

{
  "entity": "Pacific Meridian Shipping Ltd",
  "compositeScore": 67,
  "verdict": "HIGH_RISK",
  "vesselSanctions": {
    "score": 72,
    "sanctionHits": 3,
    "flagRisk": 20,
    "jurisdictionRisk": 16,
    "riskLevel": "HIGH",
    "signals": [
      "2 SDN matches — OFAC blocked entity",
      "1 OpenSanctions hits across multiple watchlists",
      "Flag-of-convenience / high-risk jurisdiction detected"
    ]
  },
  "portDisruption": {
    "score": 28,
    "severeAlerts": 2,
    "disasterCount": 1,
    "weatherRisk": 12,
    "riskLevel": "WATCH",
    "signals": [
      "2 maritime weather alerts active"
    ]
  },
  "tradeRoute": {
    "score": 55,
    "tradePartners": 3,
    "concentrationHHI": 3180,
    "sanctionedRoutes": 1,
    "complianceLevel": "REVIEW_NEEDED",
    "signals": [
      "HHI 3180 — highly concentrated trade routes",
      "1 trade routes involve sanctioned jurisdictions",
      "Only 3 trade partners — high route dependency"
    ]
  },
  "counterparty": {
    "score": 58,
    "corporateOpacity": 22,
    "leiVerified": false,
    "sanctionFlags": 2,
    "riskLevel": "SUSPICIOUS",
    "signals": [
      "No LEI found — counterparty not globally identified",
      "2 sanctions/watchlist matches",
      "No corporate registry records found — unverifiable entity"
    ]
  },
  "flagState": {
    "score": 65,
    "flagOfConvenience": true,
    "highRiskJurisdiction": false,
    "riskLevel": "HIGH",
    "signals": [
      "Flag-of-convenience registration — weak regulatory oversight",
      "Multiple flag-of-convenience/high-risk jurisdictions in corporate chain"
    ]
  },
  "allSignals": [
    "2 SDN matches — OFAC blocked entity",
    "1 OpenSanctions hits across multiple watchlists",
    "Flag-of-convenience / high-risk jurisdiction detected",
    "2 maritime weather alerts active",
    "HHI 3180 — highly concentrated trade routes",
    "1 trade routes involve sanctioned jurisdictions",
    "Only 3 trade partners — high route dependency",
    "No LEI found — counterparty not globally identified",
    "2 sanctions/watchlist matches",
    "Flag-of-convenience registration — weak regulatory oversight"
  ],
  "recommendations": [
    "Immediate sanctions compliance review required — potential OFAC violation",
    "Counterparty verification failed — enhanced due diligence required",
    "Flag-of-convenience vessel — verify insurance coverage and regulatory compliance",
    "Trade routes involve sanctioned jurisdictions — ensure proper licensing"
  ]
}

输出字段

字段类型描述
entity字符串查询的船舶、公司或船队名称
compositeScore数字加权综合风险评分 0-100(制裁 30%、贸易 25%、交易对手 20%、天气 15%、船旗 10%)
verdict字符串CLEAR_TO_PROCEED / PROCEED_WITH_CAUTION / ENHANCED_REVIEW / HIGH_RISK / DO_NOT_ENGAGE
vesselSanctions.score数字制裁子评分 0-100
vesselSanctions.sanctionHits数字OFAC + OpenSanctions 匹配总数
vesselSanctions.flagRisk数字方便旗子评分(最高 25)
vesselSanctions.jurisdictionRisk数字高风险司法管辖区子评分(最高 20)
vesselSanctions.riskLevel字符串CLEAR / LOW / MEDIUM / HIGH / CRITICAL
portDisruption.score数字天气/灾害中断评分 0-100
portDisruption.severeAlerts数字与海事相关的 NOAA 警报数量
portDisruption.disasterCount数字港口附近的 GDACS 事件数量
portDisruption.riskLevel字符串CALM / WATCH / ADVISORY / WARNING / EXTREME
tradeRoute.score数字贸易合规评分 0-100
tradeRoute.tradePartners数字不同贸易伙伴国家的数量
tradeRoute.concentrationHHI数字赫芬达尔-赫希曼指数(0-10000;>2500 表示高度集中)
tradeRoute.sanctionedRoutes数字涉及受制裁司法管辖区的贸易路线数量
tradeRoute.complianceLevel字符串COMPLIANT / LOW_RISK / REVIEW_NEEDED / HIGH_RISK / NON_COMPLIANT
counterparty.score数字交易对手欺诈风险评分 0-100
counterparty.corporateOpacity数字不透明度子评分:已解散实体、零申报、空壳结构
counterparty.leiVerified布尔值是否找到有效的 GLEIF LEI
counterparty.sanctionFlags数字交易对手的制裁/观察名单匹配数量
counterparty.riskLevel字符串VERIFIED / LOW_RISK / REVIEW / SUSPICIOUS / BLOCK
flagState.score数字船旗国风险评分 0-100
flagState.flagOfConvenience布尔值如果任何司法管辖区匹配 23 个已知方便旗国家之一,则为 True
flagState.highRiskJurisdiction布尔值如果任何司法管辖区匹配 13 个高风险规避制裁国家之一,则为 True
flagState.riskLevel字符串LOW / MODERATE / ELEVATED / HIGH / CRITICAL
allSignalsstring[]汇总五个维度所有风险信号的列表
recommendationsstring[]根据得分最高的风险因素提供的可执行整改步骤

海运情报的费用是多少?

此 MCP 采用按事件付费定价——每次工具调用费用为 $0.045。平台计算费用已包含在内。Apify 免费套餐提供每月 $5 额度,约可进行 111 次海运情报查询。

场景查询次数每次查询费用总费用
快速制裁检查1$0.045$0.045
预订前筛查(5 艘船舶)5$0.045$0.23
每周船队报告(20 艘船舶)20$0.045$0.90
每月合规周期(100 次查询)100$0.045$4.50
企业每日监控(500 次查询)500$0.045$22.50

你可以为每次运行设置最高支出限额以控制费用。达到预算后,Actor 会停止运行。

相比之下,Dataloy、Q88 或 CODA 等专用海事合规平台每月收费 $500-2,000。对于定期筛查船舶而非持续运营船队的团队,大多数用户每月只需花费 $5-25,无需订阅。

如何连接此 MCP 服务

Claude Desktop

添加到你的 claude_desktop_config.json:

{
  "mcpServers": {
    "maritime-shipping-intelligence": {
      "url": "https://maritime-shipping-intelligence-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}
Python(通过 Apify Standby)
import httpx
import json

token = "YOUR_APIFY_TOKEN"
base_url = "https://maritime-shipping-intelligence-mcp.apify.actor/mcp"

payload = {
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
        "name": "vessel_fleet_risk_report",
        "arguments": {
            "entity": "Pacific Meridian Shipping Ltd",
            "region": "Persian Gulf"
        }
    },
    "id": 1
}

response = httpx.post(
    base_url,
    json=payload,
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
)
result = response.json()
report = json.loads(result["result"]["content"][0]["text"])
print(f"Verdict: {report['verdict']} | Score: {report['compositeScore']}/100")
for rec in report["recommendations"]:
    print(f"  - {rec}")
JavaScript
const token = "YOUR_APIFY_TOKEN";
const baseUrl = "https://maritime-shipping-intelligence-mcp.apify.actor/mcp";

const response = await fetch(baseUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    method: "tools/call",
    params: {
      name: "vessel_sanctions_screening",
      arguments: { entity: "Evergreen Marine Corp" }
    },
    id: 1
  })
});

const data = await response.json();
const result = JSON.parse(data.result.content[0].text);
console.log(`Risk level: ${result.vesselSanctions.riskLevel}`);
console.log(`Sanction hits: ${result.vesselSanctions.sanctionHits}`);
for (const signal of result.vesselSanctions.signals) {
  console.log(`  Signal: ${signal}`);
}
cURL
# Screen a vessel for sanctions risk
curl -X POST "https://maritime-shipping-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": "vessel_sanctions_screening",
      "arguments": {
        "entity": "Pegas Shipping Ltd"
      }
    },
    "id": 1
  }'

# Forecast port disruption risk
curl -X POST "https://maritime-shipping-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": "port_disruption_forecast",
      "arguments": {
        "port": "Port of Houston"
      }
    },
    "id": 2
  }'

海运情报 MCP 的工作原理

阶段 1:并行数据源编排

调用工具时,服务会将查询传递给 runActorsParallel(),该函数会构建一个 Actor 调用描述符数组,并使用 Promise.all 并发执行。每个 Actor 都在 512 MB 内存分配下运行,超时时间为 120 秒。ACTOR_MAP 会将逻辑源名称(例如 ofac-sanctions-search)映射到特定的 Apify Actor ID,使路由层与评分逻辑保持解耦。调用失败的 Actor 会返回空数组,因此,任何无法访问的数据源都不会阻塞整个评估。

阶段 2:专用评分模型

五个独立的评分函数会处理汇总后的数据:

scoreVesselSanctions() 为每个 SDN 匹配计 15 分(上限为 40 分),OFAC 部分匹配计 8 分,OpenSanctions 多名单命中计 2-5 分。OpenCorporates 中的方便旗司法管辖区最多可增加 25 分;高风险司法管辖区最多可增加 20 分。企业不透明度(已解散状态、零申报、空壳结构)最多可增加 15 分。最终的 0-100 分数映射为 CLEAR / LOW / MEDIUM / HIGH / CRITICAL。

scorePortDisruption() 通过将关键词——hurricane、tropical、storm、tsunami、surge、gale、wind、flood、cyclone、typhoon、fog、ice——与事件描述和严重性字段进行匹配,对 NOAA 事件分类。极端/严重警报每项计 10 分(上限为 35 分)。航运通道附近的 GDACS 红色/橙色事件每项计 10 分(上限为 30 分)。预测风速超过 50 节,或描述中出现 storm/gale 的情况,每项计 5 分。五级输出范围为 CALM 至 EXTREME。

scoreTradeRouteCompliance() 根据 UN COMTRADE 的 primaryValue 字段计算 HHI,将合作伙伴份额标准化后求平方和,再乘以 10,000。HHI 超过 2,500 时会触发高度集中信号。受制裁国家检测会将 OFAC 计划字段和 OpenSanctions 的 countries 数组与 13 个高风险司法管辖区名单进行交叉比对。每条受制裁航线增加 12 分(上限为 35 分)。

scoreCounterpartyRisk() 从 LEI 缺失(25 分)、状态已过期(10 分)或已验证为有效(0 分)开始计算。OpenCorporates 数据会根据已解散实体(每个 8 分)、零申报(5 分)、代名人/信托/LLP 结构(5 分)以及方便旗注册(4 分)增加不透明度分数。置信度超过 70% 的 OFAC 匹配和 OpenSanctions 数据集成员资格各增加 10 分(上限为 30 分)。

scoreFlagState() 会扫描 OpenCorporates 和 GLEIF 记录中的所有司法管辖区。命中高风险司法管辖区增加 40 分;方便旗注册增加 25 分;合计命中三次或以上增加 15 分。司法管辖区数据缺失则增加 20 分。

阶段 3:综合评分汇总

generateMaritimeIntel() 为五项子评分应用固定权重:船舶制裁(0.30)、贸易航线(0.25)、交易对手(0.20)、港口中断(0.15)、船旗国(0.10)。综合分数会四舍五入为整数,并映射到五级判定。所有模型的信号会合并到一个扁平的 allSignals 数组中。建议引擎会应用阈值规则——CRITICAL 制裁判定会触发 OFAC 升级建议;HHI 超过 2,500 会触发航线多元化建议;SUSPICIOUS 交易对手会触发强化尽职调查建议。

待机模式架构

该服务以 Apify 待机 Actor 的形式运行,在 /mcp 提供持久 HTTP 端点。每个 POST 请求都会创建一个新的 McpServer 实例和一个 StreamableHTTPServerTransport,处理请求,并在连接结束时关闭传输。按请求无状态的模式意味着该服务可以同时处理来自多个 MCP 客户端的并发查询。在待机模式之外运行时(直接执行 Actor),服务会短暂启动,记录健康检查确认信息,并在 1 秒后退出。

获得最佳结果的提示

  1. 对高价值交易对手使用完整船队报告。 vessel_fleet_risk_report 工具可在一次调用中协调全部 8 个数据源。对于超过重要性阈值的交易对手,相比单独调用各个工具,多花 $0.045 获得更全面的信息是值得的。

  2. IMO 编号有助于提高制裁匹配的精确度。 OFAC SDN 条目中经常包含船舶的 IMO 编号。传入“IMO 9321483”,而不是船名,可以减少因名称变体和转写差异导致的误报。

  3. 对两用商品结合货物原产地核验。 对于存在制裁敏感性的商品——原油、精炼石油、金属、半导体——将 trade_route_compliance 与 cargo_origin_verification 搭配使用,以检测直接航线风险以及经中间国家转运的情况。

  4. 为自动筛查工作流设置支出限额。 如果将此 MCP 接入用于筛查新收到的航次订单的自动化工作流,请配置 Apify 的单次运行支出限额,将每日支出控制在固定金额内。

  5. 结合受制裁航线数量解读 HHI。 HHI 较高(航线集中)但未命中任何受制裁航线,意味着存在依赖风险,但没有合规风险。HHI > 2,500 且受制裁航线 > 0,说明需要立即开展合规审查。

  6. 所有权变更后重新筛查。 OpenCorporates 的公司注册数据反映的是查询时的状态。船舶所有者、运营商或船旗国发生变化后,请再次进行筛查,尤其是在关联实体之间转让船舶之后。

  7. 在离港前而非抵港前查询港口中断预测。 NOAA 和 GDACS 事件在查询时实时更新。建议在计划从起运港离港前 24-48 小时查询一次,并在预计抵达港的时间窗口前 24 小时再查询一次。

与其他 Apify Actor 搭配使用

Actor搭配方式
OFAC Sanctions Search对船舶筛查识别出的标记实体单独执行深入的 OFAC 搜索,获取比 MCP 工具返回结果更多的结果页
OpenSanctions Search提取在 MCP 中触发多个名单匹配的实体的完整 OpenSanctions 实体档案及其所有数据集归属信息
OpenCorporates Search提取交易对手筛查器标记为不透明的公司结构的完整受益所有权链
GLEIF LEI Lookup检索航运集团的完整 LEI 关联关系树——包括母公司实体、子公司和基金结构——获取 MCP 未返回的信息
UN COMTRADE Search对贸易路线合规结果中标记的特定 HS 编码和国家组合,执行深入的商品级贸易流分析
NOAA Weather Alerts获取港口中断预测返回的海上天气事件的完整 NOAA 警报文本和受影响区域的地理范围
GDACS Disaster Alerts获取航线附近标记灾害的完整 GDACS 事件详情,包括受影响人口、强度和地理范围

局限性

  • 无法实时追踪 AIS 船舶。 此服务无法访问实时船舶位置数据。要获取船舶的实际位置、航向以及抵达/离开港口事件,需要使用 MarineTraffic、VesselFinder 或 Spire Maritime 等专业 AIS 服务。
  • 制裁数据反映查询时的情况。 系统会实时查询 OFAC SDN 和 OpenSanctions,但不会持续监控。今天通过筛查的船舶明天可能就会被列入 SDN 名单。如需持续覆盖,请安排每日筛查。
  • 企业注册信息的覆盖范围因司法管辖区而异。 OpenCorporates 对美国、英国、欧盟和英联邦国家的覆盖较为全面。对于保密性较强的司法管辖区——规避制裁所用空壳公司往往在这些地区注册——其覆盖范围受到这些司法管辖区的有意限制。
  • GLEIF 的 LEI 覆盖范围基于自愿注册。 并非所有航运实体都必须注册 LEI。没有 LEI 并不能证明公司不合法;这意味着 GLEIF 无法对其进行独立验证。
  • 贸易流数据存在发布延迟。 最近 6-12 个月的 UN COMTRADE 数据可能尚未针对所有国家/地区对发布。对于发布延迟较短的商品,系统检测近期航线变化的效果可能不佳。
  • NOAA 和 GDACS 在监测基础设施完善的地区覆盖最全面。 对于偏远海域或缺乏密集气象站网络的地区,其风暴追踪和灾害警报的覆盖粒度可能不及主要港口地区。
  • HHI 集中度评分需要充足的 COMTRADE 数据。 对于小众商品或规模较小的双边贸易,COMTRADE 可能返回很少甚至没有记录,导致 HHI 计算不可靠。空数据得出的 HHI 为 0,与贸易多元化得出的 HHI 为 0 并不相同。
  • 船名匹配置信度仅为近似值。 船名经常会音译、缩写,或在所有权转让后更改。请务必在条件允许时通过 IMO 编号查询补充基于名称的筛查。

集成

  • Apify API — 通过合规自动化流水线以编程方式调用 MCP 端点,或从 ERP/TMS 系统触发船舶筛查
  • Zapier — 在系统中新增航次订单时触发筛查;将 HIGH/CRITICAL 判定推送到 Slack 合规频道
  • Make — 构建多步骤工作流,对船舶进行筛查、使用企业数据丰富结果,并归档合规记录
  • Webhooks — 当 vessel_fleet_risk_report 返回 DO_NOT_ENGAGE,或制裁命中数超过阈值时触发警报
  • Google Sheets — 在合规跟踪表中记录筛查结果,包括综合评分、判定结果和时间戳
  • LangChain / LlamaIndex — 将其集成为 Agent 工作流中的工具;使用海事情报输出作为依据,为大模型生成的尽职调查报告提供上下文

故障排查

  • 工具返回的信号为空,但预期应有风险标记 — 底层数据源可能未返回与查询词相关的结果。请尝试重新格式化实体名称、添加国家或地区作为上下文,或改用 IMO 编号,而不是船名。请确认你的 Apify API 令牌有足够的额度。
  • vessel_fleet_risk_report 比其他工具耗时更长 — 此工具会并行调用全部 8 个数据源。在网络状况较差或底层 Actor 队列繁忙时,可能需要 30-90 秒。每个 Actor 120 秒的超时设置可确保它不会无限期挂起。
  • 已知存在制裁风险,但综合评分似乎偏低 — 船舶制裁在综合评分中的权重为 30%。如果实体以变体名称列入名单,导致 OFAC 和 OpenSanctions 搜索未命中,评分就无法反映实际风险。请务必使用 IMO 编号核实,并尝试不同的拼写变体。
  • 飓风活跃区域的港口中断预报显示 CALM — NOAA 警报区域会根据你提供的港口名称,通过关键词进行匹配。如果名称与 NOAA 区域名称不符,请尝试使用范围更广的地区名称(例如,使用 “Gulf of Mexico” 代替 “Port of Veracruz”)。
  • 首次调用时提示达到支出限额 — 你的 Apify 账户可能配置了很低的单次运行支出限额。请在 Apify Console 中检查 Settings > Monetization,并在重试前调整支出限额。

负责任地使用

  • 此 MCP 服务会查询来自官方政府来源(OFAC、NOAA、GDACS、UN COMTRADE)的公开数据,以及开放的企业注册数据。
  • 风险评分仅供参考,不构成法律认定。在对交易对手采取任何不利行动之前,对于 HIGH 或 CRITICAL 判定,必须由人工进行合规审查。
  • 遵守 OFAC 制裁是美国的一项法律义务。请务必就制裁合规决策咨询具备资质的法律顾问,切勿仅依赖算法评分。
  • 请遵守各底层数据源的服务条款。查询量不得对公共 API 造成不合理负载。
  • 有关网页抓取合法性的指导,请参阅 Apify's guide。

常见问题

海运情报筛查与 Dow Jones 或 Accuity 等专业制裁筛查平台有何不同? 此 MCP 会直接查询来自 OFAC 和 OpenSanctions 的实时一手来源数据,而不是将数据汇总到专有数据库中。一手来源查询结果在查询时始终保持最新。代价是,专业平台还包含此处不具备的专有实体解析、不利媒体报道和所有权关系图数据库。对于希望以远低于企业级平台的成本,通过 AI 助手集成进行一手来源筛查的团队来说,此 MCP 最合适。

一次运行中可以筛查多少艘船舶? 每次工具调用只筛查一个实体。进行船队筛查时,请针对每艘船舶调用一次 vessel_fleet_risk_report。每个会话的调用次数没有硬性限制;最高成本由支出限额控制。筛查一支由 20 艘船舶组成的船队,工具调用费用为 $0.90。

海运情报是否既适用于船运公司,也适用于船舶? 是。除船名外,所有工具都接受公司名称、运营方名称和受益所有人姓名。shipping_counterparty_screen 工具专为交易对手公司设计;vessel_sanctions_screening 既适用于单艘船舶,也适用于其运营公司。 便利旗检测的准确度如何? 该模型跟踪 23 个便利旗注册地和 13 个高风险司法管辖区。检测依据 OpenCorporates 和 GLEIF 记录中的司法管辖区字段。准确度取决于特定实体的公司注册数据是否完整。对于注册文件齐全、记录完善的航运公司,检测准确度很高。对于新成立或记录极少的实体,司法管辖区数据可能缺失。

我可以将此 MCP 服务与 Cursor、Windsurf 或其他 AI 编码工具搭配使用吗? 可以。任何支持 StreamableHTTP 传输的 MCP 兼容客户端都可以连接到 https://maritime-shipping-intelligence-mcp.apify.actor/mcp。Cursor、Windsurf、Cline 及类似工具均支持此标准。将该 URL 与 Apify API 令牌一同添加到 MCP 客户端配置中即可。

此服务查询的 OFAC SDN 数据有多新? OFAC Sanctions Search actor 会在查询时获取实时 OFAC SDN 数据源。OFAC 会不定期更新 SDN 名单;重大新增内容会在同一工作日公布。MCP 工具调用与实时数据源之间没有缓存层。

使用这些数据筛查船舶和公司合法吗? OFAC 筛查不仅合法,而且对于开展国际航运业务的美国个人和实体而言是法律要求。所有使用的数据源——OFAC、OpenSanctions、UN COMTRADE、NOAA、GDACS、OpenCorporates、GLEIF——均为政府或政府间组织的公开数据库。请参阅 Apify 关于网页抓取合法性的指南。

HHI 分数衡量什么?何时需要引起重视? 赫芬达尔-赫希曼指数用于衡量贸易航线集中度。HHI 为 0 表示贸易平均分散于多个合作伙伴;10,000 表示所有贸易都流经单一合作伙伴。美国司法部认为 HHI 超过 2,500 的市场高度集中。就贸易航线而言,HHI 超过 2,500 表示存在依赖单一合作伙伴的风险——如果该合作伙伴受到制裁或遭遇中断,整条航线都会受到影响。

我可以安排此 MCP 每天自动监控船队吗? 可以。使用 Apify 的计划功能,每天触发一次监控工作流。配合 Webhook 使用,可在任意船舶的综合评分超过阈值时接收通知;也可以使用 Apify API 轮询结果,并将其推送到合规管理系统。

数据源暂时不可用时会怎样? 每次 actor 调用都封装在 try/catch 代码块中。如果某个数据源调用失败,则会返回空数组,而不会抛出错误。评分模型能够妥善处理空数组,为受影响的维度生成较低的子评分。综合评分会以该维度的保守低分体现数据缺失——对于仍有其他活跃数据源的风险维度,数据缺失不会造成假阴性。

这与在 OFAC 网站上手动搜索有何不同? 手动进行 OFAC 搜索只能针对单个实体、使用单一数据源,并且只返回原始 SDN 数据,不提供评分。此 MCP 会同时交叉核对 8 个数据源,按匹配置信度加权,针对实益所有权风险评估企业链条,将结果与天气及贸易航线数据关联,并在一次工具调用中从你的 AI 助手内返回包含建议的结构化判定结果。

帮助我们改进

如果遇到问题,可以在 Apify 账户中启用运行共享,帮助我们更快地排查问题:

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

这样,在出现问题时我们就能查看你的运行详情,从而更快地修复问题。只有 Actor 开发者可以查看你的数据,不会公开显示。

支持

发现了错误或有功能请求?请在此 Actor 页面上的 问题选项卡中提交问题。如需定制解决方案或企业集成,请通过 Apify 平台联系我们。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。