SuperAPI AI 工具集

linkfox-shopee-store-shop-category

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:管理 Shopee(虾皮)店铺分类及其下商品,覆盖 Shopee Open Platform Shop Category 模块的 7 个 API。依赖 linkfox-shopee-store-auth 完成选店,经 POST /shopee/developerProxy 传入 shopId(或 merchantId),由服务端解析 token 转发,path 须为 api/v2/shop_category/...。

主要能力(7 个 API):add_shop_category、get_shop_category_list、delete_shop_category、update_shop_category、add_item_list、get_item_list、delete_item_list,另有通用入口 shop_category_api.py。对应脚本如 add_shop_category.py、get_shop_category_list.py 等。

使用方式:API 端点 POST /shopee/developerProxy,不同操作通过请求体区分,完整参数、响应与错误码见 references/api.md 及 references/apis/ 下各接口文档。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 时落盘后全量打印,> 8 KB 时只输出摘要,加 --inline 可强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 从文件按需抽取字段。

适用场景:创建/更新/删除店铺分类,向分类添加或移除商品,查看分类与商品列表。

限制:本工具会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探,需继续检索应先向用户说明额外消耗;未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。店铺授权、商品 listing CRUD、Top Picks、店铺基础信息分别由其他同系列技能负责。算力消耗规则:不消耗算力。