SuperAPI AI 工具集

linkfox-shopee-store-sbs

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:该技能封装 Shopee Open Platform SBS 仓储模块的 5 个 GET 接口,用于查询 SBS 仓储相关数据。依赖 linkfox-shopee-store-auth 完成选店,经 POST /shopee/developerProxy 传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/sbs/...。

主要能力(5 个 API):get_bound_whs_info 查绑定仓库;get_current_inventory 查当前库存;get_expiry_report 查效期报表;get_stock_aging 查库龄;get_stock_movement 查库存变动记录。另有 sbs_api.py 作为通用入口。

使用方式:API 端点为 POST /shopee/developerProxy,不同操作通过请求体区分,完整参数、响应与错误码见 references/api.md。也可运行 Python 脚本: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/<skill-name>-<timestamp>.json,禁止写入 /tmp,当前目录不可写则报错;响应体 ≤ 8 KB 时落盘后打印完整 JSON,> 8 KB 时只输出摘要(顶层字段、total/costToken 等计数、最大列表字段长度及前 3 条样本);加 --inline 强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 从保存文件按需抽取字段。

适用场景:查看 SBS 仓储概况(绑定仓库、当前库存);生成库存分析报表(库龄、效期、变动记录)。

限制与注意:本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探,需继续检索时应先向用户说明会产生额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。不适用于店铺授权、物流发货、头程绑定、商品 listing、FBS 巴西仓储等场景,分别对应其他技能。算力消耗规则:不消耗算力。