快递查询 Skill
查询国内主流快递公司的物流状态,支持自动识别快递公司。
功能特点
- 自动识别快递公司:根据单号前缀自动判断快递公司
- 多公司支持:顺丰、中通、圆通、韵达、申通、极兔、京东、EMS、百世
- 实时物流轨迹:查询包裹的实时位置和运输状态
- 格式化输出:清晰展示物流时间线
使用方法
基本用法
python3 scripts/track.py <快递单号>
指定快递公司
python3 scripts/track.py <快递单号> <快递公司编码>
顺丰快递(需要手机号后四位)
python3 scripts/track.py SF1234567890 shunfeng 1234
支持的快递公司
| 编码 | 名称 | 备注 |
|---|---|---|
| shunfeng | 顺丰速运 | 需要手机号后四位 |
| zhongtong | 中通快递 | 自动识别 |
| yuantong | 圆通速递 | 自动识别 |
| yunda | 韵达快递 | 自动识别 |
| shentong | 申通快递 | 自动识别 |
| jtexpress | 极兔速递 | 自动识别 |
| jd | 京东物流 | 自动识别 |
| ems | 邮政EMS | 自动识别 |
| huitongkuaidi | 百世快递 | 自动识别 |
配置说明
在 config.json 中配置快递100 API 密钥:
{
"key": "YOUR_API_KEY",
"customer": "YOUR_CUSTOMER_ID",
"default_phone": "手机号后四位(顺丰用)"
}
API 限制
- 免费额度:100次/天
- 顺丰快递需要提供手机号后四位
工作流程
- 用户询问快递状态
- 优先询问单号(而非自动查询历史)
- 自动识别快递公司或手动指定
- 调用快递100 API 查询
- 格式化返回物流轨迹
示例输出
📦 顺丰速运
📌 单号: SF1234567890
📍 状态: 派件中
📋 物流轨迹:
📍 2024-03-07 10:30 正在派送中,派送员:张三,电话:138****1234
2024-03-07 08:15 到达 北京朝阳区分拨中心
2024-03-06 22:00 离开 上海转运中心
2024-03-06 18:30 已揽收