SuperAPI AI 工具集

linkfox-shopee-store-product

编程与开发

查看项目

更新于 10-16 06:24

技能介绍

用途:管理 Shopee(虾皮)店铺商品,封装 Shopee Open Platform Product 模块的 57 个 API,经 POST /shopee/developerProxy 转发,请求体传入 shopId(或 merchantId),由服务端解析 token 后经紫鸟 shopee-proxy 调用 Shopee API,path 须为 api/v2/product/...。

主要能力:类目/属性/品牌(get_category、get_attribute_tree、get_brand_list 等);商品 CRUD(get_item_list、get_item_base_info、add_item、update_item、delete_item、unlist_item、search_item);SKU/价格/库存(get_model_list、init_tier_variation、add_model、update_price、update_stock);推广与评论(boost_item、get_boosted_list、get_item_promotion、get_comment、reply_comment);以及 Kit/SSP/Direct/Mart/Outlet、尺码表、违规、车辆兼容、内容诊断等扩展接口。

使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装 linkfox-shopee-store-auth 并授权店铺;本技能不实现授权/令牌逻辑。脚本调用格式为 python scripts/<脚本名>.py '<JSON 参数>' [--inline],通用入口 product_api.py(JSON 含 api 字段)。GET 业务参数放 JSON 顶层,POST 复杂接口传 body。典型上架流程:get_category → get_attribute_tree → add_item。

输出与限制:完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON 文件,禁止写入 /tmp;响应 ≤8 KB 打印完整 JSON,>8 KB 只输出摘要,--inline 可强制全量打印。未配置 LINKFOX_AGENT_API_KEY 或出现 401/402、算力余额不足时按 references/onboarding.md 处理。本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探。店铺授权、订单、物流、广告、支付等由同系列其他技能负责。具体参数与错误码见 references/api.md 及 references/apis/。