AliExpress
AliExpress Category Discovery MCP
Discover products from a public AliExpress category navigation URL. Submit a supported category navigation URL in url and optionally set limit (1–100, default 20) to bound the returned products. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key for the completed discovery results.
AliExpress Category Discovery 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. Discover Products In A Category
Prompt: Discover products from [AliExpress category URL], with at most [limit] product groups. List only products returned by the completed task.
2. Compare Observed Category Results
Prompt: Run category discovery separately for [first category URL] and [second category URL]. Compare the returned product records only; do not treat either result as a complete category inventory.
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 navigation URL. The optional limit is 1–100; supplier parsing may fail or return incomplete observations.
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_productshttps://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-products-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_products",
"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-products-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 discover products from an AliExpress category?
Suggested Steps
Submit the category URL once, save the taskId, then query nexscope_aliexpress_task_result. Treat the returned records as observed results rather than a full category inventory.
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": [],
"discovered": [
{
"url": "https://www.aliexpress.us/item/1005008144724922.html",
"allVariations": null
}
],
"variantCoverage": "NOT_REQUESTED",
"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-products-example",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_category_products",
"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.