← Back to Skills Marketplace
zhili007

多平台快递查询

by zhili007 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
139
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install express-query
Description
根据快递单号识别承运商，查询并解析物流轨迹，判断异常状态，提供准确的物流状况和处理建议。
README (SKILL.md)

快递物流查询 Skill

目标

根据用户提供的快递单号，查询物流轨迹，识别承运商，判断物流状态，识别异常，并给出建议。

使用场景

用户说帮我查一下快递 用户说快递到哪了 用户说物流怎么还没更新

执行流程

第一步：识别承运商

运行 scripts/identify.py 识别快递公司 或使用正则匹配，详见 references/carriers.md

第二步：查询物流

推荐路径按优先级：

第一选择是快递100聚合查询，打开浏览器访问 https://www.kuaidi100.com 输入单号查询

第二选择是官网查询，直接访问对应快递公司官网

第三选择是浏览器自动化，如果以上都失败，用 browser 工具打开查询页面

第三步：解析轨迹

从查询结果网页中提取以下信息：

第一步是找到物流轨迹区域，通常在页面中间位置

第二步是提取时间，格式为 YYYY.MM.DD HH:MM

第三步是提取地点和状态，描述中包含地点和状态信息

第四步是按时间倒序排列，最新的在前

第四步：异常判断

根据以下规则判断异常情况：

停滞规则是最新一条轨迹距离今天超过3天

滞留规则是轨迹中出现同一站点重复超过2次

派送异常规则是状态包含派送中且超过2天

签收未收到规则是状态显示已签收但用户说没收到

退件规则是状态包含退件、退回、拒收

第五步：生成回复

按以下结构输出：

第一行是快递公司和单号，用中文冒号分隔

第二行是状态，运输中或派送中或已签收

第三行是最新轨迹，时间地点状态用空格分隔

第四部分是物流时间线，用数字编号，每条一行

第五部分是异常判断，有问题时写具体问题，没问题时写正常

第六部分是建议动作，根据状态给出相应建议

回答原则

只信官方来源，优先使用快递100或官网数据

不编造轨迹，查不到就是查不到，不要编造

诚实告知，查不到、异常、无法判断都要诚实说

给出建议，异常时给用户具体的处理建议

技术实现

识别算法

详见 references/carriers.md

核心逻辑是步骤一前缀匹配、步骤二长度特征匹配、步骤三兜底判断

查询工具

browser 用于打开快递100或官网查询页面，是主要工具

web_fetch 用于抓取查询结果页面，是备用工具

脚本

scripts/identify.py 是单号识别脚本，测试命令 python3 identify.py SF1234567890

scripts/query.py 是查询主脚本，测试命令 python3 query.py 单号

测试样例

测试单号一：SF1234567890，预期识别为顺丰速运

测试单号二：JT12345678901，预期识别为极兔速递

测试单号三：JD0012345678901，预期识别为京东物流

测试单号四：781234567890，预期识别为中通快递

异常判断详细规则

规则一：停滞

判断方法是最新轨迹时间距离今天超过3天

处理方式是建议联系发件人核实或联系快递公司客服

规则二：滞留

判断方法是同一站点出现3次以上

处理方式是建议直接联系快递公司客服催办

规则三：派送中超时

判断方法是状态为派送中且超过48小时

处理方式是建议联系快递员或客服询问情况

规则四：已签收未收到

判断方法是状态显示已签收但用户说没收到

处理方式是建议先确认家人同事是否代收，然后联系快递员或客服投诉

规则五：退件

判断方法是状态包含退件、退回、拒收

处理方式是建议联系发件人确认原因

输出模板

标准输出格式如下：

快递公司：XXX 单号：XXX 状态：运输中/派送中/已签收/异常

最新轨迹： 2025.11.20 14:39 地点 - 状态描述

物流时间线：

  1. 2025.11.20 14:39 地点 - 状态描述
  2. 2025.11.20 12:26 地点 - 状态描述
  3. 2025.11.19 10:00 地点 - 状态描述

异常判断：正常 / 停滞3天 / 派送超时 / 签收未收到

建议动作：暂无 / 请联系客服催办 / 请确认是否代收 / 请联系发件人核实

版本：v0.3 最后更新：2026-03-20

Usage Guidance
This skill appears to do what it says: identify carriers, build query plans, parse timelines, and apply anomaly rules. Before installing: (1) Note it uses browser/web_fetch to open aggregator or official pages — if you allow an agent to use a browser tool it will visit web pages; do not allow the agent to enter your full login credentials. (2) The skill may ask you to provide verification details (e.g., phone last 4 digits) to access some official queries — only share minimal, non-sensitive info you are comfortable disclosing. (3) There are no hidden network endpoints or required environment secrets in the package, but if you connect this skill to tools that can submit forms or sign in, review those tool permissions. If you want extra assurance, run the Python scripts locally to inspect behavior before granting the agent browser/web_fetch capabilities.
Capability Analysis
Type: OpenClaw Skill Name: express-query Version: 1.0.0 The skill bundle is a legitimate utility for identifying express delivery carriers and providing logistics query strategies. The Python scripts (scripts/identify.py and scripts/query.py) use standard regex and prefix matching to categorize tracking numbers and generate URLs for official courier websites or reputable aggregators like kuaidi100.com. No evidence of data exfiltration, malicious execution, or prompt injection was found; the instructions in SKILL.md are strictly aligned with the stated purpose of tracking packages and identifying delivery anomalies.
Capability Assessment
✓ Purpose & Capability
Name/description match the included scripts, rules, and data (identify.py, query.py, carriers references, official_sources). The code only builds identification and query plans/URLs; nothing requires unrelated credentials or system access.
ℹ Instruction Scope
Runtime instructions stay within tracking: identify courier, open aggregator/official pages with browser/web_fetch, parse timeline, and apply anomaly rules. Note: the SKILL asks the agent to use browser/web_fetch and to prompt the user if verification is required (e.g., 'need phone last 4 digits', 'need login', 'captcha'), which is expected for some official queries but is a privacy-sensitive action — the skill itself does not instruct reading local files or env vars.
✓ Install Mechanism
No install spec; instruction-only plus included Python scripts. No downloads, package installs, or archive extraction are present.
ℹ Credentials
The skill declares no required env vars or credentials (appropriate). It may ask the user for verification details (phone tail digits or login) as part of using official channels — this is plausible but privacy-sensitive; the skill does not request unrelated secrets or system credentials.
✓ Persistence & Privilege
always is false and there is no installation step altering agent/system config or requesting permanent presence. The default autonomous invocation setting is unchanged (normal).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install express-query
  3. After installation, invoke the skill by name or use /express-query
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the 快递物流查询 Skill: - Implements carrier identification based on tracking number. - Guides step-by-step logistics status querying, including parsing and timeline extraction. - Defines abnormal status rules (停滞、滞留、派送异常、签收未收到、退件) and corresponding user advice. - Provides official-source-only response principles and structured reply templates. - Includes algorithm descriptions, tool recommendations (browser, web_fetch), and script usage instructions. - Adds sample tracking numbers and expected carrier recognition for easy testing.
Metadata
Slug express-query
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 多平台快递查询?

根据快递单号识别承运商，查询并解析物流轨迹，判断异常状态，提供准确的物流状况和处理建议。 It is an AI Agent Skill for Claude Code / OpenClaw, with 139 downloads so far.

How do I install 多平台快递查询?

Run "/install express-query" 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 zhili007 (@zhili007); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments