mcpField
L
linkfox-shopee-store-shop

linkfox-shopee-store-shop

github.com/linkfox-aiその他113227 回インストール2 週間前に更新
リポジトリ

linkfox-shopee-store-shop について

Shopee Open PlatformのShopモジュールAPIを扱い、ショップ情報、プロフィール、倉庫情報、通知の取得と、プロフィールや休暇モードの更新を行うスキルです。事前に`linkfox-shopee-store-auth`でショップを選択し、認証する必要があります。

主な機能

  1. 01ショップの状態と基本情報の取得
  2. 02プロフィールの参照と更新
  3. 03倉庫情報と販売者通知の確認
  4. 04認定販売ブランドの一覧取得
  5. 05休暇モードの確認と設定

活用シーン

  1. 01地域、状態、認証期限の確認
  2. 02ショップ名、ロゴ、説明の変更
  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 のいずれか1つ以上を渡します（ロゴは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を呼び出してください。ユーザーの作業を中断しないでください。

高品質でプロフェッショナルな越境ECスキルについては、LinkFox Skillsをご覧ください。

コメント

Markdown 対応