linkfox-1688-search-by-image

1688 画像ベースの商品検索

このスキルは、画像 URL を使用して 1688 プラットフォームで視覚的な商品検索を行い、越境販売者が仕入れ先を探す際に、見た目が似ている商品を見つけられるようにします。

主なコンセプト

1688 画像検索では、視覚認識を使って 1688 卸売マーケットプレイスから見た目が似ている商品を検索します。商品名、価格、最小注文数量、月間販売数、リピート購入率、取引スコア、販売者の身分バッジなど、仕入れ先商品のデータを返します。

データフィールド

フィールド	説明
offerId	1688 の商品 ID
title	商品名
imageUrl	商品のメイン画像
price	卸売価格（CNY）
consignPrice	ドロップシッピング価格（CNY）
salesQuantity	月間販売数
estimatedSalesAmount	推定月間売上高
quantityBegin	最小注文数量
repurchaseRate	リピート購入率
tradeScore	商品の取引スコア
compositeServiceScore	総合サービス体験スコア
sellerIdentities	販売者の身分（スーパー工場／優良販売者／誠信通会員）
offerIdentities	商品バッジ（厳選）
sendGoodsAddressText	発送元
deliveryTime	配送時間（24／48 時間）
isOnePsale	ドロップシッピングに対応（はい／いいえ）
isJxhy	プレミアム仕入れ（はい／いいえ）
hasPromotion	プロモーションあり（はい／いいえ）
isPatentProduct	特許商品（はい／いいえ）

パラメーターガイド

画像のルール：

1. JPEG と PNG は変更せずに渡します。WebP は実際のファイルバイトから判別され、1688 へのリクエスト前に自動的に JPEG に変換されます。
2. Base64 文字列は純粋なエンコード済みコンテンツである必要があり、data:image/jpeg;base64, のプレフィックスを含めないでください。
3. 画像ソースとして imageUrl、imageBase64、imageId のいずれかを指定する必要があります（少なくとも 1 つ必須）。

パラメーター	必須	デフォルト	説明
imageUrl	条件付き	-	公開画像 URL（最大 1000 文字）。JPEG／PNG はそのまま渡され、WebP は自動的に変換されます
imageBase64	条件付き	-	data URL プレフィックスを含まない純粋な Base64。JPEG／PNG はそのまま渡され、WebP は自動的に変換されます
imageId	条件付き	-	前回の検索結果に含まれる 1688 画像 ID（ページネーションを高速化します）
page	いいえ	1	ページ番号（1 から開始）
pageSize	いいえ	20	1 ページあたりの検索結果数（1～50）
priceStart	いいえ	-	価格の下限フィルター（CNY）
priceEnd	いいえ	-	価格の上限フィルター（CNY）
filter	いいえ	-	フィルター条件。カンマ区切り（下記の対応フィルターを参照）
sort	いいえ	{"monthSold":"desc"}	JSON 形式の並べ替え：{field: direction}（下記の対応する並べ替えフィールドを参照）
keyword	いいえ	-	検索結果をさらに絞り込むキーワード
productCollectionId	いいえ	-	商品コレクション ID（下記の対応 ID を参照）

対応フィルター

複数のフィルターをカンマで組み合わせられます（例：1688Selection,totalEpScoreLv1,qrr0）。

フィルター値	説明
1688Selection	1688厳選
certifiedFactory	認証工場
totalEpScoreLv1	総合体験スコア 5 つ星
totalEpScoreLv2	総合体験スコア 4 つ星
totalEpScoreLv3	総合体験スコア 3 つ星
totalEpScoreLv4	総合体験スコア 2 つ星
qrr0	品質に関する返金なし
qrr1	品質に関する返金率 <1%
qrr5	品質に関する返金率 <5%
qrr10	品質に関する返金率 <10%
shipInToday	当日発送
shipIn24Hours	24 時間以内に発送
shipIn48Hours	48 時間以内に発送
noReason7DReturn	7 日間、理由を問わず返品可能
isOnePsale	1 点からドロップシッピング可能
isOnePsaleFreePost	1 点からドロップシッピング可能、送料無料
new7	7 日以内の新商品
new30	30 日以内の新商品
isQqyx	グローバル厳選
JPFL	日本向け専用ルート
USFL	米国向け専用ルート
KRFL	韓国向け専用ルート
VNFL	ベトナム向け専用ルート
SAFL	サウジアラビア向け専用ルート
RUFL	ロシア向け専用ルート
KZFL	カザフスタン向け専用ルート
HKFL	香港向け専用ルート
MOFL	マカオ向け専用ルート
TWFL	台湾向け専用ルート

