linkfox-shopee-store-sbs について
LinkFox ゲートウェイ経由で Shopee Open Platform の SBS 倉庫データを照会し、倉庫、在庫、分析レポートを確認するスキルです。SBS の状況を調べる店舗管理者向けで、店舗選択には linkfox-shopee-store-auth が必要です。
主な機能
- 01連携済み倉庫情報の照会
- 02現在庫の確認
- 03在庫滞留期間・期限レポートの取得
- 04在庫変動記録の照会
- 05レスポンスの JSON ファイル保存
活用シーン
- 01連携倉庫と現在庫の確認
- 02在庫期間・期限・変動の分析
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/linkfox-shopee-store-sbsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/api.mdonboarding.mdreferences/apis/get-bound-whs-info.mdget-current-inventory.mdget-expiry-report.mdget-stock-aging.mdget-stock-movement.mdscripts/_sbs_api_runner.py_sbs_endpoints.py_shopee_sbs_common.pycheck_auth_dependency.pyget_bound_whs_info.pyget_current_inventory.pyget_expiry_report.pyget_stock_aging.pyget_stock_movement.pyonboarding.pysbs_api.py詳細
Shopee SBS 倉庫サービス
Shopee Open Platform の SBS モジュール（API は 5 つで、すべて GET です）。linkfox-shopee-store-auth に依存しており、店舗を選択します。POST /shopee/developerProxy に shopId（または merchantId）を渡すと、サーバー側でトークンを解析して転送します（path は api/v2/sbs/... を指定する必要があります）。
呼び出し方法
- 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 に全量を強制的に出力します（同様にファイルにも書き込みます）
データの読み取りに関する推奨事項：まず概要を確認して、必要な情報がそろっているか判断してください。具体的なフィールドが必要な場合は、保存された JSON ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出し、JSON 全体がコンテキストに入るのを避けてください。
認証と計算リソースの問題を解決する
以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。
異常の状況
- API Key が未設定：環境変数
LINKFOX_AGENT_API_KEYとLINKFOXAGENT_API_KEYのいずれも設定されていません。 - レスポンスのステータスコードが 401 または 402
- 計算リソースまたは残高が不足しているというレスポンス：メッセージに「計算リソースの残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの期限切れ／チャージが必要／チャージしてください」または同様の意味の内容が含まれています。
公式リファレンス
SBS モジュールのインデックス：v2.sbs.get_bound_whs_info
前提条件
python scripts/check_auth_dependency.pyを実行します。終了コードが 42 の場合は、先にlinkfox-shopee-store-authをインストールしてください。- 物流の出荷には
linkfox-shopee-store-logistics、ファーストマイルにはlinkfox-shopee-store-first-mileを使用します。
使用可能なスクリプト（API は 5 つ）
| スクリプト | API | Method |
|---|---|---|
get_bound_whs_info.py | get_bound_whs_info | GET |
get_current_inventory.py | get_current_inventory | GET |
get_expiry_report.py | get_expiry_report | GET |
get_stock_aging.py | get_stock_aging | GET |
get_stock_movement.py | get_stock_movement | GET |
sbs_api.py | 汎用エントリーポイント | — |
インターフェースの説明（API 別）
パラメーターとレスポンスの詳細は references/apis/ に記載されています。SKILL にはインデックスのみを記載しています。
| API | 説明ドキュメント |
|---|---|
get_bound_whs_info | references/apis/get-bound-whs-info.md |
get_current_inventory | references/apis/get-current-inventory.md |
get_expiry_report | references/apis/get-expiry-report.md |
get_stock_aging | references/apis/get-stock-aging.md |
get_stock_movement | references/apis/get-stock-movement.md |
モジュールの概要／フィードバックは references/api.md を参照してください。
使用シナリオ
1. SBS の倉庫状況を確認する
get_bound_whs_info.pyで連携済みの倉庫を確認しますget_current_inventory.pyで現在の在庫を確認します
2. 在庫分析レポート
get_stock_aging.pyで在庫期間を確認しますget_expiry_report.pyで有効期限を確認しますget_stock_movement.pyで変動記録を確認します
対象外
- 店舗の認証 →
linkfox-shopee-store-auth - 物流の出荷パラメーター／送り状 →
linkfox-shopee-store-logistics - ファーストマイルの連携 →
linkfox-shopee-store-first-mile - 商品 listing →
linkfox-shopee-store-product - FBS ブラジルの倉庫 →
linkfox-shopee-store-fbs
計算リソースの消費ルール
計算リソースを消費しません。
フィードバック： references/api.md を参照してください。
高品質で専門的な越境 EC スキルについては、LinkFox Skills をご覧ください。