快递物流查询 - Express Logistics Track
查快递物流轨迹与签收状态,支持自动识别公司与顺丰等校验。当用户说:这个单号到哪了?帮我查一下中通物流,或类似快递查询时,使用本技能。 Skill: 快递物流查询 - Express Logistics Track Owner: jisuapi Summary: 查快递物流轨迹与签收状态,支持自动识别公司与顺丰等校验。当用户说:这个单号到哪了?帮我查一下中通物流,或类似快递查询时,使用本技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-10T07:59:37.148Z | user - Removed documentation file skill-card.md. - No functional or user-facing changes. v1.0.6 | 2026-04-03T09:48:33.199Z | user - Skill名称和描述优化,更突出应用场景(快递物流查询)并添加面向用户的指引语。 - 丰富了推荐用法示例,更加贴合实际用户提问表达。 - 微调部分说明和标题,使技能易于理
Rank
62
Safety
84
Downloads
2.1k
Updated
Oct 9, 2026
Version
1.0.7
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.1K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2.1K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.0.7release · observed Sep 10, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s174fh1b14sn7vkvbqwsdn0xtd83gz5h:express- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-express/snapshot"
Documentation
CLAWHUB
36,763 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: "Express Logistics Track - 快递物流查询"
description: 查快递物流轨迹与签收状态,支持自动识别公司与顺丰等校验。当用户说:这个单号到哪了?帮我查一下中通物流,或类似快递查询时,使用本技能。
metadata: { "openclaw": { "emoji": "📦", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }
---
# 极速数据快递查询(Jisu Express)
> 数据由 **[极速数据(JisuAPI)](https://www.jisuapi.com/)** 提供 — 国内专业的 API 数据服务平台,提供生活常用、交通出行、工具万能等数据接口。
## 前置配置:获取 API Key
1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号
2. 进入 [快递查询接口](https://www.jisuapi.com/api/express) 页面,点击「申请数据」
3. 在会员中心获取 **AppKey**
4. 配置 Key:
```bash
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
```
## 脚本路径
脚本文件:`skills/express/express.py`
## 使用方式
### 1. 基本查询(自动识别快递公司)
```bash
python3 skills/express/express.py '{"number":"70303808964270","type":"auto"}'
```
### 2. 指定快递公司
```bash
python3 skills/express/express.py '{"number":"4303200322000","type":"yunda"}'
```
### 3. 顺丰 / 中通 / 跨越(需手机号后四位)
```bash
python3 skills/express/express.py '{"number":"931658943036","type":"sfexpress","mobile":"1234"}'
```
### 4. 查询支持的快递公司列表(/express/type)
```bash
python3 skills/express/express.py type
```
返回值为数组,每项形如:
```json
{
"name": "德邦",
"type": "DEPPON",
"letter": "D",
"tel": "95353",
"number": "330060412"
}
```
## 请求参数(查询时传入 JSON)
| 字段名 | 类型 | 必填 | 说明 |
|--------|--------|------|--------------------------------------------------|
| number | string | 是 | 快递单号 |
| type | string | 否 | 快递公司代号,默认 `auto` 自动识别 |
| mobile | string | 否 | 收/寄件人手机号后四位(顺丰 / 中通 / 跨越必填) |
示例:
```json
{
"number": "4303200322000",
"type": "yunda"
}
```
## 返回结果示例
脚本直接输出接口的 `result` 字段,典型结构:
```json
{
"number": "4303200322000",
"type": "yunda",
"typename": "韵达快运",
"logo": "https://api.jisuapi.com/express/static/images/logo/80/yunda.png",
"list": [
{
"time": "2019-12-30 20:24:51",
"status": "北京分拨中心进行装车扫描,发往:辽宁大连分拨中心"
},
{
"time": "2019-12-30 01:18:48",
"status": "北京分拨中心进行中转集包扫描,发往:辽宁大连分拨中心"
}
],
"deliverystatus": 3,
"issign": 1
}
```
错误时输出示例:
```json
{
"error": "api_error",
"code": 206,
"message": "快递单号错误"
}
```
## 常见错误码
来自 [极速数据快递文档](https://www.jisuapi.com/api/express) 的业务错误码:
| 代号 | 说明 |
|------|----------------------|
| 201 | 快递单号为空 |
| 202 | 快递公司为空 |
| 203 | 快递公司不存在 |
| 204 | 快递公司识别失败 |
| 205 | 没有信息 |
| 206 | 快递单号错误 |
| 208 | 单号没有信息(扣次) |
| 220 | 需要手机号后四位 |
系统错误码:
| 代号 | 说明 |
|------|-------------------------|
| 101 | APPKEY 为空或不存在 |
| 102 | APPKEY 已过期 |
| 103 | APPKEY 无请求权限 |
| 104 | 请求超过次数限制 |
| 105 | IP 被禁止 |
## 推荐用法
1. 用户例如:「帮我查一下_meta.json
{
"ownerId": "kn7ex9mabfb47dvpgkmeypwqj9825yyz",
"slug": "express",
"version": "1.0.7",
"publishedAt": 1789027177148
}skill-card.md
## Description: Tracks express logistics status and delivery history through JisuAPI, including automatic courier recognition and courier-specific validation when required. This skill is ready for commercial/non-commercial use. ## Publisher: [jisuapi](https://clawhub.ai/user/jisuapi) ### License/Terms of Use: MIT-0 ## Use Case: External users and developers use this skill to check package tracking status, signature state, and recent logistics events from an agent workflow. It is useful when a user provides a tracking number and optionally a courier code or phone-number suffix needed by specific couriers. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Shipment tracking numbers, courier type, the JisuAPI key, and sometimes the last four phone digits are sent to JisuAPI. Mitigation: Use the skill only when that third-party sharing is acceptable, and avoid sensitive shipments unless the data-sharing terms are approved. Risk: User-provided tracking details could be mishandled if inserted directly into a shell command. Mitigation: Pass request data as structured JSON and apply strict quoting or escaping whenever a shell invocation is unavoidable. Risk: The skill depends on a configured JISU_API_KEY and network access to JisuAPI. Mitigation: Configure the API key in the environment and handle API, quota, HTTP, and JSON parsing errors before presenting results to users. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/jisuapi/skills/express) - [JisuAPI express API documentation](https://www.jisuapi.com/api/express) - [JisuAPI website](https://www.jisuapi.com/) - [JisuAPI express query endpoint](https://api.jisuapi.com/express/query) - [JisuAPI express type endpoint](https://api.jisuapi.com/express/type) ## Skill Output: **Output Type(s):** [json, shell commands, configuration, guidance] **Output Format:** [JSON from a Python CLI, with Markdown setup and usage guidance] **Output Parameters:** [1D] **Other Properties Related to Output:** [Requires python3 and JISU_API_KEY; query input includes a tracking number, optional courier type, and optional phone-number suffix.] ## Skill Version(s): 1.0.7 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/jisuapi/skills/express",
"sourceUrl": "https://clawhub.ai/jisuapi/skills/express",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T19:28:56.406Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-express/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-express/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T19:28:56.406Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.1K downloads",
"href": "https://clawhub.ai/jisuapi/express",
"sourceUrl": "https://clawhub.ai/jisuapi/express",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T19:28:56.406Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.7",
"href": "https://clawhub.ai/jisuapi/express",
"sourceUrl": "https://clawhub.ai/jisuapi/express",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T07:59:37.148Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-express/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jisuapi-express/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.7",
"description": "- Removed documentation file skill-card.md. - No functional or user-facing changes.",
"href": "https://clawhub.ai/jisuapi/express",
"sourceUrl": "https://clawhub.ai/jisuapi/express",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-10T07:59:37.148Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
