用途:面向 Shopee 巴西(BR)FBS 仓储场景,封装 Shopee Open Platform FBS 模块的 4 个 GET 接口,用于查询店铺入驻状态、店铺封禁状态、SKU 封禁状态和发票错误。
主要能力:query_br_shop_enrollment_status(入驻状态)、query_br_shop_block_status(店铺封禁)、query_br_sku_block_status(SKU 封禁)、query_br_shop_invoice_error(发票错误)。
使用方式:依赖 linkfox-shopee-store-auth 选店;经 POST /shopee/developerProxy 传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/fbs/...。可调用 Python 脚本:python scripts/<脚本名>.py '<JSON 参数>' [--inline],另有通用入口 fbs_api.py。运行前先执行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth。
输出策略:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-fbs-<timestamp>.json,禁止写入 /tmp;响应体 ≤ 8 KB 时打印完整 JSON,> 8 KB 时仅输出摘要,加 --inline 强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 从保存文件按需抽取字段。
限制:本工具不消耗算力;失败或空结果不得自动换关键词、翻页或连续试探,需继续检索时应先向用户说明会产生额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。店铺授权、SBS 通用仓储、物流发货、商品 listing 分别由同系列其他技能负责。接口入参与响应细节见 references/apis/ 下对应文档。