linkfox-dld-product-search

1688 商品検索（DianLeiDa）

このスキルでは、1688 卸売プラットフォームで商品を検索・分析する方法を説明します。EC 販売者や仕入れ担当者が、質の高いサプライヤーや収益性の高い商品を見つけるのに役立ちます。

基本概念

このツールは、1688（中国最大の B2B 卸売マーケットプレイス）でキーワードによる商品検索を提供します。販売データ、価格帯、サプライヤーの資格情報、配送オプションを含む商品リストを集約します。データは DianLeiDa（店舗レーダー分析）から取得され、7 日間および 30 日間の販売指標を含むリアルタイムの商品リストを対象としています。

主な用語：

• 卸売価格（price）：最小ロット数量を注文した場合の 1 点あたりの価格
• ドロップシッピング価格（consignPrice）：1 点からのドロップシッピングにおける 1 点あたりの価格（通常、卸売価格より高額）
• TrustPass 年数（tpYear）：サプライヤーが Alibaba の TrustPass 会員である年数。事業継続期間を示します
• 販売数量（salesQuantity）：選択した期間中に販売された合計点数
• 注文数（salesOrderCount）：選択した期間中の個別注文の合計数
• 推定販売額（estimatedSalesAmount）：選択した期間中の推定売上高

データフィールド

Field	API Name	Description	Example
商品タイトル	title	商品リストの正式なタイトル	...
商品 ID	offerId	1688 の一意の商品識別子	805578065498
商品 URL	asinUrl	商品リストへの直接リンク	https://detail.1688.com/...
画像 URL	imageUrl	商品のメイン画像	https://cbu01.alicdn.com/...
卸売価格	price	ロット数量での 1 点あたりの価格（CNY）	12.50
ドロップシッピング価格	consignPrice	1 点からのドロップシッピングにおける価格（CNY）	18.90
価格帯	quantityPrices	数量に応じた価格の内訳	...
最小注文数量	quantityBegin	最小注文数量	2
注文数	salesOrderCount	期間中の注文数	350
販売数量	salesQuantity	期間中に販売された点数	1200
推定販売額	estimatedSalesAmount	期間中の推定売上高	45000
配送時間	deliveryTime	発送予定時間	24h
出品日	availableDate	商品が初めて出品された日	2025-03-15
カテゴリー	levelName	商品カテゴリーの階層	...
ショップ名	company	サプライヤー／店舗名	...
ショップ ID	shopId	一意の店舗識別子	...
ショップ URL	shopUrl	サプライヤーの店舗へのリンク	https://shop...
通貨	currency	価格の通貨（常に CNY）	CNY
データタイプ	dataType	期間の指標：weeklyData または monthlyData	monthlyData

パラメーターガイド

検索キーワード

最も重要なパラメーターです。キーワードは中国語で指定する必要があります。 ユーザーが英語の用語を指定した場合は、検索前に中国語に翻訳してください。

• keyWord（文字列、最大 50 文字）：中国語の検索語
• searchType：1 = あいまい一致（デフォルト）、3 = 完全一致
• goodsUrl：キーワードの代わりに商品 URL で検索します
• productIds：特定の商品 ID で検索します（カンマ区切り、最大 20 件）

期間

• cycle：直近 7 日間は "7"、直近 30 日間は "30"

並べ替え

• sortField：並べ替えに使用するフィールド。デフォルト：orderCount30d
  • orderCount7d / orderCount30d -- 注文数
  • saleCount7d / saleCount30d -- 販売点数
  • saleVolume7d / saleVolume30d -- 推定売上高
  • offerCreateTime -- 出品日
  • price -- 卸売価格
  • consignPrice -- ドロップシッピング価格
• sortType："desc"（デフォルト）または "asc"

価格フィルター

• beginPrice / endPrice：卸売価格の範囲（CNY）
• beginConsignPrice / endConsignPrice：ドロップシッピング価格の範囲（CNY）

販売フィルター

• beginOrderCount / endOrderCount：注文数の範囲
• beginSaleCount / endSaleCount：販売点数の範囲
• beginSaleVolume / endSaleVolume：売上高の範囲（CNY）

仕入先フィルター

• companyType：0 = すべて（デフォルト）、1 = 店舗、2 = 工場
• shiLiType：販売者ランク。カンマ区切りで複数選択できます：
  • superFactory -- スーパー工場
  • Power -- パワー加盟店
  • TrustPass -- TrustPass 会員のみ
• beginTpYear / endTpYear：TrustPass 会員年の範囲

商品タグ

• offerType：0 = すべて、2 = 新商品、3 = 1688 Select、4 = 越境向け、5 = カスタマイズ可能、6 = 人気店舗のおすすめ

フルフィルメントとサービス

• sendTime：配送速度。カンマ区切りで指定します："24"、"48"、"72"
• faceToFaceSupport：プラットフォームの送り状対応。カンマ区切りで指定します：
  • 441218（Taobao）、386434（Douyin）、422914（Pinduoduo）、422978（Xiaohongshu）、386370（Kuaishou）
