1688 Procurement
1688 SKU MCP
Look up the available SKUs and purchasing options for a selected 1688 product. Requires an active 1688 authorization and your Nexscope API key.
1688 SKU AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Check Product Purchasing Options
Prompt: For 1688 product [OFFER_ID], list the returned SKUs, attributes, available quantities and prices. Keep missing values explicit before selecting a SKU for procurement.
2. Compare Available Variants
Prompt: For 1688 product [OFFER_ID], compare the returned SKU attributes, prices and amountOnSale values. Identify which returned variants meet my requested attributes [ATTRIBUTES] without assuming unreported stock or discounts.
What You Need to Provide
Replace bracketed values with your own identifiers and inputs. Use only your own ACTIVE, unexpired 1688 store authorization.
Read the returned business status and message. An HTTP or envelope success does not prove that an order or write operation succeeded.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_data_alibaba1688_skuhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "1688-sku-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_sku",
"arguments": {
"offerId": "1234567890123456789"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
offerId | string | required | Exact positive integer identifier. Send as a JSON string. Example: 1234567890123456789 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | optional | Nexscope transport/business envelope code; 0 means the request was processed. Inspect data for operation outcomes. |
cost | string | optional | Processing time in milliseconds, not credits. |
data | object | optional | Data value used by this API operation. |
data.offerId | string | optional | Exact positive integer identifier. Send as a JSON string. Pattern: ^[1-9][0-9]*$ |
data.skuList | array | optional | Sku list value used by this API operation. |
data.skuList[] | object | required | Item in data skuList. |
data.skuList[].amountOnSale | integer | optional | Amount on sale value used by this API operation. |
data.skuList[].attributes | array | optional | Attributes value used by this API operation. |
data.skuList[].attributes[] | object | required | Item in data skuList[] attributes. |
data.skuList[].price | number | optional | CNY; use orderPreview for final payable price. |
data.skuList[].skuId | string | optional | Exact positive integer identifier. Send as a JSON string. Pattern: ^[1-9][0-9]*$ |
data.skuList[].skuImageUrl | string | optional | Sku image url value used by this API operation. |
data.skuList[].specId | string | optional | Spec id value used by this API operation. |
msg | string | null | optional | Safe response message. |
time | string | optional | Server response time. |
traceId | string | null | optional | Request trace identifier. |
ts | string | optional | Server timestamp. |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
For 1688 product [OFFER_ID], list the returned SKUs, attributes, available quantities and prices. Keep missing values explicit before selecting a SKU for procurement.
Illustrative Response Explanation
The returned skuList describes available product variants, stock and purchasing options for the exact offerId. Use only returned values when choosing a SKU.
About this sample: This is an illustrative documentation example, not a live response from your account. Check the actual returned fields and status.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "1688-sku-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_sku",
"arguments": {
"offerId": "1234567890123456789"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "1688-sku-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"0\",\"data\":{\"offerId\":\"1234567890123456789\",\"skuList\":[{\"amountOnSale\":100,\"price\":4.2,\"skuId\":\"456789012345678901\",\"specId\":\"example-spec\"}]},\"msg\":null,\"time\":\"2026-10-20T00:00:00Z\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "0",
"data": {
"offerId": "1234567890123456789",
"skuList": [
{
"amountOnSale": 100,
"price": 4.2,
"skuId": "456789012345678901",
"specId": "example-spec"
}
]
},
"msg": null,
"time": "2026-10-20T00:00:00Z",
"traceId": null,
"ts": "0"
},
"isError": false
}
}