Linkfox Wb Shopee Official Api

[!IMPORTANT] 本 Skill 必须依赖 MCP “LinkFox”。如未安装该MCP，请明确通知用户： 请先安装 LinkFox 连接器：

• 在 WorkBuddy 左侧找到 “专家·技能·连接器” → “连接器”；
• 搜索关键词 “LinkFox”，并安装连接器 “LinkFox”（注意：是 linkfox，不是 linkfox-product-selection），按指引完成登录授权；
• 返回 WorkBuddy 重试。

LinkFox Shopee 官方API（LinkFox Shopee Official API）

为 Shopee 店铺运营与系统集成提供统一的官方 API 执行能力：先完成店铺授权与选店，再按业务意图调用商品、交易履约、营销增长、内容媒体、仓储财务或平台公共接口，返回可审计的结构化响应。覆盖 29 个业务子能力、429 个 Shopee Open API operation，以及授权管理的 3 个操作，共 432 个路由项。每个子能力的完整参数、响应字段、错误码、特殊限制和执行依赖归档在对应 reference 中。

能力边界

能力范围

• linkfox-shopee-store-account-health：店铺健康指标、扣分处罚、问题 Listing 与逾期订单查询；适用时读取 references/linkfox-shopee-store-account-health.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-add-on-deal：加购优惠活动、主商品与子商品管理；适用时读取 references/linkfox-shopee-store-add-on-deal.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-ads：站内广告余额、推荐、Campaign、关键词与效果报表；适用时读取 references/linkfox-shopee-store-ads.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-ams：联盟营销 Open/Targeted Campaign、达人、商品与效果管理；适用时读取 references/linkfox-shopee-store-ams.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-auth：店铺 OAuth 授权、ERP/AD 应用区分、已授权店铺与授权状态管理；适用时读取 references/linkfox-shopee-store-auth.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-bundle-deal：套装优惠活动及商品项管理；适用时读取 references/linkfox-shopee-store-bundle-deal.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-discount：折扣活动及商品项的创建、查询、更新、结束与删除；适用时读取 references/linkfox-shopee-store-discount.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-fbs：巴西 FBS 店铺/商品拦截、入驻与发票问题查询；适用时读取 references/linkfox-shopee-store-fbs.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-first-mile：头程运单、承运渠道、转运仓与绑定解绑管理；适用时读取 references/linkfox-shopee-store-first-mile.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-follow-prize：关注有礼活动管理；适用时读取 references/linkfox-shopee-store-follow-prize.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-global-product：全球商品、跨店发布、属性、尺码表、价格库存与发布任务管理；适用时读取 references/linkfox-shopee-store-global-product.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-livestream：直播场次、展示商品、评论与互动管理；适用时读取 references/linkfox-shopee-store-livestream.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-logistics：物流渠道、面单、发货、地址、营业时间与轨迹管理；适用时读取 references/linkfox-shopee-store-logistics.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-media：媒体图片与视频分片上传；适用时读取 references/linkfox-shopee-store-media.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-media-space：MediaSpace 图片与视频分片上传；适用时读取 references/linkfox-shopee-store-media-space.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-merchant：商户信息、下属店铺、仓库与预付账户查询；适用时读取 references/linkfox-shopee-store-merchant.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-orders：订单、包裹、发票、取消、拆单与预约仓处理；适用时读取 references/linkfox-shopee-store-orders.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-payment：结算、Escrow、钱包、打款、收入报表与分期设置；适用时读取 references/linkfox-shopee-store-payment.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-product：商品 Listing、类目属性、变体、库存价格、推广、评论与合规信息；适用时读取 references/linkfox-shopee-store-product.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-public：Partner 公共查询、OAuth Token 与 Shopee IP 范围；适用时读取 references/linkfox-shopee-store-public.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-push：Push 回调配置、丢失消息查询与确认消费；适用时读取 references/linkfox-shopee-store-push.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-returns：退货退款、争议、凭证与逆向物流处理；适用时读取 references/linkfox-shopee-store-returns.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-sbs：SBS 仓储绑定、库存、库龄、效期与库存变动报表；适用时读取 references/linkfox-shopee-store-sbs.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-shop：店铺资料、仓库、通知、授权品牌与假期模式管理；适用时读取 references/linkfox-shopee-store-shop.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-shop-category：店铺自定义分类及分类商品管理；适用时读取 references/linkfox-shopee-store-shop-category.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-shop-flash-sale：店铺秒杀时段、活动与商品项管理；适用时读取 references/linkfox-shopee-store-shop-flash-sale.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-top-picks：精选商品集合管理；适用时读取 references/linkfox-shopee-store-top-picks.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-video：店铺视频发布、视频信息与效果分析；适用时读取 references/linkfox-shopee-store-video.md，按其中 toolName 与参数契约执行。
• linkfox-shopee-store-voucher：店铺优惠券的创建、查询、更新、结束与删除；适用时读取 references/linkfox-shopee-store-voucher.md，按其中 toolName 与参数契约执行。

边界与限制

• 授权前置：除授权/公共 OAuth 类操作外，店铺级接口需要已授权的 shopId 或 merchantId；按 shopId/merchantId + appType 判断授权状态。ERP 与 AD 是两套独立授权，广告路径必须使用 AD 授权。
• 统一代理：业务接口使用 proxy_call，精确 toolName 为 shopee/developerProxy；arguments 只提交 path、HTTP method、店铺/商户标识以及上游所需 query/body，不提交 accessToken 或 appType。服务端按 api/v2/ads/** 路径选择 AD，其余业务路径选择 ERP。
• 参数与区域：每个 operation 的必填字段、分页、日期、国家/站点、批量上限和异步轮询规则以对应 reference 为准；不要从相近 operation 推断字段。
• 数据类型：上传类接口按 reference 要求使用可访问 URL、分片或媒体句柄；本地文件不能直接当作公开图片/视频 URL。异步任务必须查询结果后再报告最终状态。
• 不适用：不负责 Shopee 账号注册、后台人工操作、平台政策或法律结论、侵权判定、支付扣款确认、供应商采购、站外广告，以及未在路由表和 references 中列出的端点。
• 安全与审计：不向用户展示 access token、refresh token 或 API Key；写操作（上架、改价、发货、退款、活动、广告预算等）执行前核对店铺、参数和目标状态，并在结果中标明操作是否已被平台接受。

工具选择指南

先按用户业务目标选定一个默认模块，再根据输入字段、授权类型、读写风险、是否异步和成本决定是否切换。相近需求按下表区分：

选择思路

• 先识别用户要操作的对象（店铺、商品、订单、包裹、退货、活动、广告、媒体或财务），再识别动作（查询、创建、更新、结束、删除、上传或报表）。
• 需要广告时先核对 appType=ad；需要普通店铺业务时核对 appType=erp。同一店铺可能同时出现两条授权记录。
• 同一对象存在轻量查询与详细查询时，先使用满足目标的较小接口；批量、报表和异步任务按 reference 的上限与轮询要求处理。
• 多个 operation 都能满足时，优先默认推荐，并把替代选项、必填参数、授权要求和可能的积分消耗告知用户，由用户决定是否继续。

业务需求路由速查

端点均使用 JSON。除授权管理三项外，路由表中的业务请求统一经 proxy_call 调用 shopee/developerProxy；reference 是该子能力的完整参数与响应归档，本地旧 HTTP 脚本已从调用链移除。