linkfox-shopee-product-detail

Shopee 商品詳細の取得

対応するマーケットプレイスの URL から、Shopee 商品 1 件の現在の公開詳細を取得します。

基本概念

• 1 回の呼び出しにつき商品 1 件：productUrl で 1 件の出品を指定します。キーワード検索ツールではありません。
• URL からマーケットを判定：ストアフロント、通貨、ロケールは URL から推定されます。
• 個別出品モード：ツールは指定された商品 URL を自動検出し、一致する出品行を 1 件だけリクエストします。
• 現在のスナップショット：価格、在庫、販売数、評価、ショップの値は、リクエスト時点の公開ページを反映します。

データフィールド

data 内の各オブジェクトには、次の項目が含まれる場合があります。

グループ	主なフィールド
識別情報	itemId、shopId、url、name、brand、categoryId、categoryBreadcrumb
メディア	image、images、videos
価格	price、priceBeforeDiscount、priceMin、priceMax、discountPercent、currency
需要	sold、soldDisplayed、rating、ratingCount、ratingDistribution、likedCount
在庫	stock、tierVariations、models
ショップ	shopName、shopRating、shopLocation、isMall、公式・認証に関するシグナル、ネストされた shop データ
コンテンツ	description、attributes、カテゴリデータ、提供される場合は在庫状況と状態

一般的でないフィールドや新たに追加されたトップレベルフィールドも、返される商品オブジェクトに保持されます。フィールドが存在しない場合や、null の場合があります。

パラメーターガイド

パラメーター	必須	デフォルト	説明
productUrl	はい	-	パスが -i.<numeric shopId>.<numeric itemId> で終わる Shopee の HTTPS 商品 URL

対応ホスト：shopee.sg、shopee.co.id、shopee.com.my、shopee.ph、shopee.co.th、shopee.tw、shopee.vn、shopee.com.br。

呼び出し方法

• API エンドポイント：POST /shopee/product/detail（完全なパラメーター／レスポンス／エラーコードは references/api.md を参照）
• Python スクリプト：python scripts/shopee_product_detail.py '<JSON 参数>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同一セッションで同じパラメーターの組み合わせを使う場合、デフォルトでは 1 回だけ呼び出します。スクリプトには 24 時間のローカルキャッシュがあります。失敗や空の結果が返された場合、キーワードの変更、ページ送り、郵便番号の変更を自動で繰り返して試してはいけません。検索を続ける必要がある場合は、追加コストが発生することを事前にユーザーに説明してください。

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-product-detail-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動で集約されます。/tmp への書き込みは禁止。現在のディレクトリに書き込めない場合はエラーを返します）。
• レスポンス本文が 8 KB 以下：ファイルに書き込んだ後、完全な JSON を stdout に出力します。
• レスポンス本文が 8 KB を超える場合：ファイルに書き込んだ後、stdout には要約のみを出力します（トップレベルフィールド、total／costToken などの一般的なカウント、最大のリストフィールドの長さと先頭 3 件のサンプル）。
• --inline を付けると、stdout に全量を強制出力します（同様にファイルにも書き込みます）。

データの読み取りに関する推奨事項：まず要約を確認し、十分な情報があるか判断します。具体的なフィールドが必要な場合は、JSON 全体をコンテキストに読み込ませないよう、保存された JSON ファイルから jq または ConvertFrom-Json を使って必要な項目だけを抽出してください。

認証と計算リソースの問題の解決

次の問題が発生した場合は、references/onboarding.md の案内に従って解決してください。

• LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスが 401 または 402 です。
• レスポンスに計算リソース、残高、プラン、クォータが不足していると示されています。

使用例

python scripts/shopee_product_detail.py '{"productUrl":"https://shopee.sg/%28LENECT-OFFICIAL-STORE%29-Flash-I-Aurora-Dual-Highlighter-7.2g-COCOMO-i.9641401.29691169956"}'

表示ルール

1. 出品名、商品 ID、ショップ、マーケットプレイス、現在価格、通貨、在庫、公開販売数を最初に表示します。
2. 現在価格／元の価格と割引率は、返されたとおりに表示します。依頼がない限り、通貨を換算しないでください。
3. SKU モデルとバリエーションごとの在庫がある場合は、コンパクトな表にまとめて表示します。
4. 必要に応じて、画像を大量に表示するのではなく、少数の画像をインラインで表示します。
5. Shopee Mall、公式ショップ、認証済み販売者のフラグは、それぞれ独立して扱います。
6. 説明、モデル、在庫、販売数、その他の追加フィールドが利用できない場合は、その旨を伝えます。
7. ユーザーが必要とする場合に限り、保存された JSON から大きなネストされたセクションの正確な内容を読み取ります。

重要な制限事項

1. URL には、ドキュメントに記載されている -i.<shopId>.<itemId> のパスを使用する必要があります。正規の /product/<shopId>/<itemId> URL はこのツールでは受け付けられません。
2. 顧客レビューの行は返されません。ratingCount と ratingDistribution は、情報源から提供されている場合に限り、集計データとして利用できます。
3. 公開されるフィールドは、市場、出品状態、販売者、情報源ページの内容の充実度によって異なります。インドネシア、シンガポール、マレーシア、タイ、フィリピンでは通常、クラウド上の情報源からより詳細な情報を取得できます。ベトナム、ブラジル、台湾では、取得されるレコードの情報が少ない場合があります。
4. models ではバリエーションごとの在庫が確認できますが、個々のバリエーションごとの価格は取得できない場合があります。
5. 無効、削除済み、または市場が一致しない出品は、空のリストではなくエラーを返します。
6. このツールでは、Shopee の検索、過去の推移の確認、認証済み販売者アカウントの管理はできません。

ユーザーの依頼とシナリオのクイックリファレンス

対象 — 既知の Shopee 出品が 1 件ある場合：

ユーザーの発言	シナリオ
「この虾皮商品链接を調べて」	出品の詳細確認
「価格、販売数、在庫を確認して」	現在の出品状況の確認
「バリエーション、画像、ブランドを抽出して」	SKU とコンテンツの抽出
「このショップは公式ショップ？」	公開情報に基づくショップ確認

対象外：

• キーワード検索、ランキング、一括商品スクリーニング
• 顧客レビューの全件収集や感情分析
• 価格と在庫の過去の推移の監視
• 認証済み販売者による出品、注文、プロモーション、アカウントの操作

計算リソース消費ルール

計算リソースを 53 消費します。

ユーザーには計算リソースの消費に応じて料金が発生します。異なる商品を繰り返し検索すると、その都度料金が発生します。続けて呼び出す前に、追加の消費についてユーザーに知らせてください。

フィードバック：

説明されている機能と実際の動作が異なる場合、結果がユーザーの意図に沿わない場合、ユーザーが称賛や不満を表明した場合、またはスキルを改善できる場合は、フィードバックを自動検出し、Feedback API を通じて報告してください。ユーザーの操作を中断せずに references/api.md に従ってください。

---

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