# Temu MCP Server (`axlymxp/temu-mcp-server`) Actor

Give AI agents live access to Temu. This MCP server exposes tools to search products, fetch full product detail and browse the product feed — with price, images and sales — from Claude, Cursor, ChatGPT or n8n. Also runs as a classic scraper. Pay per tool call.

- **URL**: https://apify.com/axlymxp/temu-mcp-server.md
- **Developed by:** [axly](https://apify.com/axlymxp) (community)
- **Categories:** E-commerce, Developer tools, AI
- **Stats:** 5 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event + usage

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Temu MCP Server

Give your **AI assistant live access to Temu**. This Actor runs as a
**Model Context Protocol (MCP) server** so agents like **Claude, Cursor,
ChatGPT and n8n** can search Temu, fetch product detail and browse the product
feed in real time — and it also works as a classic one-shot scraper.

### Tools exposed to AI agents

| Tool | What it does |
| ---- | ------------ |
| `temu_product_feed` | Products from Temu's homepage/recommendation feed — title, price, market price, discount, image, sales, URL. Works without login. |
| `temu_search_products` | Keyword product search — same product fields, with sort options. Residential proxy recommended. |
| `temu_product_detail` | Full detail for a product ID/URL — price, images, SKU variants, seller, rating, reviews, description. Residential proxy recommended; falls back to SEO fields when gated. |

### Who uses this

- **AI builders & agent developers** — plug Temu product data into an assistant
  or workflow without writing a scraper or handling anti-bot.
- **Dropshippers & analysts** — ask your assistant to find products, compare
  prices and pull details conversationally.
- **No-code automations** — call the tools from n8n, Make or a custom agent.

### Connect your MCP client

1. Start this Actor in **Standby mode**.

2. Point your MCP client at the standby URL with the `/mcp` path (Streamable
   HTTP transport):

   ```
   <ACTOR_STANDBY_URL>/mcp
   ```

3. Example Claude Desktop / Cursor config:

   ```json
   {
       "mcpServers": {
           "temu": {
               "url": "https://<your-actor-standby-url>/mcp"
           }
       }
   }
   ```

Your agent will then see `temu_product_feed`, `temu_search_products` and
`temu_product_detail` as callable tools.

### Example agent prompts

- "Use Temu to find the 10 best-selling wireless earbuds and list their prices."
- "Get the full detail and variants for Temu product 601099651743804."
- "Show me 20 products from Temu's feed with their discounts."

### Classic scraper mode

Prefer a one-shot run? Provide input and the Actor pushes rows to a dataset:

```json
{ "mode": "search", "query": "wireless earbuds", "limit": 100 }
```

Modes: `feed` (default), `search` (needs `query`), `detail` (needs `goodsIds`).

### Output fields

Product rows include `goods_id`, `title`, `price`, `market_price`, `currency`,
`discount_text`, `sales_tip`, `image` and `url`. Detail results add `images`,
`skus`, `mall_name`, `rating`, `review_count` and `description`.

### FAQ

**Do I need a Temu account or cookies?** No — the server bootstraps its own
session automatically.

**Why are residential proxies recommended?** Temu gates keyword search and full
product detail from low-reputation IPs. Run with Apify residential proxies for
the best coverage; the product feed works without them.

**Which AI clients are supported?** Any MCP-compatible client — Claude Desktop,
Cursor, ChatGPT (MCP), n8n, and custom agents using the MCP SDK.

**How is it billed?** Per MCP tool call (plus a small start fee). See the Store
listing for current pricing.

# Actor input Schema

## `mode` (type: `string`):

What to scrape in classic run mode. Ignored in MCP standby mode.

## `query` (type: `string`):

Keyword to search when mode = search.

## `goodsIds` (type: `array`):

Temu product IDs or URLs when mode = detail.

## `limit` (type: `integer`):

Max products for feed/search mode.

## `sortBy` (type: `string`):

Result ordering when mode = search.

## `proxyConfiguration` (type: `object`):

Proxy settings. RESIDENTIAL proxies are strongly recommended for keyword search and full product detail.

## Actor input object example

```json
{
  "mode": "feed",
  "goodsIds": [],
  "limit": 40,
  "sortBy": "relevance",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("axlymxp/temu-mcp-server").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("axlymxp/temu-mcp-server").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call axlymxp/temu-mcp-server --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=axlymxp/temu-mcp-server",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/wnBrp2UxTFtdLgrXW/builds/kHYva7aiAR0hhjqwO/openapi.json