kuaidi100-skill-快递100物流查询

📦 一站式物流查询与智能预测

专业快递物流查询工具,支持轨迹追踪、快递公司识别、运费估算及送达时间预测,数据源自快递100官方API。

收藏
3.1k
安装
1.2k
版本
1.1.2
CLS 安全性认证2026-08-03
点击查看完整报告 >

使用说明

核心用法

快递100技能提供完整的物流信息查询能力,包含五大核心功能:

1. 物流轨迹查询(query_trace):输入快递单号即可获取实时物流状态,支持顺丰、中通等主流快递;顺丰/中通需额外提供手机号尾号验证。

2. 智能识别快递(auto_number):通过单号自动判断所属快递公司,适用于未知单号来源的场景。

3. 运费估算(estimate_price):寄件前比价神器,支持顺丰、京东、德邦等12家主流快递,按重量和地址智能计算费用。

4. 寄件时效预测(estimate_time):下单前预估送达时间,覆盖国内20+快递品牌,支持自定义下单时间和业务类型。

5. 在途剩余时间预测(estimate_time_with_logistic):结合实时物流轨迹,精准预测已发出包裹的剩余送达时间。

显著优点

  • 官方数据源:直连快递100 API,覆盖国内99%快递公司,数据权威实时
  • 功能闭环完整:从寄件前比价、时效预估,到在途追踪、剩余时间预测,覆盖快递全生命周期
  • 智能化程度高:自动识别快递公司、基于真实轨迹动态预测,减少用户输入成本
  • 双模式Key管理:支持配置文件+环境变量灵活配置,免费额度满足轻度使用

潜在局限

  • 免费额度限制:未配置API Key时存在日调用上限,耗尽后需手动注册获取Key
  • 部分字段必填:顺丰/中通查询必须提供手机号,增加一定使用门槛
  • 预测准确性依赖数据:时效预测基于历史数据模型,极端天气、突发路况等不可抗力因素可能导致偏差
  • 地址解析精度:运费和时效估算依赖地址关键词匹配,模糊地址可能影响结果

适合人群

  • 电商卖家/个人卖家:批量查件、成本核算
  • 网购用户:主动追踪包裹、规划收件时间
  • 代购/转运从业者:多平台订单统一管理
  • 对物流时效敏感的企业采购人员

常规风险

  • 物流数据存在分钟级延迟,非绝对实时
  • 隐私敏感:查询顺丰/中通需提交手机号,存在信息泄露风险(建议仅提交尾号)
  • 免费额度耗尽导致服务中断,关键场景建议提前配置付费Key
  • 单号输入错误可能返回他人包裹信息(虽概率极低),需核对单号准确性

安全解读

核心用法

快递100技能通过Node.js脚本调用官方API,提供五大核心功能:

1. 物流轨迹查询(query_trace):输入快递单号即可获取完整物流路径,支持顺丰、中通等需手机号的特殊校验
2. 智能识别快递公司(auto_number):自动解析单号归属,解决"这是什么快递"的困惑

3. 运费估算(estimate_price):覆盖8家主流快递,输入收发地址和重量即可比价

4. 寄件时效预测(estimate_time):下单前预估送达时间,支持18家快递公司的时效查询

5. 在途剩余时间预测(estimate_time_with_logistic):结合已有轨迹数据,智能计算包裹还需多久到达

配置方式灵活,支持config.json文件或环境变量KUAIDI100_API_KEY,未配置时自动使用免费额度。所有接口返回Markdown格式,直接呈现给用户。

显著优点

  • 零依赖安全架构:仅使用Node.js内置模块(https/fs/path/querystring),彻底规避npm供应链攻击风险
  • 企业级数据安全:全链路HTTPS加密,符合GDPR数据最小化原则,无硬编码密钥
  • 场景覆盖完整:从"查快递到哪了"到"寄这个多少钱"再到"还要等多久",覆盖快递全生命周期
  • 权威数据背书:直接对接快递100官方平台,数据源覆盖1400+物流公司,信息实时准确
  • 开发友好设计:清晰的优先级配置规则、自动化的额度耗尽提示、标准化的Markdown输出

潜在局限

  • 免费额度限制:未配置API Key时存在每日调用上限,高并发场景需付费升级
  • 手机号敏感字段:顺丰、中通等查询需手机号,存在隐私合规告知义务
  • 时效预测偏差:estimate_time_with_logistic依赖历史轨迹推算,极端天气、异常分拣等突发情况可能导致预测失准
  • 地址解析依赖:运费和时效估算需结构化地址输入,模糊地址(如"老张家")无法识别
  • Node.js环境绑定:非Node.js运行时无法直接使用,需额外封装

适合人群

  • 电商运营人员:批量查询订单物流、快速响应客户"到哪了"咨询
  • 个人海淘/网购用户:聚合管理多平台订单,自动识别快递公司
  • 小型快递代收点:辅助客户查询、提供运费比价咨询
  • 产品经理/开发者:快速搭建物流查询MVP,验证业务场景

常规风险提示

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 网络超时 | 未设置请求超时,弱网环境可能挂起 | 建议封装时添加30秒超时 |
| API Key泄露 | 配置文件权限管理不当 | 使用环境变量替代文件存储 |
| 额度耗尽 | 免费额度用尽导致服务中断 | 监控调用量,提前配置付费Key |
| 隐私合规 | 手机号等敏感信息处理 | 明确告知用户数据用途,做好日志脱敏 |

kuaidi100-skill-快递100物流查询 内容

script文件夹
手动下载zip · 6.0 kB
kuaidi100.jstext/javascript
请选择文件