← Back to Skills Marketplace
freedompixels

中文快递追踪

by freedompixels · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
67
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cn-kuaidi-100
Description
中文快递追踪助手。根据快递单号自动识别快递公司,查询实时物流状态。 支持国内外主流快递,使用快递100免费接口,无需API Key。 当用户说"快递"、"查快递"、"物流"、"单号"、"包裹到哪了"时触发。 Keywords: 快递, 物流, 单号, 追踪, 包裹, delivery, tracking
README (SKILL.md)

📦 快递追踪助手

查快递,更轻松。

核心功能

功能 命令示例
添加追踪 添加快递 SF1234567890
查询单个 查 SF1234567890 / 顺丰SF1234567890到哪了
查看列表 查快递 / 我的快递
删除快递 删除快递 SF1234567890
清除所有 清除快递

使用方式

# 添加快递到追踪列表
python3 scripts/express_tracker.py "添加快递 SF1234567890"

# 查询单个快递(自动识别公司)
python3 scripts/express_tracker.py "查 SF1234567890"

# 指定公司查询
python3 scripts/express_tracker.py "查 1234567890123 公司:顺丰"

# 查看所有追踪快递
python3 scripts/express_tracker.py "查快递"

# 删除追踪
python3 scripts/express_tracker.py "删除 SF1234567890"

支持的快递公司

顺丰速运、中通、圆通、韵达、申通、极兔、京东、EMS、中国邮政、德邦

技术说明

  • 数据接口:快递100开放查询接口
  • 认证方式:无需API Key,直接查询
  • SSL策略:优先标准验证,失败时自动降级(兼容老旧环境)
  • 数据存储:本地JSON文件,隐私安全

数据存储位置

~/.qclaw/skills/cn-express-tracker/data/express.json

注意事项

  • 部分快递公司需要真实在途物流才可查询
  • 首次查询会自动添加到追踪列表
  • 自动识别主流快递公司单号格式
  • 单号格式:SF/ET/YT/YD/ST前缀,或10-22位纯数字
Usage Guidance
This skill appears to do what it says: it extracts tracking numbers, queries kuaidi100, and stores results locally. Before installing, note: (1) it makes outbound HTTPS requests to https://www.kuaidi100.com — ensure you trust that service and that your environment allows network access; (2) it writes a JSON file under ~/.qclaw/skills/cn-express-tracker/data/express.json (review or back up if you care about local state); (3) the script requires the Python requests library but the skill does not declare an installer — install requests in your environment to avoid runtime errors; (4) the SKILL.md mentions an SSL fallback, but the code does not disable verification on retry (this is a benign implementation inconsistency). If you are comfortable with those points, the skill is coherent and does not request extra privileges or secrets.
Capability Analysis
Type: OpenClaw Skill Name: cn-kuaidi-100 Version: 1.0.0 The skill bundle is a legitimate tool for tracking Chinese express deliveries using the Kuaidi100 API. The code in scripts/express_tracker.py implements basic CRUD operations for tracking numbers stored in a local JSON file and performs standard HTTP GET requests to fetch logistics data without any evidence of data exfiltration, malicious execution, or prompt injection.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description match the included Python script and SKILL.md: the code extracts tracking numbers, detects carriers, queries kuaidi100, and stores tracking entries locally. No unrelated credentials, binaries, or services are requested.
Instruction Scope
Instructions and code stay within the declared purpose: they read/write a local JSON at ~/.qclaw/skills/cn-express-tracker/data/express.json and call the kuaidi100 query endpoint. Minor mismatch: SKILL.md describes an SSL 'downgrade' fallback for old environments, but the code's fallback still uses verify=True (so the described behavior is inaccurate). There are no instructions to read other user files or transmit unrelated data.
Install Mechanism
This is an instruction-only skill with an included Python script (no install spec). The script uses the third-party requests library but the skill does not declare or install that dependency; runtime failure is possible if requests is absent. No risky downloads or external install URLs are present.
Credentials
The skill requests no environment variables, credentials, or config paths beyond writing to its own data directory in the user's home. That storage location is proportional to its function.
Persistence & Privilege
always:false and user-invocable:true. The skill persists only its own tracking JSON under ~/.qclaw/skills/cn-express-tracker/data; it does not modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cn-kuaidi-100
  3. After installation, invoke the skill by name or use /cn-kuaidi-100
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Express tracking with SSL verification fix
Metadata
Slug cn-kuaidi-100
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 中文快递追踪?

中文快递追踪助手。根据快递单号自动识别快递公司,查询实时物流状态。 支持国内外主流快递,使用快递100免费接口,无需API Key。 当用户说"快递"、"查快递"、"物流"、"单号"、"包裹到哪了"时触发。 Keywords: 快递, 物流, 单号, 追踪, 包裹, delivery, tracking. It is an AI Agent Skill for Claude Code / OpenClaw, with 67 downloads so far.

How do I install 中文快递追踪?

Run "/install cn-kuaidi-100" 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 freedompixels (@freedompixels); the current version is v1.0.0.

💬 Comments