用途:面向 Shopee(虾皮)店铺秒杀(Shop Flash Sale)场景,封装 Shopee Open Platform Shop Flash Sale 模块的 11 个 API,用于创建、查询、更新、删除店铺秒杀活动及其商品。
主要能力:覆盖 get_time_slot_id、create_shop_flash_sale、get_item_criteria、add_shop_flash_sale_items、get_shop_flash_sale_list、get_shop_flash_sale、get_shop_flash_sale_items、update_shop_flash_sale、update_shop_flash_sale_items、delete_shop_flash_sale、delete_shop_flash_sale_items,并提供通用入口 shop_flash_sale_api.py。
使用方式:依赖 linkfox-shopee-store-auth 选店,先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装该认证技能。调用端点 POST /shopee/developerProxy,传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/shop_flash_sale/...。脚本用法: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 等由对应技能处理。接口入参与响应细节见 references/apis/ 下文档。