关于 Maritime Shipping Intelligence
面向货运、保险和贸易合规团队的海事风险情报 MCP 服务。它整合 8 个数据源,提供制裁筛查、港口中断预测、航线核查和风险评分报告等工具。
主要功能
- 01提供 8 种海事风险分析工具
- 02制裁与企业注册信息筛查
- 03港口天气及中断预测
- 04贸易航线与货物原产地核查
- 05加权综合风险评分
- 06并行查询多个数据源
适用场景
- 01订舱前筛查船舶及其所有者
- 02规划到港时评估港口中断风险
- 03为保险承保审核交易对手
- 04核查货物原产地及航线的制裁风险
MCP 相关
该 MCP 服务提供 8 种工具,用于船舶和交易对手筛查、天气及中断预测、贸易与货物核查以及船队报告。MCP 客户端可获得结构化结果,包括加权综合风险评分和判定。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcpclaude mcp add --transport http maritime-shipping-intelligence https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcp{"mcpServers":{"maritime-shipping-intelligence":{"type":"http","url":"https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcp"}}}在 Cursor 中打开{"servers":{"maritime-shipping-intelligence":{"type":"http","url":"https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcp"}}}在 VS Code 中打开{"mcpServers":{"maritime-shipping-intelligence":{"type":"http","url":"https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcp"}}}{"mcpServers":{"maritime-shipping-intelligence":{"serverUrl":"https://ryanclinton--maritime-shipping-intelligence-mcp.apify.actor/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
海运情报 MCP 服务
快速开始
添加到你的 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 List | OFAC 特别指定国民登记册上的船舶、运营商和受益所有人 |
| 🔎 多司法辖区监控名单 | OpenSanctions | 40 多个整合项目:EU、UN、UK、OFAC、Interpol——按实体交叉匹配 |
| 🚢 国际贸易流 | UN COMTRADE | 200 多个国家的双边商品流——用于 HHI 集中度评分 |
| 🌀 严重海事天气 | NOAA | 影响港口运营的飓风、大风、热带风暴、风暴潮和海啸警报 |
| 🌍 自然灾害监测 | GDACS | 航道附近的红色/橙色气旋、地震、洪水和海啸事件 |
| 🏢 企业注册记录 | OpenCorporates | 船舶所有人的注册成立信息、司法辖区、申报数量和解散状态 |
| 🔗 法人实体识别编码 | GLEIF LEI | LEI 签发状态、注册信息时效性和实体关系链 |
| 🌤 航线天气预报 | 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 客户端使用海事航运情报
- 连接 MCP 服务 — 将服务 URL
https://maritime-shipping-intelligence-mcp.apify.actor/mcp添加到 MCP 客户端配置中。对于 Claude Desktop,将其添加到claude_desktop_config.json。无需编写代码。 - 使用自然语言提问 — 向 AI 提问:“筛查船舶 Pacific Carrier 的制裁风险”或“本周鹿特丹港的中断风险如何?”AI 会自动选择合适的工具。
- 查看评分结果 — 工具会返回风险评分、结论和具体信号(例如:“2 条 SDN 匹配记录——OFAC 封锁实体”“HHI 3200——贸易路线高度集中”)。可以让 AI 总结结果或起草合规备忘录。
- 导出或升级处理 — 将结果复制到合规系统中,向案例管理工具触发 webhook,或让 AI 生成可供合规专员使用的格式化报告。
MCP 工具
| 工具 | 价格 | 参数 | 描述 |
|---|---|---|---|
vessel_sanctions_screening | $0.045 | entity、port(可选) | 根据 OFAC SDN、OpenSanctions 和企业注册信息筛查船舶或航运公司 |
port_disruption_forecast | $0.045 | port、timeframe(可选) | 预测恶劣天气、灾害和海事风险导致的港口中断 |
trade_route_compliance | $0.045 | commodity、country(可选) | 评估贸易路线合规性:HHI 集中度、受制裁路线检测、贸易流风险 |
flag_state_risk_check | $0.045 | entity | 检查船旗国风险:方便旗、高风险司法管辖区、监管监督质量 |
shipping_counterparty_screen | $0.045 | company | 筛查航运交易对手:LEI 验证、企业透明度、制裁风险 |
maritime_weather_risk | $0.045 | route | 评估航运路线的海事天气风险:风暴追踪、能见度、风力、海况 |
cargo_origin_verification | $0.045 | commodity、origin | 验证货物原产地:贸易流分析、转运风险、受制裁原产地检测 |
vessel_fleet_risk_report | $0.045 | entity、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 |
allSignals | string[] | 汇总五个维度所有风险信号的列表 |
recommendations | string[] | 根据得分最高的风险因素提供的可执行整改步骤 |
海运情报的费用是多少?
此 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 秒后退出。
获得最佳结果的提示
-
对高价值交易对手使用完整船队报告。
vessel_fleet_risk_report工具可在一次调用中协调全部 8 个数据源。对于超过重要性阈值的交易对手,相比单独调用各个工具,多花 $0.045 获得更全面的信息是值得的。 -
IMO 编号有助于提高制裁匹配的精确度。 OFAC SDN 条目中经常包含船舶的 IMO 编号。传入“IMO 9321483”,而不是船名,可以减少因名称变体和转写差异导致的误报。
-
对两用商品结合货物原产地核验。 对于存在制裁敏感性的商品——原油、精炼石油、金属、半导体——将
trade_route_compliance与cargo_origin_verification搭配使用,以检测直接航线风险以及经中间国家转运的情况。 -
为自动筛查工作流设置支出限额。 如果将此 MCP 接入用于筛查新收到的航次订单的自动化工作流,请配置 Apify 的单次运行支出限额,将每日支出控制在固定金额内。
-
结合受制裁航线数量解读 HHI。 HHI 较高(航线集中)但未命中任何受制裁航线,意味着存在依赖风险,但没有合规风险。HHI > 2,500 且受制裁航线 > 0,说明需要立即开展合规审查。
-
所有权变更后重新筛查。 OpenCorporates 的公司注册数据反映的是查询时的状态。船舶所有者、运营商或船旗国发生变化后,请再次进行筛查,尤其是在关联实体之间转让船舶之后。
-
在离港前而非抵港前查询港口中断预测。 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 账户中启用运行共享,帮助我们更快地排查问题:
- 前往 账户设置 > 隐私
- 启用 与公开 Actor 创建者共享运行记录
这样,在出现问题时我们就能查看你的运行详情,从而更快地修复问题。只有 Actor 开发者可以查看你的数据,不会公开显示。
支持
发现了错误或有功能请求?请在此 Actor 页面上的 问题选项卡中提交问题。如需定制解决方案或企业集成,请通过 Apify 平台联系我们。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。