中文快递查询（免api）

SKILL.md

---
name: cn-express-tracker
description: 中国快递物流查询工具。当用户需要查询顺丰、圆通、中通、申通、韵达、京东、EMS等中国快递公司的物流信息时使用。用户会说"帮我查个快递"、"快递到哪了"、"查一下物流"、"track my package"等。支持单号追踪和物流轨迹展示，无需API Key。Use for ANY Chinese express tracking requests.
---

# 中文快递查询 (CN Express Tracker)

## 概述

查询中国主流快递公司的物流信息，支持顺丰、圆通、中通、申通、韵达、京东、EMS/邮政、德邦、百世等 50+ 家快递公司。
无需 API Key，即装即用。

## 使用说明

### 快速查询

用户提供快递单号即可查询。脚本会自动识别快递公司（基于单号前缀）。

```
python3 scripts/track.py --num <快递单号>
```

### 指定快递公司

如果自动识别失败或不准确，可以手动指定快递公司代码：

```
python3 scripts/track.py --num <快递单号> --com <公司代码>
```

### 快递公司代码速查

| 代码 | 公司 |
|------|------|
| `shunfeng` / `sf` | 顺丰速运 |
| `yuantong` / `yt` | 圆通速递 |
| `zhongtong` / `zto` | 中通快递 |
| `shentong` / `sto` | 申通快递 |
| `yunda` / `yundaex` | 韵达快递 |
| `ems` | EMS |
| `youzhengguonei` / `post` | 中国邮政 |
| `jd` | 京东快递 |
| `huitongkuaidi` / `htky` | 百世快递 |
| `debangwuliu` / `deppon` | 德邦物流 |

完整代码表见 `references/courier-codes.md`。

## 工作流程

### 方法 1：用户提供了单号 + 快递公司（首选）

1. 用户直接说"帮我查顺丰快递 SF1234567890"
2. 运行：`python3 scripts/track.py --num SF1234567890 --com shunfeng`
3. 将完整结果返回给用户

### 方法 2：用户只提供了单号

1. 用户说"帮我查这个快递 YT7450353838751"
2. 先运行脚本自动识别：`python3 scripts/track.py --num YT7450353838751`
3. 如果结果异常（无数据），联系用户确认快递公司后再查
4. 将完整结果返回给用户

### 方法 3：用户想查多个快递

1. 用户说"帮我查这三个快递到哪了"
2. 逐个查询每个单号
3. 汇总所有结果返回给用户

## 输出格式说明

查询结果包含：
- **快递公司** — 承运方名称
- **快递单号** — 查询的单号
- **当前状态** — 在途/已揽收/派件中/已签收/疑难...
- **物流轨迹** — 按时间倒序排列的所有物流节点（时间和地点）
- **详情链接** — 快递100查看链接

## 常见场景与话术

### "帮我查个快递"
→ 追问单号和快递公司，或引导用户直接提供单号

### "快递到哪了 / 物流信息"
→ 让用户提供单号，用脚本查询

### "查顺丰/圆通/中通..."
→ 使用对应代码 + 单号，--com 参数指定公司

### 查询失败时的应对
- 确认单号是否输错（数字字母组合）
- 确认选择了正确的快递公司
- 新寄出的快递可能需要几小时才会更新
- 顺丰单号部分需要寄件人或收件人手机号后四位（单独询问用户）

## 技术说明

- 数据来源：快递100（kuaidi100.com）免费查询接口
- 脚本使用 Python 标准库（urllib），无需安装额外依赖
- 无需配置 API Key
- 单号查询频率建议 >30 分钟/次，过于频繁可能导致短时封禁