Back to Details

linkfox-1688-search-by-image

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

1688 Image-Based Product Search

1688 基于图片的商品搜索

This skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.
该技能通过图片URL在1688平台执行视觉商品搜索，帮助跨境卖家寻找外观相似的供应商货源。

Core Concepts

核心概念

1688 Image Search uses visual recognition to find products with similar appearance on the 1688 wholesale marketplace. It returns supplier product data including title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity badges.
1688图片搜索利用视觉识别技术在1688批发平台上查找外观相似的商品。返回的供应商商品数据包括标题、价格、起批量、月销量、复购率、交易评分以及卖家身份标识等。

Data Fields

数据字段

FieldDescription
offerIdProduct ID on 1688
titleProduct title
imageUrlProduct main image
priceWholesale price (CNY)
consignPriceDropship price (CNY)
salesQuantityMonthly sales volume
estimatedSalesAmountEstimated monthly revenue
quantityBeginMinimum order quantity
repurchaseRateRepurchase rate
tradeScoreProduct trade score
compositeServiceScoreComposite service experience score
sellerIdentitiesSeller identity (超级工厂/实力商家/诚信通会员)
offerIdentitiesProduct badge (严选)
sendGoodsAddressTextShipping origin
deliveryTimeDelivery time (24/48 hours)
isOnePsaleSupports dropshipping (是/否)
isJxhyPremium sourcing (是/否)
hasPromotionHas promotion (是/否)
isPatentProductPatent product (是/否)
字段描述
offerId1688平台商品ID
title商品标题
imageUrl商品主图
price批发价格（人民币）
consignPrice一件代发价格（人民币）
salesQuantity月销量
estimatedSalesAmount预估月销售额
quantityBegin起批量
repurchaseRate复购率
tradeScore商品交易评分
compositeServiceScore综合服务体验分
sellerIdentities卖家身份（超级工厂/实力商家/诚信通会员）
offerIdentities商品标识（严选）
sendGoodsAddressText发货地
deliveryTime发货时效（24/48小时）
isOnePsale是否支持一件代发（是/否）
isJxhy是否为优质货源（是/否）
hasPromotion是否有促销活动（是/否）
isPatentProduct是否为专利产品（是/否）

Parameter Guide

参数指南

Image Rules:
  1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.
  2. Base64 string must be pure encoded content WITHOUT the 
    data:image/jpeg;base64,
    prefix.
  3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).
ParameterRequiredDefaultDescription
imageUrlConditional-Public image URL (max 1000 chars). Only png/jpg/jpeg formats supported
imageBase64Conditional-Pure Base64 encoded image string, without 
data:image/...;base64,
prefix. Only png/jpg/jpeg supported
imageIdConditional-1688 image ID from previous search result (speeds up pagination)
pageNo1Page number, starting from 1
pageSizeNo20Results per page (1-50)
priceStartNo-Min price filter (CNY)
priceEndNo-Max price filter (CNY)
filterNo-Filter conditions, comma-separated (see supported filters below)
sortNo{"monthSold":"desc"}Sort as JSON: {field: direction} (see supported sort fields below)
keywordNo-Keyword to further filter results
productCollectionIdNo-Product collection ID (see supported IDs below)
图片规则：
  1. 仅支持png、jpg、jpeg格式，不支持webp、gif及其他格式。
  2. Base64字符串必须为纯编码内容，不得包含
    data:image/jpeg;base64,
    前缀。
  3. 图片来源——必须提供imageUrl、imageBase64或imageId中的至少一个。
参数是否必填默认值描述
imageUrl可选（三选一）-公开图片URL（最多1000字符），仅支持png/jpg/jpeg格式
imageBase64可选（三选一）-纯Base64编码的图片字符串，不得包含
data:image/...;base64,
前缀，仅支持png/jpg/jpeg格式
imageId可选（三选一）-来自之前搜索结果的1688图片ID（可加快分页查询速度）
page否1页码，从1开始
pageSize否20每页结果数量（1-50）
priceStart否-最低价格筛选（人民币）
priceEnd否-最高价格筛选（人民币）
filter否-筛选条件，用逗号分隔（参见下方支持的筛选条件）
sort否{"monthSold":"desc"}排序规则（JSON格式）：{字段: 排序方向}（参见下方支持的排序字段）
keyword否-用于进一步筛选结果的关键词
productCollectionId否-商品集合ID（参见下方支持的ID）

