📦 China Express — China工具

v3.0.0

中国快递查询与物流信息解析。Use when the user wants to directly get a Chinese package status. Force browser automation on https://www.kuaidi100.com/ and read the live resu...

0· 171·0 当前·0 累计
by @tobewin (ToBeWin)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/3/20
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
The skill's requests and instructions are consistent with its stated purpose: it is an instruction-only tracker that mandates browser automation against kuaidi100.com and does not request unrelated credentials or installs.
评估建议
This skill appears coherent and limited to automating https://www.kuaidi100.com/ to read live tracking results. Before installing: ensure your OpenClaw runtime supports browser automation (the skill will fail otherwise); do not supply full phone numbers or other sensitive personal data unless you are comfortable doing so (the site may request the last 4 digits or OTP to show results); expect the skill to report when a CAPTCHA or verification blocks automated querying rather than to bypass it; an...
详细分析 ▾
用途与能力
Name and description match the runtime instructions. The skill exclusively targets real-time scraping of https://www.kuaidi100.com/ via browser automation; it does not request unrelated binaries, credentials, or config paths. Requiring browser automation is proportionate to the stated goal of reading live web results.
指令范围
SKILL.md gives detailed, narrowly scoped instructions: extract candidate tracking numbers from user input, open the kuaidi100 page, enter the number, confirm the displayed number matches, extract company, latest status and 1–3 recent events, and refuse to fabricate results if blocked. It does not instruct reading arbitrary local files, exfiltration to other endpoints, or use of unrelated sites. It does note possible phone-last-4/verification challenges and instructs to ask the user or report inability when needed.
安装机制
Instruction-only skill with no install spec and no code files. Nothing is downloaded or written to disk by the skill itself, minimizing installation risk.
凭证需求
No environment variables, secrets, or extra credentials are requested. The only implicit requirement is an execution environment that supports browser automation (e.g., a headful or headless browser), which aligns with the stated behavior. The skill may request user-supplied verification material (e.g., phone-last-4) when the site requires it — this is proportional but users should be cautious about sharing full phone numbers or sensitive data.
持久化与权限
always is false and the skill has no install-time persistence. disable-model-invocation is default (false), meaning the agent can invoke the skill autonomously; this is the platform default and not, by itself, a red flag here because the skill has no extra privileges or credential access.
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv3.0.02026/3/20

**重大变更:统一强制使用快递100网页作为唯一数据源,取消所有其他查询链路和降级方案。** - 现只通过浏览器自动化访问 https://www.kuaidi100.com/ 查询快递信息,读取页面实时结果。 - 移除了对各家快递公司官网、历史查询、短信文本、第三方聚合等所有备选查询和降级路径。 - 如遇人机验证、验证码或浏览器自动化不可用,将直接提示无法查询,不再尝试其他方法。 - 明确约束“不得伪造结果”,输出仅以快递100页面实时数据为准。 - 全流程、输出格式和异常处理均以快递100为唯一标准,提升结论一致性与准确性。 - 文档简化、对旧有的多种兼容/容错逻辑进行删除和收敛。

无害

安装命令

点击复制
官方npx clawhub@latest install china-express
镜像加速npx clawhub@latest install china-express --registry https://cn.longxiaskill.com

技能文档

强制通过浏览器自动化访问 https://www.kuaidi100.com/ 页面查询快递,并直接读取页面上的实时结果。

本 skill 的首要目标是“直接给结果,同时保证准确率”。查询链路固定为 https://www.kuaidi100.com/ 官方页面,不考虑其他接口、其他官网或其他降级方案。

兼容性目标:

  • 兼容用户直接给单号、给物流短信、给截图转写文本、给“帮我查下这个快递”这种自然语言
  • 兼容 openclaw 运行在支持浏览器自动化的桌面环境
  • 兼容官网查询页要求手机号后四位、验证码、滑块、人机验证等场景
  • 兼容 openclaw 以自然语言执行 skill 时可能出现的推断偏差,尽量用明确约束减少自由发挥

触发时机

以下情况使用本 skill:

  • 用户提供快递单号,询问物流状态
  • 用户粘贴快递短信/通知文本,要求解读
  • 用户需要判断快递单号属于哪家公司
  • 用户同时管理多个包裹,需要汇总状态
  • 用户只提供收件信息片段、运单号片段或“SF/中通/京东到了没”这类口语化问题

