1688 Sourcing

1688 Search By Image MCP Tool

Perform image-based product search on the 1688 platform. Use an image URL to find visually similar supplier products, returning title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity.

MCP tool name

nexscope_1688_search_by_image

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/1688-search-by-image/run

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "1688-search-by-image-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_1688_search_by_image",
    "arguments": {
      "pageSize": 10,
      "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",
      "page": 1
    }
  }
}

REST API equivalent

POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/1688-search-by-image/run

Canonical detail URL

https://www.nexscope.ai/mcp-map/1688-search-by-image

Arguments

Name	Type	Required	Meaning
`imageUrl`	`string`	optional	图片URL地址，请确保图片URL有效且可公开访问。最大长度：1000。仅支持 png/jpg/jpeg 格式，不支持 webp/gif 等。imageUrl/imageBase64/imageId 三选一必填 Example: https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg
`imageBase64`	`string`	optional	图片 Base64 编码字符串，为纯编码内容，不包含 data:image/jpeg;base64, 前缀。仅支持 png/jpg/jpeg 格式（imageUrl为空时使用） Example: {}
`imageId`	`string`	optional	图片ID（1688图片ID），以图搜图查询结果中也会返回，建议当分页 page>1 查询时带 imageId，加快响应速度 Example: {}
`page`	`integer`	optional	页码，从1开始 Example: 1
`pageSize`	`integer`	optional	每页返回的商品数量，最大不超过50 Example: 10
`priceStart`	`string`	optional	价格筛选起始值（人民币），如 10 Example: {}
`priceEnd`	`string`	optional	价格筛选结束值（人民币），如 100 Example: {}
`filter`	`string`	optional	过滤条件，多个条件用逗号分隔。有效值见下方「支持的过滤条件」 Example: {}
`sort`	`string`	optional	排序条件，JSON格式 {排序字段: 排序方式}。有效字段：price、rePurchaseRate、monthSold；方式：asc/desc Example: {}
`keyword`	`string`	optional	关键词，在结果中搜索 Example: phone case
`productCollectionId`	`string`	optional	货盘ID，单选。有效值见下方「支持的货盘ID」 Example: example-id

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Meaning
`imageId`	`string`	optional	上传后的图片ID（分页查询时回传可加速） Example: example-id
`total`	`integer`	optional	本页商品数量 Example: 1
`totalPage`	`integer`	optional	总页数 Example: 1
`sourceType`	`string`	optional	来源类型（固定值 "1688"） Example: {}
`type`	`string`	optional	渲染样式（固定值 "productWorkbenches"） Example: {}
`columns`	`array`	optional	渲染列定义 Example: []
`costToken`	`integer`	optional	消耗 token Example: 1
`products`	`array`	optional	商品列表（详见下方商品字段） Example: []
`offerId`	`string`	optional	商品ID Example: example-id
`asin`	`string`	optional	商品编号（同 offerId） Example: B072MQ5BRX
`imageUrl`	`string`	optional	商品图片 Example: https://example.com/image.jpg
`title`	`string`	optional	商品标题 Example: {}
`price`	`number`	optional	批发价（元） Example: 1
`consignPrice`	`number`	optional	一件代发价（元） Example: 1
`salesQuantity`	`integer`	optional	月销售件数 Example: 1
`estimatedSalesAmount`	`number`	optional	预估销售额 Example: 1
`asinUrl`	`string`	optional	商品链接 Example: B072MQ5BRX
`products[].isOnePsale`	`string`	optional	是否一件代发（是/否） Example: {}
`products[].isJxhy`	`string`	optional	是否精选货源（是/否） Example: {}
`products[].sellerIdentities`	`string`	optional	商家身份（超级工厂/实力商家/诚信通会员） Example: {}
`products[].offerIdentities`	`string`	optional	商品标（严选） Example: {}
`products[].repurchaseRate`	`string`	optional	复购率 Example: {}
`products[].tradeScore`	`string`	optional	商品交易评分 Example: {}
`products[].compositeServiceScore`	`string`	optional	综合服务体验分 Example: {}
`products[].sendGoodsAddressText`	`string`	optional	发货地 Example: {}
`products[].deliveryTime`	`string`	optional	发货时间（24/48小时） Example: {}
`quantityBegin`	`integer`	optional	起批量 Example: 1
`products[].hasPromotion`	`string`	optional	是否有营销活动（是/否） Example: {}
`products[].promotionType`	`string`	optional	营销类型 Example: {}
`products[].isPatentProduct`	`string`	optional	是否专利商品（是/否） Example: {}
`products[].isSelect`	`string`	optional	跨境select货盘标识 Example: {}
`products[].currency`	`string`	optional	币种（固定值 "¥"） Example: {}
`sourceTool`	`string`	optional	来源工具（固定值 "1688以图搜图"） Example: {}
`products[].dataType`	`string`	optional	数据类型（固定值 "monthlyData"） Example: {}
`errcode`	`integer`	optional	Upstream status code returned by the provider. Example: {}
`errmsg`	`string`	optional	Upstream status message returned by the provider. Example: {}
`code`	`string`	optional	Provider-specific status code. Example: {}
`msg`	`string`	optional	Provider-specific status message. Example: {}
`message`	`string`	optional	Provider-specific message. Example: {}
`costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: {}
`page`	`integer`	optional	Current page returned by the upstream provider. Example: {}
`pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: {}
`pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: {}
`dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: {}

Examples

Example arguments

{
  "pageSize": 10,
  "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",
  "page": 1
}

Example structuredContent

{
  "imageId": "example-id",
  "total": 1,
  "totalPage": 1,
  "columns": [],
  "costToken": 1,
  "products": [],
  "offerId": "example-id",
  "asin": "B072MQ5BRX",
  "imageUrl": "https://example.com/image.jpg",
  "price": 1,
  "consignPrice": 1,
  "salesQuantity": 1,
  "estimatedSalesAmount": 1,
  "asinUrl": "B072MQ5BRX",
  "quantityBegin": 1
}