用途:管理 Shopee 店铺优惠券(Voucher),覆盖 Shopee Open Platform Voucher 模块 6 个 API,包括 add_voucher、delete_voucher、end_voucher、update_voucher、get_voucher、get_voucher_list。依赖 linkfox-shopee-store-auth 进行选店,调用时经 POST /shopee/developerProxy 传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/voucher/...。
主要能力:创建优惠券(add_voucher.py 传完整 body)、查看活动列表(get_voucher_list.py)、更新或结束活动(update_voucher.py / end_voucher.py)、删除(delete_voucher.py);另有通用入口 voucher_api.py。入参与响应细节见 references/apis/ 下各 API 文档,模块总览见 references/api.md。
使用方式:POST /shopee/developerProxy,不同操作以 path/method 区分;脚本调用格式为 python scripts/<脚本名>.py '<JSON 参数>' [--inline]。运行前执行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth。脚本默认将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下 JSON 文件,不写 /tmp;响应体 ≤ 8 KB 落盘后全量打印,> 8 KB 只输出摘要,--inline 可强制全量打印。建议先用摘要判断,再用 jq 或 ConvertFrom-Json 按需抽取字段。
适用场景:Shopee 店铺优惠券的创建与全生命周期管理,如新建活动、查看列表、更新或结束、删除。
限制:失败或空结果不得自动换关键词、翻页或连续试探,继续检索需先向用户说明额外消耗;官方称不消耗算力,未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402 或提示余额不足时,按 references/onboarding.md 处理。店铺授权、Discount、Bundle Deal、Add-On Deal、商品 listing 等不属于本工具,需使用对应技能。具体接口参数、响应与错误码以资料引用文档为准,未提供的细节暂未提供。