前言¶

做跨境物流系统的人多半遇到过这类需求：用户丢过来一个集装箱号，要查它当前在哪个港口、挂靠哪条船、预计什么时候到港。承运人接口的问题在于每家都不一样，字段口径不同，响应格式也不统一，写一个对接脚本往往只服务一家船公司。下面介绍的这个 Skill 把这件事收敛到一个入口：给箱号、提单号或订舱号，它自己去查多个承运人源，把结果归一化后返回标准格式。

这是什么¶

「海运集装箱状态追踪」是一个 community 来源的 Agent Skill，坐标 @user_8aa5619a/ocean-container-tracking，当前版本 1.0.1，分类 business-ops，发布者 user_8aa5619a。它解决的问题是：把海运货物的状态查询变成一个自然语言或单条指令就能完成的操作，覆盖运输状态、当前位置、ETA/ETD、所属船舶和最新事件。

它不是独立实现，而是驱动本地的 cargo-tracking Python 包（同时提供 CLI 和 MCP 两种用法），由这个包完成多源承运人查询和结果归一化。

核心功能¶

1、三种入参：集装箱号（container number）、提单号（bill-of-lading / BL number）、订舱号（booking number）。

2、返回字段：运输状态、当前位置、ETA/ETD、船舶信息、最新事件。

3、多源查询与归一化：由底层 cargo-tracking 包执行承运人侧查询，把不同来源的结果统一成标准化 tracking result。

4、明确不支持的范畴：空运、国内快递/包裹、卡车零担（truck LTL）不在处理范围内。

安装与启用¶

已抓取的官方资料中没有给出安装命令、目录路径或配置字段，这一点需要到官方页面核对后再落到代码里。唯一能确认的前置条件是标签中的 requires_api_key=true，也就是说使用前必须先准备好并配置密钥，否则查询无法发起。

按通用 SKILL.md 格式的 Skill 通常这样启用：把该 Skill 目录放进 Agent 的 skills 目录，或在支持 SkillHub 的客户端里通过坐标 @user_8aa5619a/ocean-container-tracking 安装。具体命令以官方页面为准，此处不臆造。

底层依赖是 Python 包 cargo-tracking，可用 pip 安装后通过 CLI 调用，也可以作为 MCP 服务接入，两条路径都需要先完成密钥配置。

典型用法¶

官方简介里给出的几种触发方式：

1、查单个集装箱：track container TCKU3953453

2、查提单：查一下这个提单号 HLCUHAM260123456 到哪了

3、批量查箱：帮我批量查这几个箱号的海运状态

4、问清关状态：这票货清关了吗

这些都是自然语言指令，由 Agent 解析后转成对 cargo-tracking 的调用，再把归一化结果回传给用户。

适用场景与注意¶

适合的场景：需要在客服、订舱跟进、异常预警这类流程里自动回答「货到哪了」时，把这个 Skill 接到 Agent 上，避免为每个承运人单独写对接。

要注意的地方：

1、必须先完成 API key 配置，标签里已经标注 requires_api_key=true。

2、只覆盖海运，空运、国内快递、卡车零担不属于范围，接进去也不会得到有意义结果。

3、版本 1.0.1，来源是 community，发布者为 user_8aa5619a。上线前建议在自己手上的真实箱号/提单号上跑一遍，确认返回字段满足业务需要。

4、评分与下载量在不同抓取结果里不一致（一处显示评分 100000、下载 1715、安装 0），以 SkillHub 页面实时数据为准。

结尾¶

这个 Skill 的价值在于把多承运人的海运状态查询收敛成一次标准化调用，省掉每家接口各写一套的重复工作。需要进一步核对安装细节和承运人覆盖范围，可以看官方页面：https://www.skillhub.cn/skills/user_8aa5619a/ocean-container-tracking