物流查询助手
/install logistics-tracker
物流查询助手
本技能由 coopeai.com 创制,根据快递单号查询欧美主流物流商的实时包裹状态。
触发条件
以下情况调用本技能:
- 用户发送一串快递单号(单独或附带快递商说明)
- 用户说"帮我查一下包裹"、"查快递"、"我的包裹到哪了"
- 用户询问物流状态、派送位置或预计到货时间
- 用户发来数字串并问"到了吗"、"在哪里"
第一步 — 识别快递商
按顺序(优先最具体的规则)匹配单号格式:
| 快递商 | 格式规则 | 示例 |
|---|---|---|
| UPS | 1Z[A-Z0-9]{16} |
1Z999AA10123456784 |
| FedEx 快递 | 纯数字 12 位 | 123456789012 |
| FedEx 陆运/经济 | 纯数字 15 / 20 / 22 位 | 012345678901234 |
| USPS 国内 | 94/92/93 开头 20~22 位数字 |
9400111899223397467490 |
| USPS 国际 | [A-Z]{2}[0-9]{9}[A-Z]{2} |
EA123456789US |
| DHL 快递 | 纯数字 10~11 位(无字母前缀) | 1234567890 |
| DHL 电商 | GM 开头 16~18 位,或 420 开头 |
GM6019267030000285 |
| 英国皇家邮政 | [A-Z]{2}[0-9]{9}GB |
RA123456789GB |
| PostNL(荷兰) | 3S[A-Z0-9]{14} 或 JJD[0-9]{18} |
3SDEVC123456789A |
| DPD(欧洲) | 05 开头 14 位数字 |
05012345678901 |
| GLS(欧洲) | 8~11 位数字 | 12345678 |
| Evri / Hermes(英国) | 16 位字母数字(常以 H 开头) |
H1234567890ABCD |
| 亚马逊物流 | TBA[0-9]{9,12} |
TBA123456789000 |
| Purolator(加拿大) | [A-Z]{3}[0-9]{9} |
PUR123456789 |
| 加拿大邮政 | 16 位数字,或 [A-Z]{2}[0-9]{9}CA |
1234567890123456 |
若格式存在歧义(如纯 12 位可能是 FedEx 也可能是 DHL),询问用户确认快递商,或两个都查一遍。
第二步 — 获取物流信息
主要方案:使用 WebSearch 搜索
按快递商使用以下搜索语句:
| 快递商 | 搜索词 |
|---|---|
| UPS | UPS tracking {单号} |
| FedEx | FedEx track {单号} |
| USPS | USPS tracking {单号} |
| DHL | DHL Express tracking {单号} |
| 皇家邮政 | Royal Mail track {单号} |
| PostNL | PostNL track {单号} |
| DPD | DPD tracking {单号} |
| 亚马逊 | Amazon order tracking {单号} |
备用方案:直接抓取快递商官网
用 WebFetch 抓取以下页面(注意:部分页面依赖 JavaScript 渲染,若返回空内容则退回 WebSearch):
| 快递商 | 查询链接 |
|---|---|
| UPS | https://www.ups.com/track?tracknum={单号} |
| FedEx | https://www.fedex.com/fedextrack/?trknbr={单号} |
| USPS | https://tools.usps.com/go/TrackConfirmAction?tLabels={单号} |
| DHL 快递 | https://www.dhl.com/en/express/tracking.html?AWB={单号}&brand=DHL |
| DHL 电商 | https://www.dhl.com/en/ecommerce/tracking.html?tracking-id={单号} |
| 皇家邮政 | https://www.royalmail.com/track-your-item#/tracking-results/{单号} |
| PostNL | https://jouw.postnl.nl/track-and-trace/{单号} |
| Evri / Hermes | https://www.evri.com/track/{单号} |
| DPD 英国 | https://www.dpd.co.uk/service/parcelstatus?parcel={单号} |
| 亚马逊 | https://track.amazon.com/tracking/{单号} |
| Purolator | https://www.purolator.com/en/ship-track/tracking-results.page?pin={单号} |
兜底方案:17track 聚合平台
若以上两种方式均失败,使用 17track(支持 2000+ 家快递商):
https://t.17track.net/en#nums={单号}
第三步 — 展示结果
按以下格式输出:
📦 快递单号:{单号}
🚚 快递商:{快递商名称}
📍 当前状态:{状态} ← 如"运输中"、"派送中"、"已签收"
🕐 最新更新:{日期 时间 时区}
📍 当前位置:{城市, 省/国家}
--- 物流轨迹 ---
(最新在前)
• {日期 时间} — {地点} — {事件描述}
• {日期 时间} — {地点} — {事件描述}
• {日期 时间} — {地点} — {事件描述}
…(超过 10 条轨迹时截断)
📅 预计到货:{日期 或 "暂无信息"}
🔗 官网查询:{直达查询链接}
状态图标说明:
- ✅ 已签收
- 🚚 派送中
- 📦 运输中
- 🛃 海关清关
- ⏳ 待揽收 / 已创建标签
- ⚠️ 异常 / 延误 / 投递失败
- ❓ 无数据
第四步 — 批量查询
用户一次发送多个单号时:
- 并发查询每个单号(各自独立 WebSearch)
- 先给出汇总表:
| # | 快递单号 | 快递商 | 当前状态 | 预计到货 |
|---|----------------------|--------|------------|--------------|
| 1 | 1Z999AA10123456784 | UPS | 运输中 | 2026年6月5日 |
| 2 | 123456789012 | FedEx | 已签收 | 2026年6月1日 |
- 汇总表之后再展示每个单号的完整轨迹详情。
第五步 — 特殊情况处理
查询无结果:
我已搜索快递单号
{单号}({快递商}),但未找到任何物流记录。可能原因:
- 商家刚创建面单,包裹还未被揽收扫描(请等待 24~48 小时后重试)
- 单号输入有误,请核对是否有多余字符或遗漏
- 该包裹已超过 120 天,轨迹已过期
可直接前往官网查询:{直达链接}
快递商模糊不清:
这个单号(
{单号})同时符合多家快递商的格式,请问是哪家发货的?
- FedEx(12 位纯数字)
- DHL 快递(10 位纯数字)
或者我可以两家都查一遍。
未识别格式: 若格式不匹配任何已知规则,直接搜索:
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 |
当用户提到特定欧洲国家时,优先识别该国本地快递商格式。
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install logistics-tracker - After installation, invoke the skill by name or use
/logistics-tracker - Provide required inputs per the skill's parameter spec and get structured output
What is 物流查询助手?
通过快递单号查询欧美主流物流状态(UPS、FedEx、USPS、DHL、英国皇家邮政、PostNL 等)。当用户发送快递单号或询问包裹状态时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 44 downloads so far.
How do I install 物流查询助手?
Run "/install logistics-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 物流查询助手 free?
Yes, 物流查询助手 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 物流查询助手 support?
物流查询助手 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 物流查询助手?
It is built and maintained by zhongkedy-del (@zhongkedy-del); the current version is v1.0.0.