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

Legacy MCP endpoint

/api/skill-api/v1/mcp

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": {
      "searchType": 1,
      "pageIndex": 1,
      "pageSize": 10,
      "keyWord": "iPhone 15"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

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

Arguments

Name	Type	Required	Meaning
`keyWord`	`string`	optional	Search keyword (must be written in Simplified Chinese; maximum 50 characters) Example: iPhone 15
`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, comma-separated: free shipping, 7-day free return, or shipping insurance Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

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

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "searchType": 1,
  "pageIndex": 1,
  "pageSize": 10,
  "keyWord": "iPhone 15"
}

Example structuredContent

{
  "data": {
    "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"
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}