• proxyRights：ドロップシッピング特典。カンマ区切りで指定します：
  • 4360897（送料無料のドロップシッピング）、449154（後払い）
• shopService：販売者のサービス。カンマ区切りで指定します：
  • 4057409（安心購入）、888777（詳細な認証レポート）
• buyerProtections：購入者向け保証。中国語の文字列をカンマ区切りで指定します：
  • 商品包邮（送料無料）、7天包退货（7日間返品可能）、支持运费险（送料保険対応）

出品日のフィルター

• beginOfferCreateTime / endOfferCreateTime：YYYY-MM-DD 形式の日付範囲

ページネーション

• pageIndex：ページ番号。1 から始まります（デフォルト：1）
• pageSize：1 ページあたりの結果数。10～100（デフォルト：20）

クエリの例

1. 基本的なキーワード検索 -- 「ヨガマット」の人気販売者

{"keyWord": "瑜伽垫", "cycle": "30", "sortField": "saleCount30d", "sortType": "desc", "pageSize": 20}

2. 工場限定の価格帯検索

{"keyWord": "蓝牙耳机", "companyType": 2, "beginPrice": 10, "endPrice": 50, "cycle": "30", "sortField": "orderCount30d"}

3. ドロップシッピング対応の越境商品

{"keyWord": "手机壳", "offerType": 4, "proxyRights": "4360897", "cycle": "7", "sortField": "saleVolume7d"}

4. 最近出品された新商品を出品日順に並べ替え

{"keyWord": "夏季连衣裙", "offerType": 2, "sortField": "offerCreateTime", "sortType": "desc", "pageSize": 50}

5. スーパー工場の販売数が多い商品

{"keyWord": "数据线", "shiLiType": "superFactory", "beginSaleCount": 1000, "cycle": "30", "sortField": "saleCount30d"}

6. 商品 URL で検索

{"goodsUrl": "https://detail.1688.com/offer/805578065498.html", "cycle": "30"}

表示ルール

1. データをわかりやすく表示する：商品タイトル、価格、販売実績、仕入先情報を含む構造化された表で結果を表示します。ユーザーが商品ページに直接アクセスできるよう、商品 URL も含めます。
2. 価格の内訳：卸売価格とドロップシッピング価格の両方が取得できる場合は、必ず表示して利益率を比較できるようにします。
3. 販売実績：使用した cycle パラメーターに基づき、実績が7日間または30日間の数値であることを明記します。
4. 画像の表示：imageUrl が利用可能な場合は、ユーザーが商品を目で見て確認できるよう、商品画像を表示します。
5. ページネーションのお知らせ：total が返されたページサイズを超える場合は、結果の総数と、追加のページをリクエストできることをユーザーに知らせます。
6. エラー処理：クエリでエラーが返された場合は、問題を説明し、パラメーターの調整（フィルター範囲の拡大、キーワードのスペル確認など）を提案します。
7. キーワードの翻訳：ユーザーが英語の商品用語を入力した場合は、API を呼び出す前に中国語に翻訳し、回答内でその翻訳について説明します。

適用シナリオ

ユーザーの発言	シナリオ
「1688でXXの仕入先を探して」	キーワードによる商品検索
「1688でよく売れている商品は？」	売れ筋商品の発見
「工場から安いXXを探して」	価格フィルターを使った工場からの仕入れ
「XXの1688のドロップシッピング仕入先」	ドロップシッピング対応商品の検索
「1688でXXの価格を比較して」	仕入先間の価格比較
「1688でXXの新商品」	新商品の発見
「越境向けの1688商品を探して」	越境向け商品の仕入れ
「24時間以内に発送する1688の仕入先は？」	フルフィルメント速度による絞り込み
「XXのトップ工場」	スーパー工場／パワー加盟店の検索
「この1688の商品を探して」（URL または ID 付き）	商品の直接検索

該当しないケース

• Amazonなど、1688以外のプラットフォームの商品調査
• 1688の店舗単位の分析（店舗へのアクセス数、店舗ランキング）
• 1688の広告や販促戦略
• 商品レビューや評価の分析
• 物流コストの計算や送料の見積もり
• 注文や取引の処理
• ユーザーが分析対象の商品データファイルをすでにローカルに持っている場合

適用範囲の判断：「仕入れ」「サプライヤーを探す」「卸売商品」といった依頼でも、価格、販売数、サプライヤーの種類などで絞り込み、1688プラットフォームで特定の商品を検索する場合は、このスキルが適用されます。店舗単位の分析、広告の最適化、商品検索以外の運営業務が必要な場合は適用されません。

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

次の異常が発生した場合は、references/onboarding.md を参照して問題の解決を案内してください。

異常

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

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

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

計算リソースの消費に伴い、ユーザーに料金が発生します。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーに伝え、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

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

---

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