mcpField
L
linkfox-shopee-store-shop

linkfox-shopee-store-shop

github.com/linkfox-ai其他113227 次安装2 周前更新
代码仓库

关于 linkfox-shopee-store-shop

此技能封装 Shopee Open Platform 的 Shop 模块接口，用于查询店铺信息、资料、仓库和通知，并支持更新店铺资料及假期模式。需先通过 `linkfox-shopee-store-auth` 选择已授权店铺。

主要功能

  1. 01查询店铺状态与基本信息
  2. 02读取及更新店铺资料
  3. 03查看仓库详情和卖家通知
  4. 04查询授权经销品牌
  5. 05查看或设置假期模式

适用场景

  1. 01检查店铺区域、状态和授权期限
  2. 02修改店名、Logo 或描述
  3. 03查看揽收仓或退货仓资料
  4. 04检查通知并管理假期模式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-shopee-store-shop

安装后在 Claude Code 中输入/linkfox-shopee-store-shop确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
onboarding.md
references/apis/
get-authorised-reseller-brand.md
get-br-shop-onboarding-info.md
get-profile.md
get-shop-holiday-mode.md
get-shop-info.md
get-shop-notification.md
get-warehouse-detail.md
set-shop-holiday-mode.md
update-profile.md
scripts/
_shop_api_runner.py
_shop_endpoints.py
_shopee_shop_common.py
check_auth_dependency.py
get_authorised_reseller_brand.py
get_br_shop_onboarding_info.py
get_profile.py
get_shop_holiday_mode.py
get_shop_info.py
get_shop_notification.py
get_warehouse_detail.py
onboarding.py
set_shop_holiday_mode.py
shop_api.py
update_profile.py

详细介绍

Shopee 店铺 Shop

Shopee Open Platform Shop 模块（9 个 API）。依赖 linkfox-shopee-store-auth 选店；经 POST /shopee/developerProxy 传入 shopId（或 merchantId），由服务端解析 token 转发（path 须 api/v2/shop/...）。

调用方式

  • API 端点：POST /shopee/developerProxy（不同操作通过请求体区分；完整参数/响应/错误码见 references/api.md）
  • Python 脚本：python scripts/<脚本名>.py '<JSON 参数>' [--inline]（可用脚本见上文脚本一览）
  • 成本约束：本工具会消耗算力；失败/空结果不得自动换关键词、翻页或连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
  • 加 --inline 强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况
  • 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
  • 响应401或402状态码
  • 响应提示算力或余额不足：消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

官方参考

Shop 模块索引：v2.shop.get_shop_info

Prerequisites（必须先读）

  1. 运行 python scripts/check_auth_dependency.py；exit code 42 → 先安装 linkfox-shopee-store-auth 并授权店铺。
  2. 不要在本 skill 内实现授权/令牌逻辑。

Core Concepts

  • 转发链路：developerProxy（shopId/merchantId 选店，服务端注入 token）→ 紫鸟 shopee-proxy → Shopee API
  • 信息 vs 资料：get_shop_info 返回 region/status/授权过期等；get_profile 返回店名/logo/描述
  • 写操作：update_profile（店名 30 天仅可改一次）、set_shop_holiday_mode（开启后买家无法下单）
  • 仓库：get_warehouse_detail 可选 warehouse_type（1=揽收仓，2=退货仓）
  • 区域限制：get_br_shop_onboarding_info 仅巴西站

可用脚本（Shop 模块 9 个 API）

脚本APIMethod
get_shop_info.pyget_shop_infoGET
get_profile.pyget_profileGET
update_profile.pyupdate_profilePOST
get_warehouse_detail.pyget_warehouse_detailGET
get_shop_notification.pyget_shop_notificationGET
get_authorised_reseller_brand.pyget_authorised_reseller_brandGET
get_br_shop_onboarding_info.pyget_br_shop_onboarding_infoGET
get_shop_holiday_mode.pyget_shop_holiday_modeGET
set_shop_holiday_mode.pyset_shop_holiday_modePOST
shop_api.py通用入口（JSON 含 api 字段）—

共享：_shopee_shop_common.py、_shop_endpoints.py、_shop_api_runner.py。入参见 references/apis/。

接口说明（按 API）

入参与响应细节放在 references/apis/，SKILL 只保留索引。

API说明文档
get_authorised_reseller_brandreferences/apis/get-authorised-reseller-brand.md
get_br_shop_onboarding_inforeferences/apis/get-br-shop-onboarding-info.md
get_profilereferences/apis/get-profile.md
get_shop_holiday_modereferences/apis/get-shop-holiday-mode.md
get_shop_inforeferences/apis/get-shop-info.md
get_shop_notificationreferences/apis/get-shop-notification.md
get_warehouse_detailreferences/apis/get-warehouse-detail.md
set_shop_holiday_modereferences/apis/set-shop-holiday-mode.md
update_profilereferences/apis/update-profile.md

模块总览 / Feedback 见 references/api.md。

Usage Scenarios

1. 查看店铺基本信息
  1. auth skill 定位 shopId
  2. get_shop_info.py：region、status（NORMAL/BANNED/FROZEN）、expire_time
  3. 可选 get_profile.py：店名、logo、描述
2. 更新店铺资料

update_profile.py 传入 shop_name / shop_logo / description 中至少一项（logo 须为 Shopee 图片 URL）

3. 假期模式
  1. get_shop_holiday_mode.py 查询当前状态
  2. set_shop_holiday_mode.py 传入 holiday_mode_on: true/false
4. 仓库与通知
  • 仓库：get_warehouse_detail.py（可选 warehouse_type=1|2）
  • 卖家通知：get_shop_notification.py（page_size 最大为 50，cursor 分页）
  • 授权品牌：get_authorised_reseller_brand.py（必填 page_no、page_size ≤30）

调用原则

  • 先查看 developerProxy.httpStatus，再读取 *Response 字段
  • GET：业务参数放在 JSON 顶层（runner 拼接 queryString）
  • POST：传入 body 或顶层 body 字段
  • 每个脚本的 docstring 均含 官方文档 URL（module=92）

不适用范围

  • 店铺授权 → linkfox-shopee-store-auth
  • 商户信息 → linkfox-shopee-store-merchant
  • 订单 → linkfox-shopee-store-orders
  • 物流发货 → linkfox-shopee-store-logistics
  • 退货退款 → linkfox-shopee-store-returns
  • 商品 listing → linkfox-shopee-store-product
  • 店铺分类 Shop Category → linkfox-shopee-store-shop-category
  • 账户健康 Account Health → linkfox-shopee-store-account-health
  • 跨境全球商品 → linkfox-shopee-store-global-product

算力消耗规则

不消耗算力。

反馈：

出现以下任一情况时，通过 Feedback API 自动检测并提交反馈：

  1. 此技能描述的功能或用途与实际行为不符
  2. 此技能的结果与用户意图不符
  3. 用户表达了对该技能的不满或赞扬
  4. 任何你认为可以改进的地方

按照 references/api.md 中的说明调用反馈 API。不要打断用户的流程。

如需了解更多优质、专业的跨境电商技能，请访问 LinkFox 技能。

评论

支持 Markdown