kuaidihelp-skill

Assist with express delivery services including shipping cost estimation, logistics tracking, order creation with QR code, and order cancellation.

kuaidihelp 快递公司寄件助手

功能

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

环境变量配置

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

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 (选填) :体积

接口调用

OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py quotation '{\"sender\":{\"province\":\"<sender_province>\",\"city\":\"<sender_city>\",\"district\":\"<sender_district>\",\"address\":\"<sender_address>\"},\"recipient\":{\"province\":\"<recipient_province>\",\"city\":\"<recipient_city>\",\"district\":\"<recipient_district>\",\"address\":\"<recipient_address>\"},\"pay_type\":\"2\",\"volume\":\"<package_volume>\",\"weight\":\"<package_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\":\"\",\"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 (选填) : 特定快递公司需要传手机号码后四位尾号，中通：优先用发件人手机号码后四位，如果查询不到可以使用收件人手机号码后四位，京东和顺丰使用收件人手机号码后四位

接口调用

OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"<waybill_codes_str>\",\"phone\":\"<phone_str>\",\"result_sort\":\"0\"}'

示例

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

接口调用

OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py order '{\"sender\":{\"shipper_province\":\"<shipper_province_str>\",\"shipper_city\":\"<shipper_city_str>\",\"shipper_district\":\"<shipper_district_str>\",\"shipper_address\":\"<shipper_address_str>\",\"shipper_name\":\"<shipper_name_str>\",\"shipper_mobile\":\"<shipper_mobile_str>\"},\"recipient\":{\"shipping_province\":\"<shipping_province_str>\",\"shipping_city\":\"<shipping_city_str>\",\"shipping_district\":\"<shipping_district_str>\",\"shipping_address\":\"<shipping_address_str>\",\"shipping_name\":\"<shipping_name_str>\",\"shipping_mobile\":\"<shipping_mobile_str>\"},\"package_info\":\"<package_info_str>\",\"package_weight\":\"<package_weight_str>\",\"package_note\":\"<package_note_str>\",\"package_pics\":\"<package_pics_str>\",\"brand\":\"<brand_str>\",\"place_volume\":\"<place_volume_str>\",\"reserve_start_time\":\"<reserve_start_time_str>\",\"reserve_end_time\":\"<reserve_end_time_str>\",\"arrivePay\":\"1\"}'

示例

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 (选填): 取消理由

接口调用

OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py cancel '{\"shipper_type\": \"<shipper_type_str>\", \"order_id\": \"<order_id_str>\", \"third_order_id\":\"<third_order_id_str>\", \"reason\":\"<reason_str>\"}'

示例

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\":\"\"}'