AliExpress

AliExpress Google Organic Search MCP

Retrieve structured Google organic search results for AliExpress research. Send a UUID requestId and keyword; pageNum (1–10) and limit (1–10) bound the result set. The response provides a taskId. Poll GET /aliexpress/accessTasks/{taskId} with the same Nexscope API key to retrieve the completed search results.

CostAt least 10 credits / callREST Online Test

AliExpress Google Organic 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. Research Google Organic Listings

Prompt: Search Google organic results for [keyword] in the AliExpress research workflow. List the returned links and descriptions without calling them verified AliExpress products.

2. Review A Later Google Page

Prompt: Review page [page number] of Google organic results for [keyword], limited to [limit] listings. Compare only the results returned from this page with those 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.

Supply a UUID requestId for idempotent submission, a keyword, page number 1–10, and limit 1–10. Use nexscope_aliexpress_access_task_result for this task.

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/json

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Using an API key? Get your key from API Access and include it in the Authorization header shown above.

Call this MCP tool

MCP tool name

nexscope_aliexpress_google_organic_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "aliexpress-google-organic-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_aliexpress_google_organic_search",
    "arguments": {
      "keyword": "wireless earbuds",
      "limit": 1,
      "pageNum": 1,
      "requestId": "11111111-1111-4111-8111-111111111111"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress 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_access_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-google-organic-search-result-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_aliexpress_access_task_result",
    "arguments": {
      "taskId": "TASK_ID_FROM_THE_SUBMISSION_RESULT"
    }
  }
}

Arguments

Name	Type	Required	Description
`requestId`	`string`	required	Client-generated UUID. Reuse it when retrying an uncertain submission.
`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.chargedCredits`	`integer`	optional	Charged credits value used by this API operation.
`data.usage.nexscopeBillingState`	`string`	optional	Nexscope billing state value used by this API operation.
`data.usage.observedBytes`	`integer`	optional	Observed bytes value used by this API operation.
`data.usage.supplierChargeState`	`string`	optional	Supplier charge state 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 research Google organic results for AliExpress?

Suggested Steps

Generate and retain a UUID requestId, submit the keyword, then query nexscope_aliexpress_access_task_result with the returned taskId. Treat links as Google results, not verified product matches.

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

{
  "requestId": "d55c91b1-7352-4e24-84cc-d7c248ce48e8",
  "keyword": "site:aliexpress.com phone case",
  "pageNum": 1,
  "limit": 3
}

Response

{
  "code": 0,
  "data": {
    "status": "SUCCEEDED",
    "result": {
      "serp": {
        "engine": "google",
        "items": [
          {
            "title": "AliExpress Business",
            "url": "https://inbusiness.aliexpress.com/",
            "snippet": "$64 OFF orders US $400+ Restocking … $10 OFF orders US $65+ CAD1114 Upcoming US $4 OFF orders US $25+. Free return Sourcing Festival. AliExpress Free ...",
            "rank": 1
          },
          {
            "title": "AliExpress – kupuj online produkty najwyższej jakości w ...",
            "url": "https://pl.aliexpress.com/",
            "snippet": "Pasja nie powinna kosztować fortuny. Na AliExpress złapiesz ponad 111 milionów cennych ofert online na modę, akcesoria, elektronikę, zabawki, narzędzia, ...",
            "rank": 2
          },
          {
            "title": "AliExpress - Compra online de Electrónica, Moda, Casa y ...",
            "url": "https://cl.aliexpress.com/",
            "snippet": "Con nuestro servicio de chino a domicilio, recibirás tu pedido de forma segura. Utiliza nuestro sistema de tracking para seguir tu bolsa de compras en todo ...",
            "rank": 3
          }
        ],
        "invalidItems": 0
      }
    }
  }
}

View the MCP Request & Response Format

Examples