SuperAPI AI 工具集

linkfox-shopee-store-top-picks

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:管理 Shopee 店铺的精选商品 Top Picks 集合,覆盖 Shopee Open Platform Top Picks 模块全部 4 个 API。

主要能力:get_top_picks_list(GET,查看现有集合)、add_top_picks(POST,创建集合)、update_top_picks(POST,更新)、delete_top_picks(POST,删除),另有通用入口 top_picks_api.py。

使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth 完成选店。调用统一走 POST /shopee/developerProxy,传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/top_picks/...。脚本用法:python scripts/<脚本名>.py '<JSON 参数>' [--inline]。完整参数、响应与错误码见 references/api.md 及 references/apis/ 下各接口文档。

输出策略:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json,禁止写入 /tmp;响应 ≤8 KB 时落盘后全量打印,>8 KB 时仅输出摘要,加 --inline 可强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 从文件按需抽取字段。

限制:本工具不消耗算力;失败或空结果不得自动换关键词、翻页或连续试探,需继续检索应先向用户说明额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。店铺授权、商品 listing、店铺分类及促销类活动不属于本技能范围。