linkfox-1688-product-detail

1688 商品詳細

このスキルは、調達の判断に役立つ商品、価格、物流、サプライヤーの詳細を含む、offer ID に対応する構造化された 1688 商品レコードを 1 件取得します。

主な概念

• 詳細情報の照会であり、商品発見ではありません：既知の 1688 offerId を 1 件照会します。商品 ID がない場合は、検索スキルを使用してください。
• 完全な商品レコード：返された商品名、属性、メディア、SKU、販売、物流、サプライヤーの各フィールドを保持し、欠損値を捏造しないでください。
• 数量別の価格の意味：retailPrice がある場合、数量 1 にはこれを使用し、数量 2 以上には SKU の price と saleInfo.priceRanges[].price を使用します。移行期間中は、retailPrice がない場合、旧商品モデルであるか、設定された小売価格がない可能性があります。価格に関わる判断で、別のフィールドから 1 個の価格を推定しないでください。
• 調達データ：価格、在庫、MOQ、ドロップシッピング条件、梱包、サプライヤー指標、請求書、証明書は、最新の商品情報として扱ってください。
• 通貨の意味：CNY の retailPrice／price と、リクエストした通貨建ての foreignCurrencyRetailPrice／foreignCurrencyPrice は別々のフィールドです。CNY の価格をリクエストした通貨の価格として表示しないでください。

データフィールド

グループ	主なフィールド
識別情報	offerId、subject、productUrl、カテゴリ ID、status
メディアと商品説明	productImage、mainVideo、detailVideo、description、sellingPoints
SKU	skuList[].skuId、属性、画像、retailPrice、SKU の price（新モデルの卸売価格または旧モデルの価格）、リクエストした通貨の価格、在庫
販売	saleInfo.retailPrice、priceRanges（新モデルの卸売価格または旧モデルの価格帯）、amountOnSale、MOQ、単位、ドロップシッピングおよび送料無料の条件
物流	発送元、発送保証、梱包の寸法／重量、SKU ごとの測定値
サプライヤー	companyName、取引／サービス評価、リピート購入および品質に起因する返金の指標
調達	混合注文の設定、サービスタグ、プロモーション、請求書、証明書、商品バッジ

パラメーターガイド

パラメーター	必須	デフォルト	説明
offerId	はい	-	正の数値の 1688 商品 ID です。整数の精度損失を避けるため、文字列として渡してください
currency	いいえ	1688 のデフォルト	USD や HKD などの 3 文字の通貨コードです。サービスが大文字に正規化します

ユーザーが https://detail.1688.com/offer/1040473674152.html のような標準 URL を提示した場合、パス内の数値部分を offerId として抽出してください。uid、chatId、requestId、groupId、stepId、messageId、userInput、memberId など、プラットフォームが挿入するコンテキストフィールドは送信しないでください。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-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 を使って必要な情報を抽出してください。

価格の鮮度：調達コスト、利益率、見積もり、注文の判断に使う場合は、--no-cache を追加して最新の価格を取得してください。キャッシュされた 24 時間前までの結果を成約価格の確認に使用しないでください。最終的な成約価格は、調達 Skill の注文プレビューを基準としてください。

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

次の異常が発生した場合は、references/onboarding.md を使用して解決方法を案内してください。

異常の種類

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402。
• 計算リソースまたは残高が不足しているというレスポンス：メッセージに「算力余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」または同様の意味が含まれます。

使用例

1. USD 価格フィールドを含む商品詳細

python scripts/alibaba1688_product_detail.py '{"offerId":"1040473674152","currency":"USD"}'

2. 調達情報の確認

查询 1688 商品 1040473674152 的 1 件零售价、2 件及以上批发价、SKU 库存、起批量、包装重量、发货地和供应商服务分。

3. 商品 URL から詳細を取得

查询 https://detail.1688.com/offer/1040473674152.html 的标题、属性、SKU、价格库存和供应商信息。

表示ルール

1. 商品タイトルと offer ID を最初に表示し、その後に要求された商品情報を示します。
2. SKU の結果は、属性、在庫、1点購入時の小売価格、2点以上の卸売価格、指定通貨での価格、利用可能な場合はドロップシッピング価格を含む表で表示します。
3. CNY と外貨の価格は別々の列にします。retailPrice がない場合は不明のままにし、price、consignPrice、offerPrice、onePiecePrice、promotionPrice で代用しないでください。旧モデルの価格帯が1点から始まる場合は旧モデル価格帯と表示し、1点購入時の価格として使用する前にリアルタイムの注文プレビューを必須とします。
4. MOQ、単位、混合注文のルール、ドロップシッピング／送料無料の条件、発送元、発送保証、梱包サイズを明示します。
5. サプライヤー指標は実数値と割合で要約し、裏付けのない品質評価に置き換えないでください。
6. 視覚的な比較に役立つ場合は、商品画像と SKU 画像をインラインで表示します。
7. description 内の HTML はデータとして扱い、安全でないマークアップをレンダリングするのではなく、要約するかメディアリンクを抽出します。
8. sourceTool など、内部のルーティングラベルはユーザー向けの要約に含めません。

重要な制限事項

1. このツールは1回の呼び出しにつき1つの offerId のみを受け付け、キーワードや画像による検索はできません。
2. 商品、価格、在庫、物流、サプライヤーのデータはリアルタイムで変化する可能性があります。価格に基づく判断には --no-cache を使用し、購入前に注文プレビューで再確認してください。
3. 動画、証明書、プロモーション、一部の物流情報は含まれない場合があります。
4. currency は上流の外貨フィールドを要求しますが、すべての SKU、小売価格、卸売価格帯に対応するとは限りません。外貨建ての小売価格がない場合、通貨換算に失敗した可能性もあります。
5. この検索ではアカウントの認証、注文、支払い、調達状況の変更はできません。これらの操作には調達ワークフローを使用してください。
6. 結果は分析データベースに保存されないため、二次的な SQL／データクエリ処理は利用できません。

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

該当するケース -- 商品が特定されている場合の調達と詳細検索：

ユーザーの発言	シナリオ
「この 1688 商品 ID の詳細を調べて」	基本的な商品詳細
「この 1688 リンクの完全な商品詳細を調べて」	商品、SKU、物流、サプライヤーの詳細
「SKU の価格、在庫、MOQ を確認して」	調達と見積もりの確認
「梱包重量、発送元、発送保証を調べて」	物流の準備
「サプライヤーのサービス評価とリピート率を評価して」	サプライヤー情報の確認
「1点からのドロップシッピング、混合注文、請求書、証明書に対応している？」	調達条件

該当しないケース：

• offer ID が特定されていない状態での商品検索（1688 の画像検索または商品検索を使用）。
• 注文の作成、支払いリンクの請求、物流の追跡、請求書の発行（1688 の調達ワークフローを使用）。
• 過去の価格推移、レビュー、データベース分析。

判断基準：ユーザーが 1688 の商品 URL または offer ID を提示し、商品、調達条件、サプライヤー、物流について尋ねた場合は、このスキルを使用してください。画像またはキーワードしか提示されていない場合は、まず商品検索を使用してください。

算力消耗规则

算力消耗 1 点。

用户会因算力消耗而支付费用。需要查询多个商品时，先说明每个 offerId 都会产生一次调用成本，由用户决定是否继续。

フィードバック：

以下のいずれかに該当する場合は、Feedback API を使ってフィードバックを自動検出し、報告してください：

1. このスキルで説明されている機能または目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルについて不満または称賛を表明する
4. 改善できると思われる点がある

references/api.md に記載された方法で Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

---

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