# Yiwugo B2B Wholesale & MOQ Pricing Scraper (`capitalist_developer/yiwugo-wholesale-moq-scraper`) Actor

High-speed Yiwugo B2B scraper extracting wholesale MOQ tiered pricing brackets, supplier booths, and SKU catalog data for Amazon FBA and dropshippers with Streamable MCP server.

- **URL**: https://apify.com/capitalist_developer/yiwugo-wholesale-moq-scraper.md
- **Developed by:** [Harsh](https://apify.com/capitalist_developer) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 wholesale sku delivereds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Yiwugo B2B Wholesale & MOQ Pricing Scraper

High-speed Yiwugo B2B market intelligence scraper and Model Context Protocol (MCP) server that extracts wholesale catalog data, complete **MOQ tiered-pricing brackets (ladder pricing)**, supplier booth locations, and direct factory contacts across 75,000+ suppliers in China's Yiwu International Trade Mart.

***

### ⚡ The Sourcing Advantage: Direct-from-Source Factory Pricing

The **Yiwu International Trade Mart** (义乌国际商贸城) is the world's largest wholesale market for small commodities, consumer goods, jewelry, toys, accessories, and home decor. While Western sellers pay 3x–10x markups on middleman platforms, direct Yiwu suppliers offer unmatched factory-floor pricing and low Minimum Order Quantities (MOQs).

However, scraping Yiwugo catalog data has historically been difficult due to dynamic client-side rendering, multi-bracket ladder pricing, and fragmented vendor shop pages.

**Yiwugo Wholesale & MOQ Pricing Scraper solves this completely**:

- **Full MOQ Tiered-Pricing Brackets**: Extracts exact volume pricing tiers (e.g., `≥ 3 pcs: ¥5.80`, `≥ 24 pcs: ¥5.50`, `≥ 240 pcs: ¥5.20`).
- **Physical Booth Verification**: Captures supplier market district, floor, gate, and booth number (e.g., *Gate 14, 2nd Floor, International Trade Mart District 1*).
- **Dual-Mode Engine**: Operates as both a batch dataset scraper and an ultra-fast, live **Streamable HTTP MCP Server** for autonomous AI sourcing agents.

***

### 🚀 Key Use Cases

1. **Amazon FBA & TikTok Shop Sourcing**: Identify high-margin products with low factory MOQs (1–12 units) for fast test batches and private label manufacturing.
2. **Dropshipping & E-Commerce Margins**: Calculate accurate unit economics by analyzing true tiered cost curves instead of single retail sample prices.
3. **Physical Sourcing Agent Automation**: Export complete market maps with vendor booth numbers and direct phone/WeChat details before boots-on-the-ground market visits in Zhejiang.
4. **Autonomous AI Sourcing Agents**: Connect Claude, Cursor, ChatGPT, or Antigravity via MCP to ask: *"Find 10 trending stainless steel bracelet suppliers in Yiwu District 1 with MOQ under 20 and unit price under 10 CNY."*

***

### 🔌 Model Context Protocol (MCP) Integration

This Actor supports **Apify Standby Mode** as a Streamable HTTP MCP server, enabling AI agents to query live Yiwu wholesale data in real time.

#### Connect to Any MCP Client

Add the following MCP endpoint to your client configuration:

```text
https://mcp.apify.com/?tools=capitalist_developer/yiwugo-wholesale-moq-scraper
```

#### Claude Desktop Configuration (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "yiwugo-moq-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=capitalist_developer/yiwugo-wholesale-moq-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}
```

#### Available MCP Tool

- `search_wholesale_moq_products`: Search wholesale items with filters for `keywords`, `marketUrls`, `minMoq`, `maxPriceCny`, `includeProductDetails`, and `maxItems`.

***

### 📋 Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `keywords` | `array` | `["hair clip"]` | Search keywords to discover wholesale products (e.g. `["bracelet", "hair clip"]`). |
| `marketUrls` | `array` | `[]` | Direct Yiwugo search, market list, or product detail URLs. |
| `includeProductDetails` | `boolean` | `true` | When enabled, navigates product detail pages to extract complete multi-tier MOQ price tables and booth addresses. |
| `minMoq` | `integer` | *optional* | Filter out products with MOQ below this threshold. |
| `maxPriceCny` | `number` | *optional* | Filter out products with base unit price exceeding this amount in CNY. |
| `maxItems` | `integer` | `40` | Maximum number of wholesale products to collect. |
| `useApifyProxy` | `boolean` | `false` | Route requests through Apify residential/datacenter proxy pool. |

***

### 📦 Sample JSON Output

```json
{
  "productId": "933451843",
  "title": "european and american fashion hand-woven natural stone crystal alloy pendant bracelet multi-layer all-match bracelet bracelet",
  "basePriceCny": 5.2,
  "currency": "CNY",
  "minOrderQty": 3,
  "moqUnit": "piece",
  "priceTiers": [
    {
      "minQty": 3,
      "maxQty": 23,
      "unitPrice": 5.8
    },
    {
      "minQty": 24,
      "maxQty": 239,
      "unitPrice": 5.5
    },
    {
      "minQty": 240,
      "maxQty": null,
      "unitPrice": 5.2
    }
  ],
  "supplierName": "Zhejiang Yiwu Jing'an Jewelry Co., Ltd.",
  "supplierLocation": "5175, 8th St, 2nd Floor, Gate 14, International Trade Mart (District 1)",
  "shopUrl": "https://en.yiwugo.com/shopdetail/1/612214_1.html",
  "productUrl": "https://en.yiwugo.com/product/detail/933451843.html",
  "imageUrl": "http://img1.yiwugo.com/i004/2021/03/07/46/f5f1e669587d5f75cff27d5eaf0fa6eb.JPG"
}
```

***

### 💰 Pay-Per-Event Pricing Transparency

This Actor operates under transparent Pay-Per-Event billing:

- **Wholesale SKU Delivered (`wholesale-sku`)**: $0.005 per verified SKU with tiered MOQ pricing.
- **Live MCP Query (`mcp-lookup`)**: $0.01 per autonomous AI tool invocation.

***

### 🛡️ License & Support

Maintained by **Harsh** (<Harsh9575286717@gmail.com>). Distributed under the Apache 2.0 License.

# Actor input Schema

## `keywords` (type: `array`):

Keywords to search across Yiwugo (e.g. \['hair clip', 'bracelet']).

## `marketUrls` (type: `array`):

Direct g.yiwugo.com search, market list, or product URLs (optional).

## `includeProductDetails` (type: `boolean`):

Fetches product detail pages to extract full MOQ tiered-pricing brackets and supplier address.

## `minMoq` (type: `integer`):

Optional minimum MOQ threshold (e.g. 50).

## `maxPriceCny` (type: `number`):

Optional maximum unit price in CNY (e.g. 15.5).

## `maxItems` (type: `integer`):

Maximum number of wholesale products to collect.

## `useApifyProxy` (type: `boolean`):

Route requests through Apify Proxy.

## Actor input object example

```json
{
  "keywords": [
    "hair clip"
  ],
  "marketUrls": [],
  "includeProductDetails": true,
  "maxItems": 40,
  "useApifyProxy": false
}
```

# Actor output Schema

## `results` (type: `string`):

Clean table view of extracted products

# 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("capitalist_developer/yiwugo-wholesale-moq-scraper").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("capitalist_developer/yiwugo-wholesale-moq-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 capitalist_developer/yiwugo-wholesale-moq-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,capitalist_developer/yiwugo-wholesale-moq-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0oYSTEy0VDWpKvbxQ/builds/RyMaKXbrAr4fc9aZg/openapi.json