linkfox-shopee-store-fbs

Shopee FBS ブラジル倉庫

Shopee Open Platform FBS モジュール（4 つの API、すべて GET、ブラジル BR 向け）。linkfox-shopee-store-auth に依存してショップを選択します。POST /shopee/developerProxy に shopId（または merchantId）を渡すと、サーバー側でトークンを解析して転送します（path は api/v2/fbs/... である必要があります）。

呼び出し方法

• API エンドポイント：POST /shopee/developerProxy（リクエストボディで操作を区別します。パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照してください）
• Python スクリプト：python scripts/<スクリプト名>.py '<JSON パラメーター>' [--inline]（利用可能なスクリプトは上記のスクリプト一覧を参照してください）
• コスト上の制約：このツールは計算リソースを消費します。失敗した場合や結果が空の場合に、キーワードを自動的に変更したり、ページを切り替えたり、連続して試したりしてはいけません。検索を続ける必要がある場合は、追加の消費が発生することを事前にユーザーに説明してください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-fbs-<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／プランの期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれている場合。

公式リファレンス

FBS モジュールのインデックス：v2.fbs.query_br_shop_enrollment_status

---

前提条件

1. python scripts/check_auth_dependency.py を実行します。exit code が 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
2. 汎用 SBS 倉庫 → linkfox-shopee-store-sbs、物流 → linkfox-shopee-store-logistics。

利用可能なスクリプト（4 つの API）

スクリプト	API	Method
query_br_shop_enrollment_status.py	query_br_shop_enrollment_status	GET
query_br_shop_invoice_error.py	query_br_shop_invoice_error	GET
query_br_shop_block_status.py	query_br_shop_block_status	GET
query_br_sku_block_status.py	query_br_sku_block_status	GET
fbs_api.py	汎用エントリーポイント	—

API の説明（API 別）

パラメーターとレスポンスの詳細は references/apis/ にあり、SKILL にはインデックスのみを記載しています。

API	説明ドキュメント
query_br_shop_block_status	references/apis/query-br-shop-block-status.md
query_br_shop_enrollment_status	references/apis/query-br-shop-enrollment-status.md
query_br_shop_invoice_error	references/apis/query-br-shop-invoice-error.md
query_br_sku_block_status	references/apis/query-br-sku-block-status.md

モジュールの概要と Feedback については、references/api.md を参照してください。

使用シナリオ

1. ブラジルの FBS ショップのステータスを確認する

1. query_br_shop_enrollment_status.py で登録状況を確認
2. query_br_shop_block_status.py でショップの利用停止状況を確認
3. query_br_sku_block_status.py で SKU の利用停止状況を確認

2. 請求書の問題を調査する

query_br_shop_invoice_error.py で請求書のエラーを確認

対象外

• ショップの認証 → linkfox-shopee-store-auth
• SBS の汎用倉庫在庫 → linkfox-shopee-store-sbs
• 物流・出荷 → linkfox-shopee-store-logistics
• 商品 listing → linkfox-shopee-store-product

計算リソースの消費ルール

計算リソースは消費しません。

Feedback： references/api.md を参照してください。

---

高品質でプロフェッショナルな越境 EC スキルをお探しの場合は、LinkFox Skills をご覧ください。