SuperAPI AI 工具集

logistics-tracking

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:通过运单号查询国际包裹物流状态,适用于用户询问“我的包裹在哪”、提供运单号、需要查看运输状态或派送预估、清关与物流异常,以及一次追踪多个包裹的场景。

主要能力:提供四个工具。track_package 查询单个包裹,输入 trackingNumber(必填)与可选 carrier(自动识别),返回状态、当前位置与事件时间线;detect_carrier 根据运单号格式识别承运商,返回名称与置信度;batch_track 一次最多追踪 40 个包裹,输入运单号数组;explain_status 对状态码(如 InTransit、CustomsClearance、Delivered)给出英文说明与建议。

使用方式:两种模式。设置 TRACK17_API_KEY 时走官方 api.17track.net,覆盖 3100+ 承运商、可靠性最高,可在 https://api.17track.net 获取免费密钥;不设密钥时使用 Playwright(无头 Chromium)查询 t.17track.net,需安装 playwright npm 包。部署方式分两类:作为 HTTP 服务时,服务端执行 export TRACK17_API_KEY=your-17track-api-key 后运行 npx -y @shopmeagent/logistics-tracking-mcp serve(默认 http://0.0.0.0:3000/mcp,可用 PORT、HOST 覆盖),终端用户通过 URL 以 streamable-http 连接,无需自备密钥;本地 stdio 模式可零配置运行 npx -y @shopmeagent/logistics-tracking-mcp,或在 env 中传入 TRACK17_API_KEY。在 OpenClaw 中可用 npx skills add shopmeskills/mcp 添加该技能,再配置上述 HTTP 或 stdio。

限制与提示:发货后建议等待 24-48 小时再查询,同一运单号两次查询间隔至少 2 小时以避免限流;批量查询比逐条更高效。资料未提供收费、价格与平台支持范围等信息。