SuperAPI AI 工具集

linkfox-shopee-store-shop

编程与开发

查看项目

更新于 10-16 06:23

技能介绍

用途:通过 LinkFox 技能调用 Shopee Open API 的 Shop 模块(共 9 个接口),完成店铺信息查询与部分设置操作。依赖 linkfox-shopee-store-auth 选店,不在本技能内实现授权或令牌逻辑。

主要能力:get_shop_info 返回 region、status、expire_time 等;get_profile 返回店名、logo、描述;update_profile 可更新店名、logo、描述(店名 30 天仅可改一次,logo 须为 Shopee 图片 URL);get_warehouse_detail 查询仓库,可选 warehouse_type(1=揽收仓,2=退货仓);get_shop_notification 获取卖家通知(page_size 最大 50,cursor 分页);get_authorised_reseller_brand 查询授权品牌(必填 page_no、page_size ≤30);get_br_shop_onboarding_info 仅巴西站;get_shop_holiday_mode 与 set_shop_holiday_mode 查询和设置假期模式(开启后买家无法下单)。

使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth 并授权店铺。API 端点统一为 POST /shopee/developerProxy,通过请求体区分操作,传入 shopId 或 merchantId,由服务端解析 token 转发,path 须为 api/v2/shop/...。也可用 Python 脚本:python scripts/<脚本名>.py '<JSON 参数>' [--inline],或使用通用入口 shop_api.py(JSON 含 api 字段)。GET 业务参数放 JSON 顶层,POST 传 body 或顶层 body 字段。

输出与限制:脚本默认将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json,禁止写入 /tmp;响应体 ≤8 KB 时打印完整 JSON,>8 KB 时仅输出摘要,--inline 可强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需抽取字段。本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。店铺授权、商户信息、订单、物流、退货、商品、店铺分类、账户健康、跨境全球商品等不在本技能范围。具体入参与响应细节见 references/apis/ 与 references/api.md。