核心用法
本技能集成快递100企业版API，提供标准化物流查询服务。主要功能包括：实时快递追踪（支持中通、顺丰、圆通、韵达、京东、EMS等主流及国际快递）、智能时效预测、手机验证码查询（顺丰/中通必需）、寄件下单指导。通过query_express.py脚本执行API查询，或在不信任环境下使用query_express_playwright.py进行网页模拟查询。
显著优点
数据权威性：对接快递100企业级API，非第三方爬取，数据实时性与准确性有保障。覆盖全面：支持100+家快递公司及国际物流（DHL、FedEx、UPS）。场景完善：原生处理手机验证、时效预测、虚拟号码等复杂场景。输出标准化：提供统一的查询结果模板和错误处理指引，降低用户理解成本。双模式安全设计：API模式高效可信，Playwright网页模式可在零密钥环境下运行，兼顾便利与安全。
潜在缺点与局限性
密钥依赖：完整功能需配置企业版API密钥，个人用户获取门槛较高。查询频率限制：同一单号需间隔30分钟，高频场景受限。国际预测不准：跨境物流时效预测精度低于国内。Playwright依赖：无密钥模式需安装Playwright，环境配置成本增加。虚拟号码限制：部分快递公司虚拟号码支持不完善。
适合人群
- 电商运营、客服团队需批量查询物流
- 个人用户高频查快递且重视数据准确性
- 开发者集成物流查询到自动化工作流
- 需在安全可控环境下处理快递信息的隐私敏感用户
常规风险
密钥泄露风险：KUAIDI100_KEY与KUAIDI100_CUSTOMER为敏感凭证，配置于不可信环境可能导致滥用。网络请求暴露：技能需外联快递100服务器，存在请求特征被追踪可能。Playwright浏览器风险：网页模式虽无需密钥，但浏览器自动化行为可能被网站检测并限制。建议优先本地运行，定期轮换密钥，生产环境配合密钥管理服务使用。