SuperAPI AI 工具集

linkfox-shopee-store-merchant

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:查询 Shopee(虾皮)商户级信息,覆盖 Merchant 模块 6 个 API,主要面向跨境卖家。依赖 linkfox-shopee-store-auth 完成选店与授权,本技能不实现授权/令牌逻辑。

主要能力:get_merchant_info(商户名称、region、currency、授权过期)、get_shop_list_by_merchant(列出授权店铺)、get_merchant_warehouse_list、get_merchant_warehouse_location_list、get_warehouse_eligible_shop_list、get_merchant_prepaid_account_list。

使用方式:API 端点为 POST /shopee/developerProxy,不同操作通过请求体区分,path 须为 api/v2/merchant/...;也可运行 python scripts/<脚本名>.py '<JSON 参数>' [--inline],或使用通用入口 merchant_api.py(JSON 含 api 字段)。运行前先执行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装并授权 linkfox-shopee-store-auth。Merchant 为商户级 API,须传 merchantId。

输出与限制:脚本默认将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件,禁止写入 /tmp;响应体 ≤ 8 KB 时打印完整 JSON,> 8 KB 时仅输出摘要,加 --inline 可强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需抽取字段。本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探;需要继续检索时应先向用户说明会产生额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。店铺授权、单店信息、全球商品、单店 listing、订单及 Public 模块不属于本技能。