\r \r

极速数据快递查询（Jisu Express）\r

\r

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r

前置配置：获取 API Key\r

\r

1. 前往 极速数据官网 注册账号\r
2. 进入 快递查询接口 页面，点击「申请数据」\r
3. 在会员中心获取 AppKey\r
4. 配置 Key：\r \r \r

# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/express/express.py`\r
\r
## 使用方式\r
\r
### 1. 基本查询（自动识别快递公司）\r
\r
```bash\r
python3 skills/express/express.py '{"number":"70303808964270","type":"auto"}'\r
```\r
\r
### 2. 指定快递公司\r
\r
```bash\r
python3 skills/express/express.py '{"number":"4303200322000","type":"yunda"}'\r
```\r
\r
### 3. 顺丰 / 中通 / 跨越（需手机号后四位）\r
\r
```bash\r
python3 skills/express/express.py '{"number":"931658943036","type":"sfexpress","mobile":"1234"}'\r
```\r
\r
### 4. 查询支持的快递公司列表（/express/type）\r
\r
```bash\r
python3 skills/express/express.py type\r
```\r
\r
返回值为数组，每项形如：\r
\r
```json\r
{\r
  "name": "德邦",\r
  "type": "DEPPON",\r
  "letter": "D",\r
  "tel": "95353",\r
  "number": "330060412"\r
}\r
```\r
\r
## 请求参数（查询时传入 JSON）\r
\r
| 字段名  | 类型   | 必填 | 说明                                             |\r
|--------|--------|------|--------------------------------------------------|\r
| number | string | 是   | 快递单号                                         |\r
| type   | string | 否   | 快递公司代号，默认 `auto` 自动识别               |\r
| mobile | string | 否   | 收/寄件人手机号后四位（顺丰 / 中通 / 跨越必填）  |\r
\r
示例：\r
\r
```json\r
{\r
  "number": "4303200322000",\r
  "type": "yunda"\r
}\r
```\r
\r
## 返回结果示例\r
\r
脚本直接输出接口的 `result` 字段，典型结构：\r
\r
```json\r
{\r
  "number": "4303200322000",\r
  "type": "yunda",\r
  "typename": "韵达快运",\r
  "logo": "https://api.jisuapi.com/express/static/images/logo/80/yunda.png",\r
  "list": [\r
    {\r
      "time": "2019-12-30 20:24:51",\r
      "status": "北京分拨中心进行装车扫描，发往：辽宁大连分拨中心"\r
    },\r
    {\r
      "time": "2019-12-30 01:18:48",\r
      "status": "北京分拨中心进行中转集包扫描，发往：辽宁大连分拨中心"\r
    }\r
  ],\r
  "deliverystatus": 3,\r
  "issign": 1\r
}\r
```\r
\r
错误时输出示例：\r
\r
```json\r
{\r
  "error": "api_error",\r
  "code": 206,\r
  "message": "快递单号错误"\r
}\r
```\r
\r
## 常见错误码\r
\r
来自 [极速数据快递文档](https://www.jisuapi.com/api/express) 的业务错误码：\r
\r
| 代号 | 说明                 |\r
|------|----------------------|\r
| 201  | 快递单号为空         |\r
| 202  | 快递公司为空         |\r
| 203  | 快递公司不存在       |\r
| 204  | 快递公司识别失败     |\r
| 205  | 没有信息             |\r
| 206  | 快递单号错误         |\r
| 208  | 单号没有信息（扣次） |\r
| 220  | 需要手机号后四位     |\r
\r
系统错误码：\r
\r
| 代号 | 说明                    |\r
|------|-------------------------|\r
| 101  | APPKEY 为空或不存在     |\r
| 102  | APPKEY 已过期           |\r
| 103  | APPKEY 无请求权限       |\r
| 104  | 请求超过次数限制        |\r
| 105  | IP 被禁止               |\r
\r
## 推荐用法\r
\r
1. 用户例如：「帮我查一下单号 `4303200322000` 的快递，看下这个快递单号`4303200322000`到哪了。」  \r
2. 代理在调用脚本时，应将用户提供的 `number` / `type` / `mobile` **放入结构化 JSON 参数中，而不是直接拼接到 shell 字符串里**，例如在内部构造形如：  \r
   `{"number": "\x3C快递单号>", "type": "\x3C快递公司代号>"}` 并作为第二个参数传给 `express.py`。  \r
3. 若必须通过 shell 执行，请务必对 JSON 与命令参数做严格转义/引用，禁止直接把原始用户输入插入到命令行中，以避免 shell 注入风险。  \r
4. 解析返回的 JSON，为用户总结：当前状态、是否签收、最近几条轨迹等。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换  \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r