总原则

  • 强制使用浏览器自动化访问 https://www.kuaidi100.com/
  • 只以 https://www.kuaidi100.com/ 页面实时展示结果为准
  • 宁可返回“不确定/暂无信息”,也不要输出高置信度的错误物流结论
  • 不使用第三方免费聚合接口、快递公司官网或历史查询结果作为替代来源
  • 如果页面需要人工验证,必须如实告知,不要切换到其他来源

第零步:输入规范化

在识别和查询前,先做输入规范化,提高通用性和兼容性。

规范化要求:

  • 去掉首尾空格、换行、制表符
  • 保留数字和字母原文,不要擅自改写字符
  • 英文字母统一视为不区分大小写,但请求时尽量保留用户原始单号
  • 若文本中出现多个疑似单号,逐个提取并分别查询
  • 若文本中同时出现手机号、订单号、取件码、运单号,只把最像快递单号的内容作为候选

提取规则:

  • 优先提取包含明显前缀的串,例如 SFJDJTYTYDZTDSLP
  • 其次提取长度合理的字母数字混合串
  • 对纯数字串保持谨慎,不要因为看起来像单号就直接判定公司
  • 用户给的是整段短信时,先提取候选单号,再打开 https://www.kuaidi100.com/ 查询,不要只根据短信语义直接编造物流状态

第一步:识别快递公司

默认策略:提取出单号后,直接在 https://www.kuaidi100.com/ 查询。公司识别只用于辅助理解结果,不作为切换查询站点的依据。

只有在以下“强特征前缀”出现时,才允许直接确定 company_code

快递公司company_code强特征
顺丰速运shunfengSF 开头且后续主要为数字
京东物流jdJD / VA / VB 开头
极兔速递jtexpressJT 开头
EMS中国邮政emsEA / EB / EC 开头,或符合 E+字母+数字+CN
菜鸟/淘宝cainiaoLP 开头
中通快递zhongtongZT 开头
圆通速递yuantongYT 开头
申通快递shentongDS 开头
韵达快递yundaYD 开头
百世快递huitongkuaidiB 开头且后续主要为数字
天天快递tiantianTT 开头
以下情况一律禁止直接猜公司,应优先要求用户补充公司信息,或列出多个官方查询入口供用户自行打开:
  • 纯数字单号
  • 仅凭长度才能判断的单号
  • 多家公司可能复用的前缀或格式
  • 用户只提供了物流短信片段,没有明确单号前缀

准确率规则:

  • 不要把“12位纯数字”“13位纯数字”“10位纯数字”直接映射到任何公司
  • 若用户明确指定公司名称,只把它当作辅助信息,不要改用其他站点查询
  • 若无法可靠识别公司,也仍然先在 https://www.kuaidi100.com/ 页面查询

第二步:浏览器自动化查询

强制查询步骤:

  • 打开 https://www.kuaidi100.com/
  • 将用户单号输入查询框
  • 触发查询
  • 等待页面稳定并出现该单号对应的查询结果
  • 读取页面上的快递公司、当前状态、最新时间、最近 1 到 3 条轨迹

查询要求:

  • 每次都必须重新打开或刷新 https://www.kuaidi100.com/,确保是本次实时查询
  • 必须确认页面展示的单号与用户输入完全一致
  • 必须确认页面结果已经更新,不是上一次搜索残留
  • 若页面有弹窗、广告、悬浮层,应先关闭再读取结果
  • 若需要展开时间线或滚动查看最新轨迹,应先完成这些交互

第三步:结果校验

把以下情况视为“结果不可信”,不得直接输出确定性物流结论:

  • 页面上没有出现用户输入的单号
  • 页面内容与用户输入的单号或快递公司明显不匹配
  • 页面只有营销内容、空白、系统繁忙、加载失败或无轨迹节点
  • 页面仍停留在旧查询结果,未完成本次检索
  • 页面出现验证码、滑块、手机号后四位、登录要求或其他人工验证
  • 当前环境不支持浏览器自动化,无法实际完成查询

输出前校验:

  • 只有在页面明确展示本次查询的物流状态时,才输出状态摘要
  • 如果页面需要手机号后四位或验证码,必须明确说“当前查询需要人工验证”
  • 如果浏览器自动化不可用,必须明确说“当前环境无法完成该查询”

第四步:格式化输出

📦 快递状态摘要
━━━━━━━━━━━━━━━
快递公司:顺丰速运
单  号:SF3149415146
当前状态:✅ 已签收

最新动态: 2026-03-20 14:30 快件已签收,签收人:本人 2026-03-20 10:15 派件中,快递员:张师傅,电话:138*1234 2026-03-19 22:40 到达【上海浦东网点】

