New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →
GET/api/v2/aliexpress-products/

AliExpress Products Scraper MCP Server

Give Claude, Cursor and ChatGPT a tool for any public AliExpress page of products. One command connects it; every call returns typed JSON. 1 credit per page of products.

Free API key · 1 credit per page of products · failed calls free

Last updated
Live agent run
Copy for your AI agent
Install

Connect in one command

Quick answerScrapier's MCP server gives Claude, Cursor and any MCP client tools for public AliExpress pages of products, returned as JSON. One command connects it. Each call costs 1 credit.
terminal
claude mcp add -t http scrapier \
  https://mcp.scrapier.io/mcp \
  --header "X-API-Key: YOUR_API_KEY"
Then ask: "Get the AliExpress page of products for wireless earbuds"
Connect

Custom connector

Connect any client that supports remote MCP with one URL and your API key.

Custom connector

Any MCP client

Paste one URL into any client that supports remote MCP and send your Scrapier API key in an X-API-Key header.

https://mcp.scrapier.io/mcp
Where to paste it
  • ClaudeSettings → Connectors → Add
  • ChatGPTSettings → Apps → Developer mode → Create
  • CursorSettings → MCP → Add new server
Step-by-step setup ↓
Setup

Setup in Claude, Cursor, Windsurf and ChatGPT

Pick your client. Three steps, under a minute.

  1. Get a free API key from your Scrapier dashboard.
  2. Run the command below in your terminal.
  3. Restart Claude Code and run /mcp to see the tools.
terminal
claude mcp add -t http scrapier https://mcp.scrapier.io/mcp --header "X-API-Key: YOUR_API_KEY"
claude · ~/project
› /mcp
Manage MCP servers
● scrapier · connected · 6 tools
└ search_endpoints
└ run_scrape
└ …4 more
›

Verify the connection

Ask "List your AliExpress tools". The agent should find run_scrape and search_endpoints.

Tools

AliExpress MCP Tools

Use search_endpoints to discover, run_scrape to call.

ToolReturnsInputsKey fieldsCredits
run_scrapeRun the page of products scraperendpoint="aliexpress-products", queries="..."productId, title, productUrl, searchQuery, priceCurrent1

Output fields

run_scrape · 200 OK
{
  "success": true,
  "data": {
    "url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html",
    "page": 1,
    "page_size": 60,
    "products": [
      {
        "productId": "1005006789012345",
        "title": "Wireless Earbuds Bluetooth 5.3 Noise Cancelling TWS Headphones",
        "productUrl": "https://www.aliexpress.us/item/1005006789012345.html",
        "searchQuery": "wireless earbuds",
        "priceCurrent": "US $12.99",
        "priceCurrency": "$",
        "ratingValue": 4.8,
        "reviewCount": 1240,
        "soldCount": 5000,
        "soldDescription": "5,000+ sold",
        "tags": "Bulk deal",
        "scrapedAt": "2026-06-18T12:00:00.000Z",
        "reviewsEnriched": true,
        "position": 1
      }
    ],
    "next_cursor": "zc1.eNpjYGBg...",
    "timing": {
      "total_s": 11.8,
      "search_pages_s": [
        4.1
      ],
      "enrich_s": 7.2
    },
    "enrichment": {
      "requested": 60,
      "enriched": 60
    }
  }
}
Examples

Example Prompts and Tool Calls

The prompt, the tool call, the JSON and the answer.

Get page of products data

Get the page of products data for wireless earbuds.
⚙ run_scrape(endpoint="aliexpress-products", queries="wireless earbuds")
run_scrape(endpoint="aliexpress-products", queries="wireless earbuds")
{
  "productId": "1005006789012345",
  "title": "Wireless Earbuds Bluetooth 5.3 Noise Cancelling TWS Headphones",
  "productUrl": "https://www.aliexpress.us/item/1005006789012345.html",
  "searchQuery": "wireless earbuds"
}
Here are the page of products details from the Scrapier API.
Workflows

Agent Workflows

AliExpress data pipeline

  1. input list
  2. run_scrape
  3. filter results
  4. export

Feed a list, pull each page of products, filter by criteria, export the result.

Compare

AliExpress Scraper MCP vs the Official AliExpress MCP

Scrapier AliExpress MCPThis pageOfficial AliExpress APIApify actor over MCP
Data returnedAny public page of products, typed JSONYour own accounts and insightsVaries by actor
Auth neededOne Scrapier keyAliExpress app + business accountApify token
Cost model1 credit per callFree once approvedCompute units per run
Rate limits3 parallel per keyPer-user hourly quotaPer actor
Best forResearch, enrichment, monitoringOwn-account analyticsCustom one-off crawls

Limits

  • Public data only — private pages of products return identity fields only
  • Counts are live at call time; no history unless you store it
Billing

Credits, Rate Limits and Security

Credits per call1
Parallel requests3 per key
AuthOne Scrapier key, no AliExpress login
  • Your key stays in your client config, never in prompts
  • No AliExpress account or cookies are used
  • Failed calls cost 0 credits
  • Rotate or revoke keys any time from the dashboard

See full pricing →

Troubleshooting

Troubleshooting

Tools not showing

Restart the client after editing its config. In Claude Code run /mcp; in Cursor check the server toggle is on.

401 invalid key

The key is missing or mistyped. Copy it again from the dashboard.

429 rate limit

You exceeded your plan's parallel requests. The agent should wait for Retry-After.

Timeout on large requests

Batch in smaller groups, or raise the client timeout to 210 seconds.

FAQ

Frequently Asked Questions

Is there a AliExpress scraper MCP server?

Yes. Scrapier's MCP server exposes AliExpress page of products tools to Claude, Cursor, Windsurf and ChatGPT. One command connects it and every call returns typed JSON.

How do I scrape AliExpress pages of products with Claude?

Run <code>claude mcp add -t http scrapier https://mcp.scrapier.io/mcp</code> with your API key, then ask Claude for any public page of products. It calls <code>run_scrape</code> and reads the JSON directly.

Does it need a AliExpress login?

No. The server reads public data only and uses no AliExpress account or cookies.

How much does a AliExpress MCP call cost?

1 credit per call — about $1.58 per 1,000 pages of products on the Pro plan. Failed calls are free.

Can ChatGPT use the AliExpress scraper?

Yes. Add Scrapier as a custom connector in ChatGPT's developer mode and the same tools appear in chat.

Give your agent AliExpress data

1 tool · JSON · one key