# 1688 Factory Matcher & TikTok Shop / Amazon Profit Scout (`aitruelabs/truemargin-1688-profit-scout`) Actor

Stop losing money on 'GMV Illusion'! Converts English product titles or TikTok Shop/Amazon URLs into authentic 1688 Chinese factory keywords, filters out middlemen, and calculates real landed USD Net Contribution Margin (after DDP freight, tariffs, affiliate cuts & refunds).

- **URL**: https://apify.com/aitruelabs/truemargin-1688-profit-scout.md
- **Developed by:** [ai labs](https://apify.com/aitruelabs) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

## TrueMargin: 1688 Primary Factory Matcher & TikTok Shop / Amazon Net-Margin Scout

**Stop bleeding cash to the "GMV Illusion."**\
Most cross-border sellers celebrate $50,000 in TikTok Shop or Shopify GMV—only to realize at month-end that **15% creator affiliate cuts, 6% referral fees, 14%+ impulse return rates (RTO), volumetric air-DDP freight, and 1688 middleman markups** quietly wiped out 100% of their profit.

**TrueMargin** bridges Western viral product research and Chinese primary factory sourcing in a single automated run:

1. **Native Chinese Industrial Term Translation**: Converts English product titles or TikTok Shop / Amazon / AliExpress URLs into authentic **1688 factory-floor keywords** (not literal Google Translate, which traps you on retail Taobao resellers) and pinpoints the exact manufacturing belt (*Shenzhen electronics, Yiwu hardware/plastics, Ningbo home appliances, Dongguan silicone/molds, Guangzhou beauty*).
2. **Anti-Middleman Factory Verification**: Scores and filters 1688/Alibaba supplier candidates by **B2B Repurchase Rate (`回头率 >= 20%`)**, operating years, `Super Factory / 实力商家` badges, and MOQ tiers.
3. **True Landed Contribution-Margin Audit**: Computes exact USD net profit per order across **TikTok Shop US**, **Shopify DTC**, and **Amazon FBA US**, outputting an unmistakable **`GO` / `CAUTION` / `KILL`** decision, Break-Even Ad ROAS, 3-second UGC video hooks, and a China 3PL pre-shipment QC checklist.

> **Prefer a No-Code Web Dashboard & 200-SKU Bulk CSV Uploader?**\
> Try the interactive web calculator & bulk CSV auditor instantly at **[truemargin.aitruelabs.com](https://truemargin.aitruelabs.com)** (maintained by [AI True Labs](https://aitruelabs.com)).

***

### Key Capabilities & Zero-Result Safety

- **Zero Empty-Run Waste**: Cleanly skips blank rows and only emits verified, schema-validated SKU audit records (`GO` / `CAUTION` / `KILL`).
- **Native GBK 1688 Search Links**: Generates direct `s.1688.com` manufacturer search URLs encoded in native GBK bytes (eliminating UTF-8 mojibake on 1688).
- **Sensitive Cargo Freight Accuracy**: Automatically distinguishes `GENERAL`, `BATTERY_MAGNETIC`, and `LIQUID_COSMETIC` tariff & air-packet surcharges across 3PL Direct Packet, Air DDP, and Sea DDP.

***

### Quick Start Input Example

```json
{
  "items": [
    "Magnetic POV Neck Phone Holder | 27.99 | 260g",
    "Portable Mini Thermal Pocket Printer | 24.99 | 210g",
    "Electric Gua Sha Heated Facial Massager | 34.99 | 180g"
  ],
  "salesChannel": "tiktok_shop_us",
  "shippingMode": "direct_packet_3pl",
  "creatorAffiliatePct": 15,
  "expectedRefundRatePct": 14,
  "adSpendCpaUsd": 3.5,
  "minFactoryRepurchaseRatePct": 20
}
```

#### Tip: Pipe-Delimited Fast Overrides

You can pass plain English titles (`"LED Flame Air Diffuser"`), marketplace URLs, or pipe-delimited overrides (`"Product Name | RetailUSD | WeightGrams | Optional1688CnyCost"`) to stress-test exact supplier quotes in bulk!

***

### Sample Output Record

```json
{
  "productQuery": "Magnetic POV Neck Phone Holder | 27.99 | 260g",
  "verdict": "GO",
  "chineseFactoryQuery": "磁吸挂脖手机支架 第一视角 源头工厂 私模",
  "industrialBelt": "Shenzhen / Dongguan (3C Magnetic & Silicone Mold Cluster)",
  "direct1688SearchUrl": "https://s.1688.com/selloffer/offer_search.htm?keywords=...",
  "retailPriceUsd": 27.99,
  "estimatedFactoryCostCny": 24.5,
  "landedCogsUsd": 7.42,
  "platformAndAffiliateFeesUsd": 8.71,
  "netProfitPerOrderUsd": 8.36,
  "netMarginPct": 29.87,
  "breakEvenRoas": 2.36,
  "verifiedFactories": [
    {
      "supplierName": "深圳市龙岗区某精密塑胶磁吸制品厂 (Verified Factory Profile)",
      "supplierType": "SOURCE_FACTORY",
      "repurchaseRatePct": 34.0,
      "yearsActive": 6,
      "moqUnits": 50,
      "unitPriceCny": 24.5
    }
  ],
  "viralAdHooks": [
    "POV Hook (0-3s): Show both hands busy cooking/unboxing while camera glides smoothly from chest level — 'Stop holding your phone with your chin.'",
    "3PL QC Check: Drop-test N52 neodymium magnet ring with 300g load + inspect gooseneck silicone seam tear resistance."
  ]
}
```

***

### AI Agents & MCP Integration (Claude Desktop / Cursor / n8n)

TrueMargin ships with a native **Model Context Protocol (MCP)** server (`mcp_server/truemargin_mcp.py`) so AI Ecommerce Agents can audit 1688 unit economics mid-conversation before launching ads or ordering inventory.

***

### Interactive Web App & Enterprise SaaS Access

- **Free Single-SKU Web Calculator & Bulk CSV Suite**: <https://truemargin.aitruelabs.com>
- **Maintained by**: [AI True Labs](https://aitruelabs.com) · Support: `support@aitruelabs.com`

# Actor input Schema

## `items` (type: `array`):

List of English product names (e.g. 'Magnetic Neck Phone Mount | 29.99 | 240g'), marketplace URLs, or product queries.

## `salesChannel` (type: `string`):

Platform fee & fulfillment model used to compute real Net Contribution Margin.

## `shippingMode` (type: `string`):

Determines landed per-unit freight & customs clearance cost.

## `creatorAffiliatePct` (type: `number`):

Creator commission rate (typically 10% - 20% on TikTok Shop).

## `expectedRefundRatePct` (type: `number`):

Realistic apparel/gadget return rate on impulse social commerce (typically 10% - 20%).

## `adSpendCpaUsd` (type: `number`):

Blended paid ad CPA + amortized free creator sample cost per order.

## `minFactoryRepurchaseRatePct` (type: `integer`):

Filters out Taobao middlemen by requiring repeat B2B buyer rate >= threshold.

## `usdCnyRate` (type: `number`):

FX rate used to convert 1688 RMB factory quotes into USD.

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

Optional Apify Proxy configuration for live marketplace scraping.

## Actor input object example

```json
{
  "items": [
    "Magnetic POV Neck Phone Holder | 27.99 | 260g",
    "Portable Mini Thermal Pocket Printer | 24.99 | 210g",
    "Electric Gua Sha Heated Facial Massager | 34.99 | 180g"
  ],
  "salesChannel": "tiktok_shop_us",
  "shippingMode": "direct_packet_3pl",
  "creatorAffiliatePct": 15,
  "expectedRefundRatePct": 14,
  "adSpendCpaUsd": 3.5,
  "minFactoryRepurchaseRatePct": 20,
  "usdCnyRate": 7.22,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

Audited SKU margin records, 1688 source-factory search links, and verified manufacturer candidates.

# 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 = {
    "items": [
        "Magnetic POV Neck Phone Holder | 27.99 | 260g",
        "Portable Mini Thermal Pocket Printer | 24.99 | 210g",
        "Electric Gua Sha Heated Facial Massager | 34.99 | 180g"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("aitruelabs/truemargin-1688-profit-scout").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 = {
    "items": [
        "Magnetic POV Neck Phone Holder | 27.99 | 260g",
        "Portable Mini Thermal Pocket Printer | 24.99 | 210g",
        "Electric Gua Sha Heated Facial Massager | 34.99 | 180g",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("aitruelabs/truemargin-1688-profit-scout").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 '{
  "items": [
    "Magnetic POV Neck Phone Holder | 27.99 | 260g",
    "Portable Mini Thermal Pocket Printer | 24.99 | 210g",
    "Electric Gua Sha Heated Facial Massager | 34.99 | 180g"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call aitruelabs/truemargin-1688-profit-scout --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aitruelabs/truemargin-1688-profit-scout"
        }
    }
}
```

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/3T4J5DWibL6LkUmmU/builds/0x33RckoJfwOYP8p0/openapi.json