运输时长:约 1 天

状态 Emoji:✅已签收 / 🚚派件中 / 📍运输中 / 📦已揽件 / ⏳暂无信息 / ⚠️异常

状态判定兼容规则:

  • 已签收妥投已代收已取件 归为 ✅ 已签收
  • 已投递驿站取件丰巢暂存代收点取件 默认归为 📦 待取件,除非页面明确写明“已签收/已取件完成”
  • 派件中正在派送派送中 归为 🚚 派件中
  • 运输中转运中到达分拨中心离开网点 归为 📍 运输中
  • 已揽收已收件快件已从寄件地发出 归为 📦 已揽件
  • 无记录或 201 归为 ⏳ 暂无信息
  • 退回、拒收、异常件、派件失败等归为 ⚠️ 异常

输出风格要求:

  • 先给结论,再给最近 1 到 3 条关键动态
  • 不要把所有原始轨迹全文照抄给用户
  • 用户只问“到哪了”时,优先回答当前位置和当前状态
  • 用户只问“哪家快递”时,优先回答识别结果和置信依据,不必展开全部物流轨迹
  • 如果查询被验证码或环境限制阻塞,只输出阻塞原因,不要伪造状态摘要

第五步:异常识别

主动检测并提醒以下情况:

  • 超时未更新:最后一条记录超过 48 小时无新动态
  • 退件:context 含"退回"、"退件"、"拒收"
  • 地址问题:含"地址不详"、"无法联系"、"无此人"
  • 派件失败:含"派件失败"、"不在家"、"改约"
  • 疑似页面读取错误*:页面内容与用户单号或当前检索结果明显矛盾

第六步:多包裹汇总

用户提供多个单号时,逐一查询后汇总:

📦 包裹汇总(3个)
━━━━━━━━━━━━━━━━━━━━
  • SF3149415146(顺丰) ✅ 已签收 - 2026-03-20
  • JD123456789(京东) 🚚 派件中 - 预计今日送达
  • 75100167681234(中通)📍 运输中 - 上海转运中心
━━━━━━━━━━━━━━━━━━━━ 需要关注:无异常

执行流程

用户输入单号或物流文本
  ↓
[提取] 从文本中提取单号
  ↓
[规范化] 清洗空格、换行、噪声字符,识别多个候选
  ↓
[打开] 浏览器自动访问 https://www.kuaidi100.com/
  ↓
[查询] 输入单号并触发检索
  ↓
[校验] 确认页面结果属于当前单号
  ↓ 查询成功
[解析] 提取最新状态、最新时间和关键轨迹
  ↓ 查询失败或被验证拦截
[输出] 明确说明当前无法完成查询
  ↓
[输出] 格式化中文摘要

执行约束

这是给 openclaw 使用的 skill,执行时必须遵守以下约束:

  • 强制使用浏览器自动化访问 https://www.kuaidi100.com/
  • 不要用经验、旧结果或其他网站替代当前页面结果
  • 不要把“猜测到的公司”表述成确定事实
  • 不要在没有成功读取 https://www.kuaidi100.com/ 当前页面结果的情况下生成“派件中”“运输中”“已签收”等结论
  • 如果已有信息不足以支持结论,应明确说“不确定”或“暂无信息”
  • 如果用户手动指定了快递公司,只作为辅助理解,不切换查询站点
  • 如果用户给的是模糊描述,先提取单号再查,不要跳过查询步骤直接解释
  • 如果输入里有多个单号或多个包裹,不要只查第一个,除非用户明确指定只查其中一个
  • 如果页面字段缺失,只输出能被页面支持的部分,不要补写未出现的信息
  • 不要把“打开了页面”说成“已经查询成功”
  • 如果浏览器自动化失败、无浏览器环境、页面被验证拦截或当前环境无法自动查官网,不要强行给出物流结果
  • 不要把旧会话里的查询结果当作当前单号的最新结果
  • 不要把其他官网、其他接口或第三方聚合结果当作当前结果

注意事项

  • 页面可能会要求手机号后四位、验证码、登录或滑块验证
  • 当前 skill 不考虑其他查询路径,若浏览器自动化不可用则查询失败
  • 新单号发货后通常需要 2-4 小时才有首条物流信息
  • 物流短信文本只能作为提取单号的辅助信息,不应覆盖页面查询结果
  • 如果 https://www.kuaidi100.com/ 页面已有明确结果,以页面结果为准
数据来源ClawHub ↗ · 中文优化:龙虾技能库