対応する並べ替えフィールド

フィールド	方向	説明
price	asc/desc	価格の昇順／降順
monthSold	asc/desc	月間販売数の昇順／降順
rePurchaseRate	asc/desc	リピート購入率の昇順／降順

並べ替え形式の例：価格の安い順にする場合は {"price":"asc"} を指定します。

対応する商品コレクション ID

ID	用途
262105288	越境商品在庫
262105286	越境商品在庫
262105253	越境商品在庫
262105281	越境商品在庫
262105280	越境商品在庫
262105277	越境商品在庫
262105276	越境商品在庫
262105274	越境商品在庫
262105269	越境商品在庫
262185282	越境商品在庫

呼び出し方法

• API エンドポイント：POST /alibaba1688/imageSearch（パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照）
• Python インタープリターの選択：呼び出し前に実際に利用可能な Python コマンドを選択し、このタスクでは常に同じものを使用して、<PYTHON> とします。Windows では py -3、python、python3 の順に試し、それ以外のシステムでは python3、python の順に試します。候補コマンドは <候補コマンド> -c "import sys; print(sys.executable)" を実行し、終了コードが 0 で、stdout に空でないインタープリターのパスが含まれている場合にのみ使用可能とみなします。WindowsApps の空出力のプレースホルダーコマンドは選択しないでください。
• Python スクリプト：<PYTHON> scripts/alibaba1688_image_search.py '<JSON 参数>' [--inline]
• 画像のシームレスな前処理：必ず上記のスクリプト経由で呼び出してください。JPEG／PNG は従来どおり処理します。WebP は Agent が Pillow を使って JPEG に変換してから、従来どおり呼び出します。ユーザーが手動で変換する必要はありません。
• Pillow の初回初期化：現在の実行環境でこの Skill を初めて呼び出す前に、Agent は <PYTHON> を使って <PYTHON> -c "from PIL import features; ok=features.check('webp'); print('WEBP_OK' if ok else 'WEBP_MISSING'); raise SystemExit(0 if ok else 1)" を実行する必要があります。終了コードが 0 で、stdout に WEBP_OK が含まれている場合のみチェック成功とみなします。チェックに失敗した場合は、通知せずに <PYTHON> -m pip install --disable-pip-version-check "Pillow>=10.4,<13" を実行し、同じ <PYTHON> で再度チェックを 1 回だけ行います。チェックに成功してから画像検索スクリプトを実行してください。2 回目も失敗した場合は処理を停止し、依存関係の初期化に失敗したことを報告します。有料 API を呼び出したり、インストールを繰り返したり、ユーザーに手動での対応を求めたりしてはいけません。以後の呼び出しではチェックに成功していれば、そのまま実行でき、再インストールは不要です。
• コスト制限：このツールは計算リソースを消費します。同一セッション内の同じパラメーターの組み合わせでは、原則として 1 回のみ呼び出してください。スクリプトには 24 時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードの変更、ページ送り、郵便番号の変更を連続して試してはいけません。検索を続ける場合は、追加のコストが発生することを事前にユーザーに伝えてください。

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

• 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-search-by-image-<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／プランの期限切れ／チャージが必要／チャージしてください」または同様の意味の内容が含まれています。

ローカル画像のアップロード

このツールでは、誰でもアクセスできる画像 URL が必要です。ユーザーがローカル画像のファイルパスを指定した場合は、先にアップロードして公開 URL を取得する必要があります。

アップロードスクリプトを実行します：

<PYTHON> scripts/upload_image.py /path/to/local/image.png

