用途:管理 Shopee(虾皮)关注有礼 Follow Prize 活动,覆盖 Shopee Open Platform Follow Prize 模块的 6 个 API。依赖 linkfox-shopee-store-auth 完成选店,经 POST /shopee/developerProxy 传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/follow_prize/...。
主要能力:add_follow_prize(POST)、delete_follow_prize(POST)、end_follow_prize(POST)、update_follow_prize(POST)、get_follow_prize_detail(GET)、get_follow_prize_list(GET),另有通用入口 follow_prize_api.py。
使用方式:API 端点 POST /shopee/developerProxy,不同操作通过请求体区分;Python 脚本用法为 python scripts/follow_prize_api.py '<JSON 参数>' [--inline]。运行前先执行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth。脚本默认将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<linkfox-shopee-store-follow-prize>-<timestamp>.json,禁止写入 /tmp;响应体 ≤ 8 KB 时打印完整 JSON,> 8 KB 时仅输出摘要,--inline 可强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 从保存文件按需抽取字段。
适用场景:创建关注有礼活动、查看活动列表、更新或结束活动等。
限制:本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探,需继续检索时应先向用户说明额外消耗;未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。店铺授权、Discount、Voucher、Shop Flash Sale、商品 listing 等应使用对应其他技能。入参与响应细节见 references/apis/ 下各文档,模块总览见 references/api.md。