1688 Sourcing

1688 Product Search MCP Tool

Search and analyze products on the Chinese 1688 wholesale platform (Alibaba domestic B2B market) for sourcing, supplier discovery, and product selection.

MCP tool name

nexscope_1688_product_search

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/1688-product-search/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-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_1688_product_search",
    "arguments": {
      "pageIndex": 1,
      "searchType": 1,
      "keyWord": "手机壳",
      "pageSize": 10
    }
  }
}

REST API equivalent

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

Canonical detail URL

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

Arguments

Name	Type	Required	Meaning
`keyWord`	`string`	optional	Search keyword (must be in Chinese, max 50 characters) Example: 手机壳
`goodsUrl`	`string`	optional	Product link URL (mutually exclusive with keyWord) Example: https://example.com/image.jpg
`productIds`	`string`	optional	Product IDs, comma-separated, max 20 Example: {}
`cycle`	`string`	optional	Statistical period: 7 (last 7 days) or 30 (last 30 days) Example: {}
`searchType`	`integer`	optional	Search type: 1 = fuzzy match, 3 = exact match Example: 1
`sortField`	`string`	optional	Sort field: orderCount7d, saleCount7d, saleVolume7d, orderCount30d, saleCount30d, saleVolume30d, offerCreateTime, price, consignPrice Example: {}
`sortType`	`string`	optional	Sort order: desc (descending), asc (ascending) Example: {}
`pageIndex`	`integer`	optional	Page number (starting from 1) Example: 1
`pageSize`	`integer`	optional	Results per page (10-100) Example: 10
`beginPrice`	`number`	optional	Wholesale price (start) Example: 1
`endPrice`	`number`	optional	Wholesale price (end) Example: 1
`beginConsignPrice`	`number`	optional	Dropship price (start) Example: 1
`endConsignPrice`	`number`	optional	Dropship price (end) Example: 1
`beginOrderCount`	`integer`	optional	Order count (start) Example: 1
`endOrderCount`	`integer`	optional	Order count (end) Example: 1
`beginSaleCount`	`integer`	optional	Units sold (start) Example: 1
`endSaleCount`	`integer`	optional	Units sold (end) Example: 1
`beginSaleVolume`	`number`	optional	Sales amount (start) Example: 1
`endSaleVolume`	`number`	optional	Sales amount (end) Example: 1
`beginStartQuantity`	`integer`	optional	Minimum purchase quantity (start) Example: 1
`endStartQuantity`	`integer`	optional	Minimum purchase quantity (end) Example: 1
`beginTpYear`	`integer`	optional	TrustPass years (start) Example: 1
`endTpYear`	`integer`	optional	TrustPass years (end) Example: 1
`beginOfferCreateTime`	`string`	optional	Listing time start (format: YYYY-MM-DD) Example: {}
`endOfferCreateTime`	`string`	optional	Listing time end (format: YYYY-MM-DD) Example: {}
`companyType`	`integer`	optional	Company type: 0 = no limit, 1 = store, 2 = factory Example: 1
`offerType`	`integer`	optional	Product tag: 0 = no limit, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customization supported, 6 = store highlight Example: 1
`shiLiType`	`string`	optional	Seller type (multi-select, comma-separated): superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass) Example: {}
`sendTime`	`string`	optional	Delivery time (multi-select, comma-separated): 24, 48, 72 Example: {}
`faceToFaceSupport`	`string`	optional	Waybill support (multi-select, comma-separated): 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou) Example: {}
`proxyRights`	`string`	optional	Dropship rights (multi-select, comma-separated): 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later) Example: {}
`shopService`	`string`	optional	Seller services (multi-select, comma-separated): 4057409 (Safe Buy), 888777 (Deep Verification Report) Example: {}
`buyerProtections`	`string`	optional	Buyer protections (multi-select, comma-separated): 商品包邮 (free shipping), 7天包退货 (7-day free return), 支持运费险 (shipping insurance supported) Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Meaning
`total`	`integer`	optional	Total record count Example: 1
`type`	`string`	optional	Render style Example: {}
`columns`	`array`	optional	Render column definitions Example: []
`products`	`array`	optional	Product list (see fields below) Example: []
`products[].offerId`	`string`	optional	Product ID Example: example-id
`products[].asin`	`string`	optional	Product number Example: B072MQ5BRX
`products[].title`	`string`	optional	Product title Example: {}
`products[].asinUrl`	`string`	optional	Product link URL Example: B072MQ5BRX
`products[].imageUrl`	`string`	optional	Product image URL Example: https://example.com/image.jpg
`products[].price`	`number`	optional	Wholesale price Example: 1
`products[].consignPrice`	`number`	optional	Dropship price Example: 1
`products[].quantityPrices`	`string`	optional	Price range Example: {}
`products[].quantityBegin`	`integer`	optional	Minimum order quantity Example: 1
`products[].unit`	`string`	optional	Unit Example: {}
`products[].currency`	`string`	optional	Currency Example: {}
`products[].salesOrderCount`	`integer`	optional	Order count (by statistical period) Example: 1
`products[].salesQuantity`	`integer`	optional	Units sold (by statistical period) Example: 1
`products[].estimatedSalesAmount`	`integer`	optional	Estimated sales amount (by statistical period) Example: 1
`products[].deliveryTime`	`string`	optional	Delivery time Example: {}
`products[].availableDate`	`string`	optional	Product listing time Example: 2026-01-01
`products[].levelName`	`string`	optional	Category hierarchy name Example: {}
`products[].company`	`string`	optional	Store name Example: {}
`products[].shopId`	`string`	optional	Store ID Example: example-id
`products[].shopUrl`	`string`	optional	Store link URL Example: https://example.com/image.jpg
`products[].dataType`	`string`	optional	Data type: weeklyData (weekly data), monthlyData (monthly data) Example: {}
`products[].sourceType`	`string`	optional	Source platform (1688) Example: {}
`products[].sourceTool`	`string`	optional	Source tool 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: {}
`title`	`string`	optional	Provider-specific response title. Example: {}
`sourceType`	`string`	optional	Provider-specific source platform type. Example: {}
`sourceTool`	`string`	optional	Provider-specific source tool name. Example: {}
`costToken`	`integer`	optional	Token cost reported by the upstream provider. 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: {}
`totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: {}
`dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: {}

Examples

Example arguments

{
  "pageIndex": 1,
  "searchType": 1,
  "keyWord": "手机壳",
  "pageSize": 10
}

Example structuredContent

{
  "total": 1,
  "columns": [],
  "products": [
    {
      "offerId": "example-id",
      "asin": "B072MQ5BRX",
      "asinUrl": "B072MQ5BRX",
      "imageUrl": "https://example.com/image.jpg",
      "price": 1,
      "consignPrice": 1,
      "quantityBegin": 1,
      "salesOrderCount": 1,
      "salesQuantity": 1,
      "estimatedSalesAmount": 1,
      "availableDate": "2026-01-01",
      "shopId": "example-id",
      "shopUrl": "https://example.com/image.jpg"
    }
  ]
}