AliExpress
AliExpress Keyword Search MCP
Search public AliExpress product listings by keyword. Send a keyword of up to 120 normalized characters; use pageNum (1–20) and limit (1–100) to bound the search. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to retrieve the completed product results.
AliExpress Keyword Search 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. Find Product Listings By Keyword
Prompt: Search AliExpress listings for [keyword]. Show the returned products and their available details after the task finishes; flag an empty or failed result.
2. Review A Later Search Page
Prompt: Search page [page number] of AliExpress listings for [keyword], with at most [limit] results. Compare only the records returned from this page with any earlier page I provide.
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 keyword. Page number is 1–20 and the result limit is 1–100. Search coverage is not guaranteed to be complete.
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_searchhttps://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-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_product_search",
"arguments": {
"keyword": "wireless earbuds",
"limit": 1,
"pageNum": 1
}
}
}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-search-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_task_result",
"arguments": {
"taskId": "TASK_ID_FROM_THE_SUBMISSION_RESULT"
}
}
}Arguments
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | required | The normalized keyword must be at most 120 characters. |
pageNum | integer | optional | Page number. |
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 search AliExpress listings for a keyword?
Suggested Steps
Submit the keyword search once, keep its taskId, then call nexscope_aliexpress_task_result with that taskId. Wait for a terminal status before summarizing returned product records.
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
{
"keyword": "wireless earbuds",
"pageNum": 1,
"limit": 1
}Response
{
"code": 0,
"msg": null,
"data": {
"taskId": "EXAMPLE_TASK_ID",
"status": "SUCCEEDED",
"result": {
"items": [
{
"url": "https://www.aliexpress.com/item/3256811621288203.html",
"price": null,
"title": "2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate Monitoring, Active Noise Cancellation Headphones, Waterproof for Daily Use, For IPhone IOS Smartphone, Gaming /Sports /Fitness Earphones.",
"images": [],
"currency": null,
"priceType": null,
"productId": "3256811621288203",
"variantId": null,
"collectedAt": null,
"availability": null,
"missingFields": [
"images",
"collectedAt",
"variantId",
"availability",
"completeSkuMatrix",
"price",
"currency"
],
"variantAttributes": [],
"listingHasVariations": null,
"variantGroups": []
}
],
"discovered": [],
"retrievedAt": "1793687830552",
"errorRecords": 0,
"limitReached": true,
"variantCoverage": "NOT_REQUESTED"
},
"usage": {
"billingStatus": "CHARGED",
"chargedCredits": "10"
},
"error": null
}
}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-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_aliexpress_product_search",
"arguments": {
"keyword": "wireless earbuds",
"limit": 1,
"pageNum": 1
}
}
}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.