linkfox-dld-product-billboard

DLD 商品排行榜（1688 ベストセラーランキング）

このスキルでは、1688 プラットフォームの商品ベストセラーランキングデータを照会する方法を説明します。中国最大の B2B マーケットプレイスで、売れ筋の卸売商品や仕入れの機会を見つけるのに役立ちます。

基本概念

DLD 商品ランキングでは、1688 プラットフォームの商品ランキングデータにアクセスできます。週間と月間のベストセラーリストに対応しています。国内の中国卸売市場で、注目の卸売商品を見つけ、サプライヤーを比較し、仕入れの機会を特定できます。

ランキングの種類：

• 週間ランキング（pageType=2）：日付パラメーターには、対象週の日曜日を指定してください（例：2025-06-15）。過去 90 日間のデータを利用できます。
• 月間ランキング（pageType=3）：日付パラメーターには、対象月の初日を指定してください（例：2025-06-01）。過去 12 か月間のデータを利用できます。

デフォルトの動作：月間ランキングを注文数の降順で並べ替え、1 ページあたり 20 件を表示します。

パラメーターガイド

基本パラメーター

パラメーター	型	必須	デフォルト	説明
keyWord	string	いいえ	—	商品検索キーワード（中国語で指定する必要があります。そうでない場合は、先に翻訳してください）
date	string	いいえ	—	照会日。週間：日曜日の日付（例：2025-06-15）。月間：月の初日（例：2025-06-01）
pageType	integer	いいえ	3	ランキングの種類：2 = 週間、3 = 月間
pageIndex	integer	いいえ	1	ページ番号（1 から開始）
pageSize	integer	いいえ	20	1 ページあたりの件数（10～100）

並べ替え

パラメーター	型	デフォルト	説明
sortField	string	orderCount	並べ替え項目：orderCount（注文数）、saleCount（販売個数）、saleVolume（推定売上）、offerCreateTime（出品日）、price（卸売価格）、consignPrice（ドロップシッピング価格）
sortType	string	desc	並べ替え順：desc（降順）、asc（昇順）

価格・販売量フィルター

パラメーター	型	説明
beginPrice / endPrice	number	卸売価格の範囲
beginConsignPrice / endConsignPrice	number	ドロップシッピング価格の範囲
beginOrderCount / endOrderCount	integer	注文数の範囲
beginSaleCount / endSaleCount	integer	販売個数の範囲
beginSaleVolume / endSaleVolume	number	推定売上の範囲
beginStartQuantity / endStartQuantity	integer	最小注文数量の範囲

商品・販売者フィルター

パラメーター	型	説明
searchType	integer	キーワードの一致方式：1 = あいまい検索（デフォルト）、3 = 完全一致
offerType	integer	商品タグ：0 = 指定なし、2 = 新商品、3 = 1688 セレクト、4 = 越境販売、5 = カスタマイズ可能、6 = 店舗の注目商品
companyType	integer	会社の種類：0 = 指定なし、1 = 店舗、2 = 工場
shiLiType	string	販売者のランク（カンマ区切り）：superFactory、Power、TrustPass
beginTpYear / endTpYear	integer	TrustPass 会員年数の範囲

物流・サービスフィルター

パラメーター	型	説明
sendTime	string	発送までの時間（時間単位、カンマ区切り）：24、48、72
proxyRights	string	ドロップシッピング特典（カンマ区切り）：4360897（送料無料のドロップシッピング）、449154（先に購入して後払い）
shopService	string	販売者のサービス（カンマ区切り）：4057409（安心購入）、888777（詳細検証レポート）
buyerProtections	string	購入者保護（中国語の値をカンマ区切りで指定）
faceToFaceSupport	string	配送ラベル対応（カンマ区切り）：441218（Taobao）、386434（Douyin）、422914（Pinduoduo）、422978（Xiaohongshu）、386370（Kuaishou）

その他

パラメーター	型	説明
productIds	string	中国語の読点で区切った商品 ID。最大 20 件
goodsUrl	string	検索する商品の直接 URL
beginOfferCreateTime / endOfferCreateTime	string	出品日の範囲（形式：YYYY-MM-DD）

使用例

1. キーワードで月間ベストセラーを検索

「今月、1688で最も売れているスマートフォンケースを表示してください」

{"keyWord": "手机壳", "pageType": 3, "date": "2026-03-01", "sortField": "orderCount", "sortType": "desc"}

2. 売上高順の週間ランキング

「ヨガマットのカテゴリーで、先週最も売上高の高かった商品は何ですか？」

{"keyWord": "瑜伽垫", "pageType": 2, "date": "2026-03-22", "sortField": "saleVolume", "sortType": "desc"}

3. 価格で絞り込んだ工場直販商品

「1688で、価格が5～30元の工場直販イヤホン商品を探してください」