Supported Filters

支持的筛选条件

Multiple filters can be combined with commas (e.g. 
1688Selection,totalEpScoreLv1,qrr0
).
Filter ValueDescription
1688Selection1688严选
certifiedFactory认证工厂
totalEpScoreLv1综合体验分5星
totalEpScoreLv2综合体验分4星
totalEpScoreLv3综合体验分3星
totalEpScoreLv4综合体验分2星
qrr0无品质退款
qrr1品质退款率<1%
qrr5品质退款率<5%
qrr10品质退款率<10%
shipInToday当日发货
shipIn24Hours24小时发货
shipIn48Hours48小时发货
noReason7DReturn7天无理由退货
isOnePsale一件代发
isOnePsaleFreePost一件代发包邮
new77天内新品
new3030天内新品
isQqyx全球严选
JPFL日本专线
USFL美国专线
KRFL韩国专线
VNFL越南专线
SAFL沙特专线
RUFL俄罗斯专线
KZFL哈萨克斯坦专线
HKFL香港专线
MOFL澳门专线
TWFL台湾专线
可使用逗号组合多个筛选条件（例如：
1688Selection,totalEpScoreLv1,qrr0
）。
筛选值描述
1688Selection1688严选
certifiedFactory认证工厂
totalEpScoreLv1综合体验分5星
totalEpScoreLv2综合体验分4星
totalEpScoreLv3综合体验分3星
totalEpScoreLv4综合体验分2星
qrr0无品质退款
qrr1品质退款率<1%
qrr5品质退款率<5%
qrr10品质退款率<10%
shipInToday当日发货
shipIn24Hours24小时发货
shipIn48Hours48小时发货
noReason7DReturn7天无理由退货
isOnePsale一件代发
isOnePsaleFreePost一件代发包邮
new77天内新品
new3030天内新品
isQqyx全球严选
JPFL日本专线
USFL美国专线
KRFL韩国专线
VNFL越南专线
SAFL沙特专线
RUFL俄罗斯专线
KZFL哈萨克斯坦专线
HKFL香港专线
MOFL澳门专线
TWFL台湾专线

Supported Sort Fields

支持的排序字段

FieldDirectionDescription
priceasc/descPrice ascending/descending
monthSoldasc/descMonthly sales ascending/descending
rePurchaseRateasc/descRepurchase rate ascending/descending
Sort format example: 
{"price":"asc"}
for price low to high.
字段排序方向描述
priceasc/desc价格升序/降序
monthSoldasc/desc月销量升序/降序
rePurchaseRateasc/desc复购率升序/降序
排序格式示例：
{"price":"asc"}
表示价格从低到高排序。

Supported Product Collection IDs

支持的商品集合ID

IDUsage
262105288跨境货盘
262105286跨境货盘
262105253跨境货盘
262105281跨境货盘
262105280跨境货盘
262105277跨境货盘
262105276跨境货盘
262105274跨境货盘
262105269跨境货盘
262185282跨境货盘
ID用途
262105288跨境货盘
262105286跨境货盘
262105253跨境货盘
262105281跨境货盘
262105280跨境货盘
262105277跨境货盘
262105276跨境货盘
262105274跨境货盘
262105269跨境货盘
262185282跨境货盘

API Usage

API 使用说明

This tool calls the LinkFox tool gateway API. See 
references/api.md
for calling conventions, request parameters, and response structure. You can also execute 
scripts/alibaba1688_image_search.py
directly to run queries.
该工具调用LinkFox工具网关API。调用规范、请求参数及响应结构请参考
references/api.md
。您也可以直接执行
scripts/alibaba1688_image_search.py
来运行查询。

Local Image Upload

本地图片上传

This tool requires a publicly accessible image URL. If the user provides a local image file path, you must upload it first to obtain a public URL.
Run the upload script:
bash
python scripts/upload_image.py /path/to/local/image.png
The script will return a public URL (valid for 24 hours) that can be used as the imageUrl parameter.
该工具需要可公开访问的图片URL。如果用户提供本地图片文件路径，您必须先上传图片以获取公开URL。
运行上传脚本：
bash
python scripts/upload_image.py /path/to/local/image.png
脚本将返回一个公开URL（有效期24小时），可作为imageUrl参数使用。

