物流查询助手#

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

触发条件#

以下情况调用本技能：

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

---

第一步 — 识别快递商#

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

快递商格式规则示例UPS1Z[A-Z0-9]{16}``1Z999AA10123456784FedEx 快递纯数字 12 位123456789012FedEx 陆运/经济纯数字 15 / 20 / 22 位012345678901234USPS 国内94/92/93 开头 2022 位数字9400111899223397467490USPS 国际[A-Z]{2}[0-9]{9}[A-Z]{2}``EA123456789USDHL 快递纯数字 1011 位（无字母前缀）1234567890DHL 电商GM 开头 1618 位，或 420 开头GM6019267030000285英国皇家邮政[A-Z]{2}[0-9]{9}GB``RA123456789GBPostNL（荷兰）3S[A-Z0-9]{14} 或 JJD[0-9]{18}``3SDEVC123456789ADPD（欧洲）05 开头 14 位数字05012345678901**GLS（欧洲）**811 位数字12345678**Evri / Hermes（英国）**16 位字母数字（常以 H 开头）H1234567890ABCD亚马逊物流TBA[0-9]{9,12}``TBA123456789000Purolator（加拿大）[A-Z]{3}[0-9]{9}``PUR123456789加拿大邮政16 位数字，或 [A-Z]{2}[0-9]{9}CA``1234567890123456

若格式存在歧义（如纯 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 值。

第一步 — 注册快递单号：

bash

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": "{单号}"}]'

第二步 — 查询物流状态：

bash

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 — 快递商官网追踪直链

按第三步格式展示结果。

---

第三步 — 展示结果#

按以下格式输出：

text

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

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

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

状态图标说明：

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

---

第四步 — 批量查询#

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

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

text

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

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

---

第五步 — 特殊情况处理#

查询无结果：

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

• 商家刚创建面单，包裹还未被揽收扫描（请等待 24~48 小时后重试）
• 单号输入有误，请核对是否有多余字符或遗漏
• 该包裹已超过 120 天，轨迹已过期

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

快递商模糊不清：

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

• FedEx（12 位纯数字）
• DHL 快递（10 位纯数字）

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

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

text

track package "{单号}"

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

---

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

地区主流快递商美国UPS、FedEx、USPS、Amazon Logistics、OnTrac、LaserShip英国英国皇家邮政 Royal Mail、Evri/Hermes、DPD UK、Parcelforce、Yodel德国DHL Paket、Hermes DE、DPD DE、GLS、UPS DE法国La Poste/Colissimo、Chronopost、DHL FR、DPD FR、Mondial Relay荷兰PostNL、DHL NL、DPD NL、GLS NL西班牙Correos、SEUR、MRW、GLS ES、DHL ES意大利Poste Italiane、BRT、GLS IT、DHL IT、SDA加拿大Canada Post、Purolator、FedEx CA、UPS CA

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