AliExpress
AliExpress Category Variants MCP
Collect observed product variants from a public AliExpress category navigation URL. Submit a supported category URL in url; limit (1–100, default 20) bounds product groups, and one product may return several variant rows. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to review the completed variant results.
AliExpress Category Variants 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. Inspect Observed Category Variants
Prompt: Collect observed variants from [AliExpress category URL], limiting discovery to [limit] product groups. Group returned variant rows by product where the result supports it, and flag missing variant information.
What You Need to Provide
Connect Nexscope MCP and check current pricing before submitting a task. Keep the returned task ID and query its result with the same account.
A task receipt is not a completed collection. Report only returned records and preserve empty, partial, failed, or uncertain states.
Provide a supported category URL. Limit bounds product groups, not variant rows; the supplier may return incomplete or failed results.
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_aliexpress_category_variantshttps://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": "aliexpress-category-variants-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_variants",
"arguments": {
"limit": 1,
"url": "https://www.aliexpress.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en"
}
}
}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.
Asynchronous task workflow
- 1. Create once
Keep the returned taskId.
- 2. Query with backoff
Use nexscope_aliexpress_task_result to check the returned taskId with gradual backoff. Follow the actual task status and do not resubmit the paid request.
- 3. Use final result
Stop at success, failure, or timeout.
{
"jsonrpc": "2.0",
"id": "aliexpress-category-variants-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_task_result",
"arguments": {
"taskId": "TASK_ID_FROM_THE_SUBMISSION_RESULT"
}
}
}Arguments
| Name | Type | Required | Description |
|---|---|---|---|
url | string | required | Supported AliExpress category navigation URL. |
limit | integer | optional | Maximum result count. |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | optional | 0 means the tool call succeeded; nonzero is a Nexscope error. |
cost | integer | optional | Cost value used by this API operation. |
data | object | null | optional | Data value used by this API operation. |
data.error | string | null | optional | Error value used by this API operation. |
data.result | any | optional | Provider result when available; null while pending or when no verified result exists. |
data.status | string | required | The current task state; a successful tool call does not mean collection has finished. |
data.taskId | string | required | Use this identifier with the corresponding AliExpress MCP task result tool. |
data.usage | object | required | Usage value used by this API operation. |
data.usage.billingStatus | string | optional | Billing status value used by this API operation. |
data.usage.chargedCredits | integer | optional | Charged credits value used by this API operation. |
msg | string | null | optional | Msg value used by this API operation. |
time | string | optional | Time value used by this API operation. |
traceId | string | null | optional | Trace id value used by this API operation. |
ts | integer | optional | Ts value used by this API operation. |
Workflow Guide
Workflow example, not a verified API response.
Your Goal
How do I inspect observed variants from a category?
Suggested Steps
Submit the category URL and optional group limit, then query nexscope_aliexpress_task_result with the taskId. Describe only variant rows present in the result.
About this sample: This is a submission and result-query workflow, not a verified supplier response. A paid call may finish empty, partially, or with an error; check the actual task state and usage.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"url": "https://www.aliexpress.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en",
"limit": 1
}Response
{
"code": 0,
"data": {
"status": "SUCCEEDED",
"result": {
"items": [
{
"url": "https://www.aliexpress.us/item/1005008144724922.html",
"productId": "1005008144724922",
"title": "2/4/6pcs Magic Light Up Finger Fingers LED Tricks Thumb Props Christmas Christmas Festival Party Novelty Funny Toys",
"images": [
"https://ae-pic-a1.aliexpress-media.com/kf/Sa439ab62453846ae80fba37076c84b51M.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S48f97daf874247d0897b88a1a40f58f0j.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sdf53f7d712f547d5b822367008e7f363I.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S31e298126e5a47288b26b28194a413b6z.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6eac4e4e1f1e4aba88943cc47ae292106.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6a36082e9be04090b865a1506bcfafacO.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A216becd3745b46509fd9ed12b2961769W.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A1c7f6838675449b9a1c0a8947e3988d7n.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A7dc6b7e4322243edbdf73237dcbbf02eH.jpg"
],
"price": null,
"currency": null,
"collectedAt": null,
"missingFields": [
"price",
"currency",
"collectedAt",
"completeSkuMatrix"
],
"variantId": "14-366",
"availability": "in_stock",
"listingHasVariations": true,
"variantAttributes": [
{
"name": "Color",
"value": "4Pcs"
}
],
"priceType": null,
"variantGroups": [
{
"type": "Color",
"options": [
{
"id": "14-366",
"name": "4Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-29",
"name": "2Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-193",
"name": "6Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg_220x220q75.jpg_.avif"
}
]
}
]
},
{
"url": "https://www.aliexpress.us/item/1005008144724922.html",
"productId": "1005008144724922",
"title": "2/4/6pcs Magic Light Up Finger Fingers LED Tricks Thumb Props Christmas Christmas Festival Party Novelty Funny Toys",
"images": [
"https://ae-pic-a1.aliexpress-media.com/kf/Sa439ab62453846ae80fba37076c84b51M.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S48f97daf874247d0897b88a1a40f58f0j.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sdf53f7d712f547d5b822367008e7f363I.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S31e298126e5a47288b26b28194a413b6z.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6eac4e4e1f1e4aba88943cc47ae292106.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6a36082e9be04090b865a1506bcfafacO.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A216becd3745b46509fd9ed12b2961769W.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A1c7f6838675449b9a1c0a8947e3988d7n.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A7dc6b7e4322243edbdf73237dcbbf02eH.jpg"
],
"price": null,
"currency": null,
"collectedAt": null,
"missingFields": [
"price",
"currency",
"collectedAt",
"completeSkuMatrix"
],
"variantId": "14-193",
"availability": "in_stock",
"listingHasVariations": true,
"variantAttributes": [
{
"name": "Color",
"value": "6Pcs"
}
],
"priceType": null,
"variantGroups": [
{
"type": "Color",
"options": [
{
"id": "14-366",
"name": "4Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-29",
"name": "2Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-193",
"name": "6Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg_220x220q75.jpg_.avif"
}
]
}
]
},
{
"url": "https://www.aliexpress.us/item/1005008144724922.html",
"productId": "1005008144724922",
"title": "2/4/6pcs Magic Light Up Finger Fingers LED Tricks Thumb Props Christmas Christmas Festival Party Novelty Funny Toys",
"images": [
"https://ae-pic-a1.aliexpress-media.com/kf/Sa439ab62453846ae80fba37076c84b51M.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S48f97daf874247d0897b88a1a40f58f0j.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sdf53f7d712f547d5b822367008e7f363I.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S31e298126e5a47288b26b28194a413b6z.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6eac4e4e1f1e4aba88943cc47ae292106.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S6a36082e9be04090b865a1506bcfafacO.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A216becd3745b46509fd9ed12b2961769W.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A1c7f6838675449b9a1c0a8947e3988d7n.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/A7dc6b7e4322243edbdf73237dcbbf02eH.jpg"
],
"price": null,
"currency": null,
"collectedAt": null,
"missingFields": [
"price",
"currency",
"collectedAt",
"completeSkuMatrix"
],
"variantId": "14-29",
"availability": "in_stock",
"listingHasVariations": true,
"variantAttributes": [
{
"name": "Color",
"value": "2Pcs"
}
],
"priceType": null,
"variantGroups": [
{
"type": "Color",
"options": [
{
"id": "14-366",
"name": "4Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S96870a3d50c145af9f509cc2963f2ffaA.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-29",
"name": "2Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sb53a28e2f2db40459b8f12a0e36c8eceN.jpg_220x220q75.jpg_.avif"
},
{
"id": "14-193",
"name": "6Pcs",
"price": null,
"inStock": null,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc0194804cf2f46a39104a3172ef14927e.jpg_220x220q75.jpg_.avif"
}
]
}
]
}
],
"discovered": [],
"variantCoverage": "ALL_REQUESTED_UNVERIFIED",
"limitReached": true,
"errorRecords": 0
}
}
}View the MCP Request & Response Format
Examples
Workflow example, not a verified API response.
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": "aliexpress-category-variants-example",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_variants",
"arguments": {
"limit": 1,
"url": "https://www.aliexpress.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en"
}
}
}MCP Response Format
This workflow does not claim an API result. No verified response example is available; refer to Parameters & Response for the documented response structure.