用途:管理 Shopee 加购优惠(Add-On Deal),覆盖 Shopee Open Platform Add-On Deal 模块的 14 个 API,包括创建、查询、更新、删除加购优惠,以及主商品与加购商品的增删改查和结束活动。
主要能力:提供 14 个脚本,如 add_add_on_deal.py、add_add_on_deal_main_item.py、add_add_on_deal_sub_item.py、delete_add_on_deal.py、delete_add_on_deal_main_item.py、delete_add_on_deal_sub_item.py、get_add_on_deal_list.py、get_add_on_deal.py、get_add_on_deal_main_item.py、get_add_on_deal_sub_item.py、update_add_on_deal.py、update_add_on_deal_main_item.py、update_add_on_deal_sub_item.py、end_add_on_deal.py,另有通用入口 add_on_deal_api.py。
使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth。调用 API 端点 POST /shopee/developerProxy,传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/add_on_deal/...。脚本用法:python scripts/<脚本名>.py '<JSON 参数>' [--inline]。
输出与限制:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件,禁止写入 /tmp;响应 ≤8 KB 打印完整 JSON,>8 KB 只输出摘要,--inline 可强制全量打印。失败或空结果不得自动换关键词、翻页或连续试探,继续检索需先告知用户会产生额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。本技能不消耗算力。店铺授权、限时折扣、套装优惠、商品 listing 分别由其他技能处理。