SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-shopee-store-global-product

linkfox-shopee-store-global-product

办公与效率

查看项目

更新于 10-16 10:58

技能介绍

Shopee 全球商品 GlobalProduct

用途 本 Skill 用于调用 Shopee Open Platform 的 GlobalProduct 模块（共 34 个 API），管理跨境全球商品及其发布到各站点的流程。GlobalProduct 为商户级 API，通常传 merchantId；发布/映射类接口可能同时需要 shopId。它依赖 linkfox-shopee-store-auth 选店；请求经 POST /shopee/developerProxy 传入 shopId（或 merchantId），由服务端解析 token 转发（path 须为 api/v2/global_product/...）。

主要能力

  • 类目/属性：获取类目、属性树、品牌列表、类目推荐、推荐属性、搜索全球属性值列表。
  • 全球商品 CRUD：获取全球商品列表、详情，新增、更新、删除全球商品，查询全球商品限额。
  • 全球 SKU：获取全球型号列表、初始化/更新分层规格（tier variation）、新增/更新/删除全球型号。
  • 价格/库存/同步：更新价格、更新库存、设置同步字段、获取与更新本地调价率。
  • 发布到站点：创建发布任务、获取可发布店铺、查询发布任务结果、获取已发布列表、查询店铺可发布状态、获取全球商品 ID。
  • 尺码表/规格：判断是否支持尺码表、更新尺码表、获取尺码表列表与详情、获取规格（variations）。

使用方式

  • API 端点：POST /shopee/developerProxy，不同操作通过请求体区分；完整参数、响应与错误码见 references/api.md。
  • Python 脚本：python scripts/global_product_api.py '<JSON 参数>' [--inline]；另有按功能划分的脚本（如 get_category.py、add_global_item.py、create_publish_task.py、update_stock.py 等）及通用入口 global_product_api.py。
  • 调用原则：先看 developerProxy.httpStatus，再读 *Response 字段；GET 请求业务参数放 JSON 顶层（runner 拼接 queryString），POST 复杂接口传 body、简单接口可传顶层 body 字段；每个脚本 docstring 含官方文档 URL（module=90）。
  • 输出策略：始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-global-product-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。响应体 ≤ 8 KB 时落盘后打印完整 JSON；> 8 KB 时只输出摘要（顶层字段、total/costToken 等计数、最大列表字段长度 + 前 3 条样本）。加 --inline 可强制全量打印（同样落盘）。读取数据建议先看摘要，再用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需抽取，避免整份 JSON 进入上下文。

适用场景

  • 创建全球商品并发布：get_category.py + get_attribute_tree.py（merchantId）→ add_global_item.py 传完整 body → create_publish_task.py 发布到目标站点 → get_publish_task_result.py 查发布结果。
  • 查全球商品与改库存：get_global_item_list.py（offset、page_size）、get_global_item_info.py（global_item_id_list）、update_stock.py / update_price.py（POST body）。

前置条件与限制

  • 必须先运行 python scripts/check_auth_dependency.py；若 exit code 42，先安装 linkfox-shopee-store-auth 并授权。
  • 不要在本 skill 内实现授权/令牌逻辑。
  • 出现未配置 API Key（LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应 401/402、或算力/余额不足等异常时，按 references/onboarding.md 引导解决。
  • 本页面说明存在两点需注意：正文一处提到“本工具会消耗算力；失败/空结果不得自动换关键词、翻页或连续试探”，而文末“算力消耗规则”写“不消耗算力”，两处表述不一致，建议以实际运行与官方文档为准。
  • 不适用范围：店铺授权、商户信息、单店 listing、订单、店铺信息、图片/视频上传等分别属于其他模块或 Skill。

可用脚本分组

  • 类目/属性：get_category.py、get_attribute_tree.py、get_brand_list.py、category_recommend.py、get_recommend_attribute.py、search_global_attribute_value_list.py
  • 全球商品 CRUD：get_global_item_list.py、get_global_item_info.py、add_global_item.py、update_global_item.py、delete_global_item.py、get_global_item_limit.py
  • 全球 SKU：get_global_model_list.py、init_tier_variation.py、update_tier_variation.py、add_global_model.py、update_global_model.py、delete_global_model.py
  • 价格/库存/同步：update_price.py、update_stock.py、set_sync_field.py、get_local_adjustment_rate.py、update_local_adjustment_rate.py
  • 发布到站点：create_publish_task.py、get_publishable_shop.py、get_publish_task_result.py、get_published_list.py、get_shop_publishable_status.py、get_global_item_id.py
  • 尺码表/规格：support_size_chart.py、update_size_chart.py、get_size_chart_list.py、get_size_chart_detail.py、get_variations.py
  • 通用入口：global_product_api.py（JSON 含 api 字段）；共享文件：_shopee_global_product_common.py、_global_product_endpoints.py、_global_product_api_runner.py。

每个 API 的入参与响应细节放在 references/apis/ 目录下的对应文档中（如 add-global-item.md、create-publish-task.md 等），模块总览见 references/api.md。