{"keyWord": "耳机", "companyType": 2, "beginPrice": 5, "endPrice": 30, "sortField": "saleCount", "sortType": "desc"}

4. 国際配送タグ付きの迅速発送商品

「24時間以内に発送される、国際配送タグ付きの LED ライト商品を表示してください」

{"keyWord": "LED灯", "offerType": 4, "sendTime": "24", "sortField": "orderCount", "sortType": "desc"}

5. 優良工場の新商品

「ペット用品カテゴリーで、優良工場から新しく出品された商品を探してください」

{"keyWord": "宠物用品", "offerType": 2, "shiLiType": "superFactory", "sortField": "offerCreateTime", "sortType": "desc"}

6. バイヤー保護付きのドロップシッピング向け商品

「送料無料で返品に対応している、ドロップシッピング向けのバッグ商品を表示してください」

{"keyWord": "包包", "proxyRights": "4360897", "buyerProtections": "商品包邮,7天包退货", "sortField": "orderCount", "sortType": "desc"}

7. 価格帯を指定した販売数の多い商品

「おもちゃカテゴリーで、注文数が1,000件を超え、卸売価格が50元未満の商品を探してください」

{"keyWord": "玩具", "beginOrderCount": 1000, "endPrice": 50, "sortField": "orderCount", "sortType": "desc"}

8. 商品 ID で検索

「次の1688の商品 ID を検索してください：123456、789012」

{"productIds": "123456、789012"}

表示ルール

1. データを明確に提示する：商品タイトル、卸売価格、ドロップシッピング価格、注文数、販売個数、推定売上高、サプライヤー名、出品日を含め、整理された表で商品検索結果を表示します
2. 画像の表示：imageUrl が利用可能な場合は、ユーザーが商品を視覚的に識別できるよう商品画像を表示します
3. リンクの提示：ユーザーが1688の商品ページに直接移動できるよう、商品リンク（asinUrl）とショップリンク（shopUrl）を含めます
4. 価格の表記：価格には必ず通貨（CNY/RMB）を付け、卸売価格かドロップシッピング価格かを明記します
5. 販売量の明示：販売データを提示する際は、dataType フィールドに基づいて週次データか月次データかを明確に記載します
6. ページネーションの案内：総件数が現在のページの結果数を超える場合は、総件数を伝え、さらにページを取得するかユーザーに確認します
7. キーワードの翻訳：ユーザーが中国語以外の言語でキーワードを指定した場合は、検索前に中国語に翻訳し、翻訳したキーワードをユーザーに伝えます
8. エラー処理：検索に失敗した場合は、問題を説明し、パラメーターの調整（例：フィルターの範囲を広げる、日付形式を確認する）を提案します

重要な制限事項

• キーワードの言語：keyWord パラメーターは中国語で指定する必要があります。検索前に、必ず中国語以外のキーワードを翻訳してください。
• 日付形式に関する注意：週間ランキングの日付は日曜日、月間ランキングの日付は月の1日にする必要があります。
• 週間データの範囲：過去90日間のみです。
• 月間データの範囲：過去12か月間のみです。
• ページサイズの上限：1回のリクエストで最大100件です。
• 商品 ID の上限：1回の検索で最大20件の商品 ID を指定できます。

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

適用対象 — 1688での商品発見と仕入れ：

ユーザーの発言	シナリオ
「1688で人気の商品は？」「1688のトレンド商品」	ベストセラーの発見
「XXの安いサプライヤーを探して」「XXの卸売仕入れ先」	キーワードによる仕入れ先検索
「工場直販の商品」「OEMサプライヤー」	工場による絞り込み
「越境仕入れ」「輸出向け商品」	越境タグによる絞り込み
「1688のドロップシッピング商品」	ドロップシッピング対応商品の検索
「1688の新商品」「最近出品された商品」	新商品の発見
「XXのサプライヤーを比較して」	複数の結果の比較
「1688の商品ランキング」「ベストセラーリスト」	ランキングの閲覧

適用対象外 — 1688の商品ランキングデータの範囲を超えるもの：

• Amazonの商品調査やキーワード分析（代わりにABAツールを使用してください）
• 1688の店舗レベルの分析（店舗ランキング、店舗スコア）
• Alibaba.com（国際版）のデータ
• 価格交渉や注文
• 商品品質のレビューや認証
• 物流コストの計算や貨物輸送

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

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

異常な状態

• API Keyが未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• 401または402のステータスコードが返される
• 計算リソースまたは残高不足を示す応答：メッセージに「計算リソースの残高不足／課金額不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれている場合。

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

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

ユーザーは計算リソースの消費に対して料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を十分に見積もれていない場合は、必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md の指定に従ってフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境ECスキルをさらに利用するには、LinkFox Skills を設定してください。