# Dsers Mcp Product

> An open-source MCP server to automate DSers product import, bulk edit variants, and push to Shopify/Wix/WooCommerce using AI. Supports AliExpress, Alibaba, 1688.

- **Type:** MCP server
- **Install:** `agentstack add mcp-oyaaiprod-dsers-mcp-product`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [OyaAIProd](https://agentstack.voostack.com/s/oyaaiprod)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [OyaAIProd](https://github.com/OyaAIProd)
- **Source:** https://github.com/OyaAIProd/dsers-mcp-product
- **Website:** https://dsers-mcp-product.vercel.app

## Install

```sh
agentstack add mcp-oyaaiprod-dsers-mcp-product
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# DSers MCP Product — Automate Dropshipping AI tools/AliExpress to Shopify & Wix Import

[](https://smithery.ai/server/@dsersx/product-mcp)
[](https://www.npmjs.com/package/@lofder/dsers-mcp-product)
[](https://registry.modelcontextprotocol.io/servers/io.github.lofder/dsers-mcp-product)
[](https://glama.ai/mcp/servers/lofder/dsers-mcp-product)

> An open-source MCP server to automate DSers product import, bulk edit variants, and push to Shopify or Wix using AI.

> [English](#english) | [中文](#中文)

---

## English

> **⚠️ Rapid iteration phase:** I only have limited DSers accounts and stores to test with, so it's hard to cover every edge case. I'm testing as many scenarios as I can, fixing issues as I find them — though fixes sometimes introduce new ones. Releases will be very frequent during this period. Please always use the latest version, and I'd really appreciate it if you could [help me test](https://github.com/lofder/dsers-mcp-product/issues)!

**DSers MCP Product** is an open-source [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that lets AI Agents automate the entire DSers import workflow — from AliExpress / Alibaba / [Accio.com](https://www.accio.com/) product URL to Shopify or Wix store listing. Bulk import, batch edit variants, clean AliExpress titles, apply pricing rules, and push to multiple stores — all with a single sentence to your AI agent.

#### What can it do?

- **One-click import** — paste a product link, your AI agent imports it into DSers automatically
- **Clean up titles** — strips the messy keyword-stuffed AliExpress titles into something readable
- **Pricing rules** — markup multiplier (e.g. 2.5x), fixed markup (e.g. +$5), compare-at / sale prices
- **Batch import** — import multiple products at once with a list of URLs
- **Multi-store push** — push one product to all your connected Shopify & Wix stores in one go
- **Safety checks** — automatically blocks pushes that would result in below-cost pricing, zero price, or zero stock
- **SEO optimization** — let AI rewrite the title and description for better search rankings before pushing

The server is hosted on [Vercel](https://dsers-mcp-product.vercel.app/api/mcp) and published across multiple platforms:

### Available On

| Platform | Link |
|----------|------|
| npm | [npmjs.com/package/@lofder/dsers-mcp-product](https://www.npmjs.com/package/@lofder/dsers-mcp-product) |
| MCP Registry (Official) | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/servers/io.github.lofder/dsers-mcp-product) |
| Smithery | [smithery.ai/server/@dsersx/product-mcp](https://smithery.ai/server/@dsersx/product-mcp) |
| Glama.ai | [glama.ai/mcp/servers/lofder/dsers-mcp-product](https://glama.ai/mcp/servers/lofder/dsers-mcp-product) |
| mcp.so | [mcp.so/server/dsers-mcp-product](https://mcp.so/server/dsers-mcp-product) |
| mcpservers.org | [mcpservers.org](https://mcpservers.org) |
| MCP Marketplace | [mcp-marketplace.io](https://mcp-marketplace.io/server/io-github-lofder-dsers-mcp-product) |
| awesome-mcp-servers | [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) |
| Dev.to | [Article: I Built an MCP Server to Automate Dropshipping](https://dev.to/_95a3e57463e6442feacd0/i-built-an-mcp-server-to-automate-dropshipping-product-imports-3m5b) |

### Supported product sources

Works with product links from **AliExpress**, **Alibaba.com**, and **[Accio.com](https://www.accio.com/)**. Just give your AI agent a product link from any of these platforms, and it will import the product into DSers and push it to your store. (1688.com links are also recognized but require your DSers account to have 1688 source authorization enabled.)

### Accio.com — AI-powered product sourcing

[Accio.com](https://www.accio.com/) is Alibaba's AI sourcing assistant. You describe what you're looking for (e.g. "wireless earbuds under $5"), and it searches AliExpress & Alibaba for you.

**How to use it with DSers MCP:**

1. Go to [accio.com](https://www.accio.com/) and search for products in natural language.
2. Browse the results. When you find a product you like, **click on it** to open the product detail panel.
3. **Copy the URL** from your browser address bar — it will look something like:
   `https://www.accio.com/c/xxx?productId=1005009871053792&ds=aliexpress.com`
4. Give that link to your AI agent, e.g.: *"Import this product and push to my store: [paste URL]"*
5. The agent handles the rest — no extra setup needed.

This works for both AliExpress and Alibaba products found on Accio.

### Documentation

| Document | Description |
|----------|-------------|
| [ARCHITECTURE.md](ARCHITECTURE.md) | Three-layer architecture, directory structure, data flow |
| [USAGE.md](USAGE.md) | Installation, client config (Cursor, Claude Desktop), scenario examples |
| [SKILL.md](SKILL.md) | AI agent instruction file — workflow, rules, push options, error handling |
| [SKILL-CN.md](SKILL-CN.md) | Chinese human-readable guide for SKILL.md |

### What You Need

- A [DSers](https://www.dsers.com/) account (free plan works)
- A Shopify or Wix store already connected in DSers
- An MCP-compatible AI client — [Cursor](https://cursor.sh/), [Claude Desktop](https://claude.ai/desktop), [Windsurf](https://codeium.com/windsurf), or any client that supports MCP

### Quick Start

**Step 1: Log in (one time — opens your browser)**

```bash
npx @lofder/dsers-mcp-product login
```

A browser window opens to the official DSers login page. You log in on DSers's own website — your password **never** passes through this tool. After login, the session is encrypted and saved locally.

**Step 2: Add to your MCP client (no credentials needed)**

```json
{
  "mcpServers": {
    "dsers-mcp-product": {
      "command": "npx",
      "args": ["-y", "@lofder/dsers-mcp-product"]
    }
  }
}
```

That's it. No passwords in config files.

Also listed on the official [MCP Registry](https://registry.modelcontextprotocol.io/servers/io.github.lofder/dsers-mcp-product).

### Authentication — Zero-Password Login

Your DSers password **never touches this tool**. Here's how login works:

1. You run `npx @lofder/dsers-mcp-product login`
2. Your browser opens the official DSers login page
3. You log in on DSers's own website, as usual
4. The tool picks up your login session and encrypts it locally
5. Done — from now on, the MCP server just works. No passwords in any config file.

Works with Chrome, Edge, Brave, and other Chromium browsers. On Mac, Safari works too.

**Sessions last about 6 hours.** When it expires, your AI agent will ask you to run `login` again — takes 10 seconds.

**Switching accounts?**

```bash
npx @lofder/dsers-mcp-product logout
npx @lofder/dsers-mcp-product login
```

> **For developers:** The server also accepts a `DSERS_TOKEN` env var for headless/CI environments. For most users, just use `login`.

### Usage Examples

Once set up, just talk to your AI agent in plain language:

> "Import this product and push to my Shopify store as a draft: https://www.aliexpress.com/item/1005006372921430.html"

> "Import this product, mark up the price by 2.5x, and push it: https://www.aliexpress.com/item/1005006372921430.html"

> "Batch import these 3 products and push them all to my store: [URL1] [URL2] [URL3]"

> "Push this product to all my connected stores"

> "Rewrite the title and description for SEO, then push to my store"

The agent figures out the right tools to call. You don't need to know tool names or parameters.

### Install via Smithery

```bash
npx @smithery/cli mcp add @dsersx/product-mcp --client cursor
```

Or browse at [smithery.ai/server/@dsersx/product-mcp](https://smithery.ai/server/@dsersx/product-mcp).

### Install from Source

```bash
# Clone
git clone https://github.com/lofder/dsers-mcp-product.git
cd dsers-mcp-product

# Install
npm install

# Configure (copy and fill in your DSers credentials)
cp .env.example .env

# Type check
npx tsc --noEmit

# Run with Smithery dev
npx @smithery/cli dev ./src/index.ts
```

### Project Structure

```
dsers-mcp-product/
├── src/
│   ├── index.ts              # MCP server entry — tool registration
│   ├── service.ts            # Import flow orchestration (7 operations)
│   ├── provider.ts           # DSers API adapter
│   ├── rules.ts              # Rule validation & application engine
│   ├── push-options.ts       # Push option normalization
│   ├── resolver.ts           # URL normalization (AliExpress/Alibaba/Accio)
│   ├── job-store.ts          # File-based job persistence
│   └── dsers/                # Low-level DSers API wrappers
│       ├── config.ts         # Configuration & environment
│       ├── auth.ts           # Login, session cache, auto-refresh
│       ├── client.ts         # Authenticated HTTP client
│       ├── account.ts        # Store & user management APIs
│       ├── product.ts        # Import list & push APIs
│       └── settings.ts       # Shipping, pricing, billing APIs
├── test/                     # Smoke tests
├── smithery.yaml             # Smithery runtime config
├── package.json
├── tsconfig.json
└── .env.example
```

### Nine Tools

| # | Tool | What it does |
|---|------|-------------|
| 1 | `dsers_store_discover` | See your connected stores, available shipping methods, pricing rules, and what rules you can apply |
| 2 | `dsers_rules_validate` | Test your pricing or title rules before applying — catches mistakes early |
| 3 | `dsers_product_import` | Paste a product URL, optionally apply pricing/title rules, and get a preview before pushing |
| 4 | `dsers_product_preview` | Review a product you already imported — title, price, variants, stock at a glance |
| 5 | `dsers_product_update_rules` | Edit pricing, content, images, or variant rules on an already-imported product (incremental merge — no re-import needed) |
| 6 | `dsers_product_visibility` | Set whether the product shows up in your store or stays as a hidden draft |
| 7 | `dsers_store_push` | Send products to your Shopify or Wix store — one at a time, in bulk, or to all stores at once |
| 8 | `dsers_job_status` | Check if a push finished and whether it succeeded |
| 9 | `dsers_product_delete` | Delete a product from the DSers import list (irreversible, requires confirmation) |

All tools return clear error messages so your AI agent knows what went wrong and what to do next — no cryptic error codes.

### Pre-Push Safety Checks

Before pushing a product to your store, the tool automatically checks for common mistakes:

- **Hard blocks** (push won't go through): selling below supplier cost, zero sell price, all variants out of stock
- **Warnings** (push goes through, but you'll see a heads-up): profit margin below 10%, stock under 5 units, sell price under $1

If something looks wrong, your AI agent will tell you exactly which variant has the problem and why. If you're sure it's fine, you can override with `force_push`.

### Pricing Rule Conflict Detection

If your DSers store has its own **Pricing Rule** enabled (basic/standard/advanced), and you also set pricing rules through MCP, the push will be **blocked** — not just warned. The agent will show two fix options:

1. Set `pricing_rule_behavior='apply_store_pricing_rule'` in push options to accept the store's pricing rule
2. Disable the Pricing Rule in your DSers store settings to use MCP pricing instead

### Four Prompts

Ready-made workflows your AI client can use directly:

| Prompt | Description |
|--------|-------------|
| `dsers_workflow_quick-import` | Import a single product and push to store as draft |
| `dsers_workflow_bulk-import` | Batch import with pricing multiplier |
| `dsers_workflow_multi-push` | Push one product to all connected stores |
| `dsers_workflow_seo-optimize` | Import, AI-rewrite title & description for SEO, then push |

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `DSERS_ENV` | No | `production` (default) or `test` |
| `DSERS_BASE_URL` | No | Override API base URL |
| `IMPORT_MCP_STATE_DIR` | No | Job state directory (default: `.state`) |

### What's Next

- Support more store platforms that DSers already connects to (eBay, Wish, etc.)
- Smarter pricing rule templates
- More granular inventory sync options

Got an idea or feature request? [Open an issue](https://github.com/lofder/dsers-mcp-product/issues) — suggestions and contributions from other developers are very welcome.

### Also Available

A [Python version](https://github.com/lofder/dsers-mcp-product-py) is available for local stdio deployments.

### License

MIT

---

## 中文

> **⚠️ 快速迭代阶段：** 我手上只有有限的店铺和 DSers 账号，很难囊括所有场景。我在尽可能测试各种情况下可能出现的问题，发现一个修一个，修的过程中也可能连带引出其他问题，因此近期更新迭代速度会非常快。请时刻关注最新版本，也非常欢迎大家来[帮我测试](https://github.com/lofder/dsers-mcp-product/issues)！

**DSers MCP Product** 是一个开源的 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 服务器，让 AI Agent 自动完成 DSers 的整个商品导入流程 —— 从速卖通 / Alibaba / [Accio.com](https://www.accio.com/) 商品链接到 Shopify 或 Wix 店铺上架。批量导入、批量编辑变体、清理速卖通标题、应用定价规则、推送到多个店铺 —— 只需一句话给你的 AI agent。

#### 能做什么？

- **一句话导入** — 贴个商品链接，AI 助手自动导入到 DSers
- **标题清理** — 把速卖通那些关键词堆砌的乱标题整理成人话
- **定价规则** — 加价倍率（比如 2.5 倍）、固定加价（比如 +5 美金）、划线价
- **批量导入** — 一次丢一堆链接，全部导入
- **多店铺推送** — 一个商品一次推到你所有的 Shopify 和 Wix 店铺
- **安全校验** — 推送前自动拦截低于成本价、零售价为零、库存为零的商品
- **SEO 优化** — 让 AI 重写标题和描述，提高搜索排名后再推送

服务已托管在 [Vercel](https://dsers-mcp-product.vercel.app/api/mcp)，并发布到多个平台：

### 发布平台

| 平台 | 链接 |
|------|------|
| npm | [npmjs.com/package/@lofder/dsers-mcp-product](https://www.npmjs.com/package/@lofder/dsers-mcp-product) |
| MCP Registry（官方） | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/servers/io.github.lofder/dsers-mcp-product) |
| Smithery | [smithery.ai/server/@dsersx/product-mcp](https://smithery.ai/server/@dsersx/product-mcp) |
| Glama.ai | [glama.ai/mcp/servers/lofder/dsers-mcp-product](https://glama.ai/mcp/servers/lofder/dsers-mcp-product) |
| mcp.so | [mcp.so/server/dsers-mcp-product](https://mcp.so/server/dsers-mcp-product) |
| mcpservers.org | [mcpservers.org](https://mcpservers.org) |
| MCP Marketplace | [mcp-marketplace.io](https://mcp-marketplace.io/server/io-github-lofder-dsers-mcp-product) |
| awesome-mcp-servers | [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) |
| Dev.to | [技术文章：I Built an MCP Server to Automate Dropshipping](https://dev.to/_95a3e57463e6442feacd0/i-built-an-mcp-server-to-automate-dropshipping-product-imports-3m5b) |

### 支持的商品来源

支持 **速卖通（AliExpress）**、**Alibaba.com** 和 **[Accio.com](https://www.accio.com/)** 的商品链接。把任意平台的商品链接丢给你的 AI 助手，它就能自动导入 DSers 并上架到你的店铺。（1688 链接也能识别，但需要你的 DSers 账号开通了 1688 来源权限。）

### Accio.com — AI 智能找商

[Accio.com](https://www.accio.com/) 是阿里巴巴的 AI 选品助手。你用自然语言描述想找的商品（比如"5 美金以下的蓝牙耳机"），它会帮你在速卖通和阿里巴巴上搜索。

**怎么配合 DSers MCP 用：**

1. 打开 [accio.com](https://www.accio.com/)，用自然语言搜索你想要的商品。
2. 在搜索结果里浏览，看到感兴趣的商品**点击进去**看详情。
3. **复制浏览器地址栏的链接**，大概长这样：
   `https://www.accio.com/c/xxx?productId=1005009871053792&ds=aliexpress.com`
4. 把链接丢给你的 AI 助手，比如说：*"帮我导入这个商品并上架：[粘贴链接]"*
5. 剩下的 AI 助手会自动搞定，不需要任何额外设置。

Accio 上搜出来的速卖通和阿里巴巴商品都能用。

### 文档

| 文档 | 说明 |
|------|------|
| [ARCHITECTURE.md](ARCHITECTURE.md) | 三层架构、目录结构、数据流 |
| [USAGE.md](USAGE.md) | 安装、客户端配置（Cursor、Claude Desktop）、使用场景 |
| [SKILL.md](SKILL.md) | AI agent 指令文件 — 工作流、规则、推送选项、错误处理 |
| [SKILL-CN.md](SKILL-CN.md) | SKILL.md 的中文说明 |

### 使用前提

- 一个 [DSers](https://www.dsers.com/) 账号（免费版就行）
- Shopify 或 Wix 店铺已经在 DSers 里绑定好了
- 一个支持 MCP 的 AI 客户端 — [Cursor](https://cursor.sh/)、[Claude Desktop](https://claude.ai/desktop)、[Windsurf](https://codeium.com/windsurf) 或其他支持 MCP 的工具

### 快速开始

**第 1 步：登录（一次性操作，会打开浏览器）**

```bash
npx @lofder/dsers-mcp-product login
```

浏览器会自动打开 DSers 官方登录页。你在 DSers 自己的网站上登录 —— 密码**完全不经过**本工具。登录后 session 加密保存到本地。

**第 2 步：添加到你的 MCP 客户端（不需要密码）**

```json
{
  "mcpServers": {
    "dsers-mcp-product": {
      "command": "npx",
      "args": ["-y", "@lofder/dsers-mcp-product"]
    }
  }
}
```

搞定。配置文件里不需要任何密码。

同时已收录到官方 [MCP R

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [OyaAIProd](https://github.com/OyaAIProd)
- **Source:** [OyaAIProd/dsers-mcp-product](https://github.com/OyaAIProd/dsers-mcp-product)
- **License:** MIT
- **Homepage:** https://dsers-mcp-product.vercel.app

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-oyaaiprod-dsers-mcp-product
- Seller: https://agentstack.voostack.com/s/oyaaiprod
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.