Usage Examples

使用示例

1. Basic image search
在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg
2. Search with filters
在1688搜索与图片相似的商品，图片地址为 https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg，查询第1页，筛选1688严选，并按价格从高到低排序
3. Search with sorting
在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，按价格从高到低排序
4. Paginated search
在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，查询第2页，每页50条
5. Price range filter
在1688搜索与图片相似的商品，图片地址为 https://example.com/product.jpg，价格区间10-100元
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元

Display Rules

展示规则

  1. Present data clearly: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity
  2. Image display: When the response includes imageUrl for products, display them inline for visual comparison
  3. Price display: Always show price in CNY (¥) format
  4. Seller badges: Display seller identity badges (超级工厂/实力商家/诚信通会员) and product badges (严选) prominently
  5. Result count: Always inform the user of total results and current page/total pages
  6. Pagination hint: When more pages are available, suggest the user can request the next page
  7. Filter/sort limitation: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options
  8. No secondary processing: Results are real-time and not stored in a database, so secondary SQL/data processing is not available
  1. 数据清晰呈现：以结构化表格展示结果，关键列包括：商品图片、标题、价格、一件代发价格、月销量、起批量、复购率及卖家身份
  2. 图片展示：当响应包含商品imageUrl时，将其嵌入显示以便视觉对比
  3. 价格展示：始终以人民币（¥）格式显示价格
  4. 卖家标识：突出显示卖家身份标识（超级工厂/实力商家/诚信通会员）及商品标识（严选）
  5. 结果数量：始终告知用户总结果数、当前页码及总页数
  6. 分页提示：当存在更多页面时，建议用户可请求下一页
  7. 筛选/排序限制：如果用户请求的排序或筛选条件不在支持列表中，请勿尝试任何变通方法，告知用户支持的选项
  8. 无二次处理：结果为实时搜索数据，未存储在数据库中，因此无法进行二次SQL/数据处理

Important Limitations

重要限制

  1. Data real-time nature: Results are live searches, not stored in any database. Cannot use 
    _dataQuery_executeDynamicQuery
    for secondary processing.
  2. Logic constraint: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.
  3. Image input: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.
  4. Image format: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.
  5. Base64 format: The imageBase64 value must be the raw Base64 string only — do NOT include the 
    data:image/jpeg;base64,
    prefix.
  6. Page size: Maximum 50 results per page.
  1. 数据实时性：结果为实时搜索数据，未存储在任何数据库中。无法使用
    _dataQuery_executeDynamicQuery
    进行二次处理。
  2. 逻辑约束：如果用户请求的排序或筛选条件不在预设支持列表中，请勿调用任何其他工具或逻辑进行补偿。
  3. 图片输入：必须提供imageUrl、imageBase64或imageId中的一个。当页码>1时，优先传递第一页结果中的imageId以加快查询速度。
  4. 图片格式：仅支持png、jpg、jpeg格式。webp、gif及其他格式将被拒绝。
  5. Base64格式：imageBase64值必须为纯Base64字符串——不得包含
    data:image/jpeg;base64,
    前缀。
  6. 页面大小：每页最多显示50条结果。

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable -- Visual product sourcing scenarios on 1688:
User SaysScenario
"1688以图搜图" / "用图片找1688货源"Basic image search
"帮我在1688找这个图片的同款"Find same-style products
"跨境找工厂，图片是..."Cross-border supplier sourcing
"这个Amazon产品在1688有没有货源"Reverse sourcing from Amazon image
"筛选1688严选的相似商品"Filtered image search
"按月销量排序找相似货源"Sorted image search
"查看第2页结果"Pagination
Not applicable -- Needs beyond 1688 image search:
  • Text/keyword-based 1688 search (use 店雷达-1688选品库)
  • 1688 product rankings/trending (use 店雷达-1688商品榜单)
  • Amazon image search (use 亚马逊前端-以图搜图)
  • Image generation or editing
  • Product review analysis
  • Price history or trend analysis
