AliExpress
AliExpress Product Detail MCP
Collect public product details from an AliExpress product URL. Submit a supported HTTPS AliExpress product URL in url; this operation has no limit parameter. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to inspect the completed product details.
AliExpress Product Detail 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 A Product Detail Page
Prompt: Collect the public AliExpress product page at [product URL]. Once the task finishes, summarize only fields actually returned and identify missing details.
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 AliExpress /item/{id}.html URL. This tool has no limit parameter; supplier collection may fail or return no verified details.
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_product_detailhttps://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-product-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_product_detail",
"arguments": {
"url": "https://www.aliexpress.us/item/1005008144724922.html"
}
}
}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-product-detail-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 | AliExpress /item/{id}.html product URL. |
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 an AliExpress product page?
Suggested Steps
Submit a supported product URL, save the taskId, and query nexscope_aliexpress_task_result. Use the returned status and result to describe only observed page details.
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.us/item/1005008144724922.html"
}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": []
}
],
"discovered": [],
"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-product-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_product_detail",
"arguments": {
"url": "https://www.aliexpress.us/item/1005008144724922.html"
}
}
}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.