kuaidihelp-skill

kuaidihelp 快递公司寄件助手

功能

- 查价 （查运费/预估运费） - 查物流信息 （查物流轨迹） - 寄件 （寄快递/创建订单） - 取消订单

环境变量配置

查询物流信息，每天有一定的额度，当额度使用完了，就需要到，快宝开放平台注册账号并获取专属 API Key和 ID，然后将 Key和 ID ,配置环境变量 KUAIDIHELP_API_KEY, KUAIDIHELP_API_ID 即可继续使用。 ~~~shell export KUAIDIHELP_API_KEY= xxxxxxxxxxxxxxxx export KUAIDIHELP_API_ID= xxxxxxxxxxxxxxxx ~~~

品牌映射

申通(sto)，中通(zt)，圆通(yt)，韵达(yd)，ems(ems) ,邮政(postx)，极兔(jt)，京东(jd)，百世(ht)，同城(kbtc)，天天(tt)，丰网(fw)，顺丰(sf)，国通(gt)，众邮(zykd)，德邦(dp)，中通快运(ztky)，安能快运(ane)，壹米滴答(bt)，丹鸟(dn)，顺心捷达(sxjd)，京广速递(kk)，优速快递(ys)，菜鸟速递(cnsd)，笨鸟速运(bn)

工具使用步骤

1. 首先确认用户意图，用户需要查询的功能。 2. 然后收集指定功能接口的请求参数，参数完整时，请求指定接口回复用户问题，参数不完整时，提示用户提供缺失的参数。

一. 报价查询(预估运费)

接口描述: 通过收寄件人的相关信息，及物品信息，预估运费或者相关运费的查询。

接口参数: - sender_province (必填) :寄件人所在省份名称 - sender_city (必填) :寄件人所在城市名称 - sender_district (必填) :寄件人所在地区（区\县\镇） - sender_address (必填):寄件人详细地址 - recipient_province (必填):收件人所在省份名称 - recipient_city (必填):收件人所在城市名称 - recipient_district (必填):收件人所在地区（区\县\镇） - recipient_address (必填):收件人详细地址 - package_volume (选填) :重量（默认1kg） - package_weight (选填) :体积 接口调用 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py quotation '{\"sender\":{\"province\":\"\",\"city\":\"\",\"district\":\"\",\"address\":\"\"},\"recipient\":{\"province\":\"\",\"city\":\"\",\"district\":\"\",\"address\":\"\"},\"pay_type\":\"2\",\"volume\":\"\",\"weight\":\"\"}' ~~~ 示例 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py quotation '{\"sender\":{\"province\":\"广东省\",\"city\":\"佛山市\",\"district\":\"南海区\",\"address\":\"南海大道北翠云苑二座802\"},\"recipient\":{\"province\":\"浙江省\",\"city\":\"嘉兴市\",\"district\":\"秀洲区\",\"address\":\"城东路2000号26幢商铺234号海螺电玩\"},\"pay_type\":\"2\",\"volume\":\"\",\"weight\":\"\"}' OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py quotation '{\"sender\":{\"province\":\"广东省\",\"city\":\"佛山市\",\"district\":\"南海区\",\"address\":\"南海大道北翠云苑二座802\"},\"recipient\":{\"province\":\"浙江省\",\"city\":\"嘉兴市\",\"district\":\"秀洲区\",\"address\":\"城东路2000号26幢商铺234号海螺电玩\"},\"pay_type\":\"2\",\"volume\":\"1\",\"weight\":\"1\"}' ~~~

二. 物流查询

接口描述: 通过运单号查询物流信息，当接口返回需要手机尾号时，提示让用户提供尾号。

接口参数: - waybill_codes_str (必填): 运单号，多个单号之间用","隔开（英文逗号）,最多支持10条 - phone_str (选填) : 特定快递公司需要传手机号码后四位尾号，中通：优先用发件人手机号码后四位，如果查询不到可以使用收件人手机号码后四位，京东和顺丰使用收件人手机号码后四位 接口调用 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"\",\"phone\":\"\",\"result_sort\":\"0\"}' ~~~ 示例 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"YT8852860437699\",\"phone\":\"\",\"result_sort\":\"0\"}' OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"YT8852860437699,JT3009968654034\",\"phone\":\"\",\"result_sort\":\"0\"}' OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"772058582798206\",\"phone\":\"6515\",\"result_sort\":\"0\"}' ~~~