Boundary judgment: When users say "找货源" or "找同款", if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use the 店雷达 tools instead.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in 
references/api.md
. Do not interrupt the user's flow.
<!-- LF_LARGE_RESPONSE_BLOCK -->
适用场景——1688平台视觉货源采购场景：
用户表述场景
"1688以图搜图" / "用图片找1688货源"基础图片搜索
"帮我在1688找这个图片的同款"查找同款商品
"跨境找工厂，图片是..."跨境供应商货源搜索
"这个Amazon产品在1688有没有货源"通过Amazon图片反向找货源
"筛选1688严选的相似商品"带筛选条件的图片搜索
"按月销量排序找相似货源"带排序的图片搜索
"查看第2页结果"分页查询
不适用场景——超出1688图片搜索范围的需求：
  • 基于文本/关键词的1688搜索（使用店雷达-1688选品库）
  • 1688商品排名/趋势（使用店雷达-1688商品榜单）
  • Amazon图片搜索（使用亚马逊前端-以图搜图）
  • 图片生成或编辑
  • 商品评论分析
  • 价格历史或趋势分析
边界判断：当用户提及"找货源"或"找同款"时，如果用户提供了图片URL且意图是在1688上查找外观相似的商品，则适用该技能。如果用户需要在1688上进行基于关键词的搜索或获取排名数据，请使用店雷达工具。
反馈：
当出现以下任一情况时，自动检测并通过Feedback API提交反馈：
  1. 该技能描述的功能或用途与实际行为不符
  2. 技能结果不符合用户意图
  3. 用户表达了对该技能的不满或赞扬
  4. 任何您认为可以改进的内容
按照
references/api.md
中的说明调用反馈API，请勿中断用户流程。
<!-- LF_LARGE_RESPONSE_BLOCK -->

Handling Large Responses

大响应处理

To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:
python scripts/response_io.py run --script scripts/alibaba1688_image_search.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"
Pick 
--out-dir
outside any git working tree (e.g. 
/tmp/...
on Unix, 
%TEMP%/...
on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.
This skill exposes multiple entry scripts: 
alibaba1688_image_search.py
, 
upload_image.py
. Pass 
--script scripts/<name>.py
to choose the one you need.
run
writes the full response to a file and emits only a schema preview + file path. 
read
projects specific fields, with 
--limit/--offset
for slicing and 
--format json|jsonl|csv|table
for output.
When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:
  • High field count per record, or fields you don't need
  • Batch/paginated results (multiple items per call)
  • Long-text fields (descriptions, reviews, HTML, time series)
  • Output reused across later steps rather than consumed immediately
For small, single-use responses, calling the main script directly is fine.
⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via 
read
.
<!-- /LF_LARGE_RESPONSE_BLOCK -->
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
为避免超出Agent上下文限制，请将响应持久化到磁盘并仅提取所需字段：
python scripts/response_io.py run --script scripts/alibaba1688_image_search.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # 或 --path "<JMESPath>"
请将
--out-dir
设置在任何Git工作区之外（例如Unix系统的
/tmp/...
，Windows系统的
%TEMP%/...
）。持久化的响应可能包含个人身份信息、定价或敏感认证数据——请勿提交到代码仓库。文件不会自动删除，任务完成后请清理。
该技能提供多个入口脚本：
alibaba1688_image_search.py
、
upload_image.py
。通过传递
--script scripts/<name>.py
选择所需脚本。
run
命令将完整响应写入文件，并仅输出模式预览+文件路径。
read
命令提取特定字段，可使用
--limit/--offset
进行切片，
--format json|jsonl|csv|table
设置输出格式。
何时优先使用此模式——根据响应特征判断，例如：
  • 每条记录字段数量多，或包含不需要的字段
  • 批量/分页结果（每次调用返回多个条目）
  • 长文本字段（描述、评论、HTML、时间序列）
  • 输出需在后续步骤中重复使用，而非立即消费
对于小型、单次使用的响应，直接调用主脚本即可。
⚠️ 预览是截断的模式+示例，并非完整数据。任何字段层面的决策必须通过
read
命令从持久化文件中读取。
<!-- /LF_LARGE_RESPONSE_BLOCK -->
如需更多优质专业的跨境电商技能，请访问 LinkFox Skills。