スクリプトは公開 URL を返します。この URL は 24 時間有効で、imageUrl パラメーターとして使用できます。

使用例

1. 基本的な画像検索

在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg

2. フィルターを使った検索

在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序

3. 並べ替えを使った検索

在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序

4. ページ分割検索

在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条

5. 価格帯フィルター

在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元

表示ルール

1. データを明確に提示する：商品画像、タイトル、価格、ドロップシッピング価格、月間販売数、最小注文数量、リピート購入率、販売者の属性など、主要な項目を含む構造化テーブルで結果を表示します
2. 画像表示：レスポンスに商品の imageUrl が含まれている場合は、視覚的に比較できるようインラインで表示します
3. 価格表示：価格は必ず CNY（¥）形式で表示します
4. 販売者バッジ：販売者の属性バッジ（スーパー工場／実力派販売者／誠信通会員）と商品バッジ（厳選）を目立つように表示します
5. 結果件数：結果の合計件数と、現在のページ／総ページ数を必ずユーザーに伝えます
6. ページネーションの案内：次のページがある場合は、次のページをリクエストできることをユーザーに案内します
7. フィルター／並べ替えの制限：ユーザーが未対応の並べ替えまたはフィルターを要求した場合、回避策を試さず、対応している選択肢を伝えます
8. 二次処理なし：結果はリアルタイムで取得され、データベースには保存されないため、SQL による二次データ処理は利用できません

重要な制限事項

1. データのリアルタイム性：結果はリアルタイム検索であり、データベースに保存されていません。二次処理に _dataQuery_executeDynamicQuery は使用できません。
2. ロジック上の制約：ユーザーが、あらかじめサポートされているリストにない並べ替え条件やフィルター条件を要求した場合、それを補うために他のツールやロジックを呼び出してはいけません。
3. 画像入力：imageUrl、imageBase64、imageId のいずれかが必須です。2ページ目以降では、クエリを高速化するため、1ページ目の結果から取得した imageId を渡すことを推奨します。
4. 画像形式：JPEG/PNG は元のパスに従います。同梱スクリプトは、1688 の呼び出し前に WebP を JPEG に自動変換します。GIF およびその他の形式は、元の動作を維持します。
5. Base64 形式：imageBase64 の値には、生の Base64 文字列のみを指定してください。data:image/jpeg;base64, プレフィックスを含めてはいけません。
6. ページサイズ：1ページあたり最大50件です。

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

適用対象 -- 1688 での画像による商品仕入れ検索シナリオ：

ユーザーの発言	シナリオ
「1688以图搜图」／「用图片找1688货源」	基本的な画像検索
「帮我在1688找这个图片的同款」	同じスタイルの商品を検索
「跨境找工厂，图片是...」	越境向けの仕入先検索
「这个Amazon产品在1688有没有货源」	Amazon の画像から仕入先を逆引き
「筛选1688严选的相似商品」	フィルター条件付き画像検索
「按月销量排序找相似货源」	並べ替え条件付き画像検索
「查看第2页结果」	ページネーション

適用対象外 -- 1688 の画像検索を超える機能が必要な場合：

• テキスト／キーワードによる1688検索（店雷达-1688选品库を使用）
• 1688の商品ランキング／トレンド（店雷达-1688商品榜单を使用）
• Amazonの画像検索（亚马逊前端-以图搜图を使用）
• 画像の生成または編集
• 商品レビューの分析
• 価格履歴またはトレンド分析

適用範囲の判断：ユーザーが「找货源」や「找同款」と述べ、画像URLを提供しており、1688で見た目の似た商品を見つける意図がある場合、このスキルが適用されます。1688でキーワード検索やランキングデータを求めている場合は、店雷达ツールを使用してください。

算力消耗规则

5 算力を消耗します。

ユーザーは算力の消耗に応じて料金を支払います。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが算力の消耗量を十分に把握していないと思われる場合は、十分に検討したうえで、必ずユーザーに注意を促してください。続行するかどうかはユーザーが決定します。

フィードバック：

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

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

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

---

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