物流查询助手

本技能由 coopeai.com 创制，根据快递单号查询欧美主流物流商的实时包裹状态。

触发条件

以下情况调用本技能：

• 用户发送一串快递单号（单独或附带快递商说明）
• 用户说"帮我查一下包裹"、"查快递"、"我的包裹到哪了"
• 用户询问物流状态、派送位置或预计到货时间
• 用户发来数字串并问"到了吗"、"在哪里"

第一步 — 识别快递商

按顺序（优先最具体的规则）匹配单号格式：

> 若格式存在歧义（如纯 12 位可能是 FedEx 也可能是 DHL），询问用户确认快递商，或两个都查一遍。

第二步 — 获取物流信息

Track123 API

调用 Track123 REST API（支持 1700+ 家快递商）。

API Key 配置（仅首次需要）

若下方 curl 命令中仍含 $TRACK123_API_KEY，请用户访问 https://www.track123.com/api → Dashboard → API 标签页 → 复制 Key 并粘贴到这里。收到后，将本 Skill 文件中的 $TRACK123_API_KEY 替换为真实 Key 值。

第一步 — 注册快递单号：

curl -s -X POST "https://api.track123.com/gateway/open-api/tk/v2/track/import" \
  -H "Track123-Api-Secret: $TRACK123_API_KEY" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '[{"trackNo": "{单号}"}]'

第二步 — 查询物流状态：

curl -s -X POST "https://api.track123.com/gateway/open-api/tk/v2/track/query" \
  -H "Track123-Api-Secret: $TRACK123_API_KEY" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{"trackNos": ["{单号}"]}'

解析返回的 JSON（data.accepted.content[0]），提取以下字段：

• transitStatus — 总体状态（如 DELIVERED、IN_TRANSIT）
• deliveredTime / lastTrackingTime — 最后更新时间
• localLogisticsInfo.trackingDetails — 轨迹事件数组（最新在前），每条含 eventTime、address、eventDetail
• expectedDeliveryTime — 预计到货时间段
• localLogisticsInfo.courierTrackingLink — 快递商官网追踪直链

按第三步格式展示结果。

第三步 — 展示结果

按以下格式输出：

📦 快递单号：{单号}
🚚 快递商：{快递商名称}
📍 当前状态：{状态}  ← 如"运输中"、"派送中"、"已签收"
🕐 最新更新：{日期 时间 时区}
📍 当前位置：{城市, 省/国家}

--- 物流轨迹 ---
（最新在前）
• {日期 时间} — {地点} — {事件描述}
• {日期 时间} — {地点} — {事件描述}
• {日期 时间} — {地点} — {事件描述}
  …（超过 10 条轨迹时截断）

📅 预计到货：{日期 或 "暂无信息"}
🔗 官网查询：{直达查询链接}

状态图标说明：

• ✅ 已签收
• 🚚 派送中
• 📦 运输中
• 🛃 海关清关
• ⏳ 待揽收 / 已创建标签
• ⚠️ 异常 / 延误 / 投递失败
• ❓ 无数据

第四步 — 批量查询

用户一次发送多个单号时：

1. 并发查询每个单号（各自独立 WebSearch）
2. 先给出汇总表：

| # | 快递单号               | 快递商  | 当前状态    | 预计到货       |
|---|----------------------|--------|------------|--------------|
| 1 | 1Z999AA10123456784   | UPS    | 运输中      | 2026年6月5日  |
| 2 | 123456789012         | FedEx  | 已签收      | 2026年6月1日  |

1. 汇总表之后再展示每个单号的完整轨迹详情。

第五步 — 特殊情况处理

查询无结果：

> 我已搜索快递单号 {单号}（{快递商}），但未找到任何物流记录。可能原因：

> - 商家刚创建面单，包裹还未被揽收扫描（请等待 24~48 小时后重试）

> - 单号输入有误，请核对是否有多余字符或遗漏

> - 该包裹已超过 120 天，轨迹已过期

>

> 可直接前往官网查询：{直达链接}

快递商模糊不清：

> 这个单号（{单号}）同时符合多家快递商的格式，请问是哪家发货的？

> - FedEx（12 位纯数字）

> - DHL 快递（10 位纯数字）

>

> 或者我可以两家都查一遍。

未识别格式：

若格式不匹配任何已知规则，直接搜索：

track package "{单号}"

根据搜索结果判断快递商后再展示结果。

快速参考：各地区主流快递商

> 当用户提到特定欧洲国家时，优先识别该国本地快递商格式。