三. 寄快递(创建订单)

接口描述:此接口是收集下单所需的收寄件人信息，接口返回下单的图片二维码，用户需微信扫码进行下单操作。

接口参数: - shipper_province_str (必填): 寄件人所在省份名称 - shipper_city_str (必填) : 寄件人所在城市名称 - shipper_district_str (必填) : 寄件人所在地区（区\县\镇） - shipper_address_str (必填) : 寄件人详细地址 - shipper_name_str (必填): 寄件人名称 - shipper_mobile_str (必填):寄件人手机号码 - shipping_province_str (必填):收件人所在省份名称 - shipping_city_str (必填): 收件人所在城市名称 - shipping_district_str (必填): 收件人所在地区（区\县\镇） - shipping_address_str (必填): 收件人详细地址 - shipping_name_str (必填):收件人名称 - shipping_mobile_str (必填):收件人手机号码 - package_info_str (选填): 物品描述 - package_weight_str (选填): 物品重量 - package_note_str (选填): 物品备注 - package_pics_str (选填):物品图片 - brand_str (必填):快递品牌简称，例如 zt 、sto... - place_volume_str (选填):下单体积（长宽高乘积） - reserve_start_time_str (选填): 预约取件时间（开始） - reserve_end_time_str (选填): 预约取件时间（结束） - arrivePay_str (选填):是否到付（0否 1是） 默认1

接口调用 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py order '{\"sender\":{\"shipper_province\":\"\",\"shipper_city\":\"\",\"shipper_district\":\"\",\"shipper_address\":\"\",\"shipper_name\":\"\",\"shipper_mobile\":\"\"},\"recipient\":{\"shipping_province\":\"\",\"shipping_city\":\"\",\"shipping_district\":\"\",\"shipping_address\":\"\",\"shipping_name\":\"\",\"shipping_mobile\":\"\"},\"package_info\":\"\",\"package_weight\":\"\",\"package_note\":\"\",\"package_pics\":\"\",\"brand\":\"\",\"place_volume\":\"\",\"reserve_start_time\":\"\",\"reserve_end_time\":\"\",\"arrivePay\":\"1\"}' ~~~ 示例 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py order '{\"sender\":{\"shipper_province\":\"广东省\",\"shipper_city\":\"佛山市\",\"shipper_district\":\"南海区\",\"shipper_address\":\"南海大道北翠云苑二座802\"},\"recipient\":{\"shipper_name\":\"李忧危\",\"shipper_mobile\":\"15302374691\",\"shipping_province\":\"浙江省\",\"shipping_city\":\"嘉兴市\",\"shipping_district\":\"秀洲区\",\"shipping_address\":\"城东路2000号26幢商铺234号海螺电玩\",\"shipping_name\":\"程序螺\",\"shipping_mobile\":\"15657366015\"},\"package_info\":\"\",\"package_weight\":\"\",\"package_note\":\"\",\"package_pics\":\"\",\"brand\":\"sto\",\"place_volume\":\"\",\"reserve_start_time\":\"\",\"reserve_end_time\":\"\",\"arrivePay\":\"1\"}' ~~~ 输出要求

- 将接口生成的下单图片二维码地址，展示成可点击的网址。 - 只输出下单的基本信息和点击的二维码网址，其他信息不输出。

四. 取消订单

接口描述: 通过用户提供的 快递品牌，快宝订单号或者第三方订单号 ,取消订单 接口参数: - shipper_type_str(必填): 品牌首字母（例如：zt,sto...） - order_id_str (选填): 快宝单号 - third_order_id_str (选填): 第三方订单号 （取消订单 使用快宝订单号或者 第三方订单号二选一 ） - reason_str (选填): 取消理由

接口调用 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py cancel '{\"shipper_type\": \"\", \"order_id\": \"\", \"third_order_id\":\"\", \"reason\":\"\"}' ~~~ 示例 ~~~bash OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py cancel '{\"shipper_type\": \"zt\", \"order_id\": \"1204076252008035\", \"third_order_id\":\"\", \"reason\":\"\"}' OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py cancel '{\"shipper_type\": \"zt\", \"order_id\": \"\", \"third_order_id\":\"1204076252008033\", \"reason\":\"\"}' ~~~