Dsers MCP

Um MCP Dsers com 14 ferramentas (e em expansão) para permitir que seu agente acesse e edite seus dsers.

Documentação

DSers MCP — Automatize ferramentas de IA para dropshipping/importação AliExpress para Shopify e Wix

Um servidor MCP de código aberto para automatizar a importação de produtos DSers, edição em massa de variantes e envio para Shopify ou Wix usando IA.

中文文档

DSers MCP é um servidor MCP (Model Context Protocol) de código aberto que permite que agentes de IA automatizem todo o fluxo de importação do DSers — desde a URL do produto AliExpress / Alibaba / Accio.com até a listagem na loja Shopify ou Wix. Importação em massa, edição em lote de variantes, limpeza de títulos do AliExpress, aplicação de regras de preço e envio para várias lojas — tudo com uma única frase para o seu agente de IA.

O que ele pode fazer?

Importação com um clique — cole um link de produto e seu agente de IA o importa para o DSers automaticamente
Limpeza de títulos — remove a bagunça de palavras-chave dos títulos do AliExpress e os transforma em algo legível
Regras de preço — multiplicador de margem (ex.: 2,5x), margem fixa (ex.: +US$ 5), preços comparativos/de venda
Importação em lote — importe vários produtos de uma vez com uma lista de URLs
Envio para várias lojas — envie um produto para todas as suas lojas Shopify e Wix conectadas de uma só vez
Rastreamento de pedidos — liste e filtre seus pedidos DSers por status (pendente, aguardando envio, concluído etc.)
Verificações de segurança — bloqueia automaticamente envios que resultariam em preço abaixo do custo, preço zero ou estoque zero
Otimização de SEO — deixe a IA reescrever o título e a descrição para melhorar o ranqueamento em buscas antes do envio

Fontes de produtos compatíveis

Funciona com links de produtos de AliExpress, Alibaba.com e Accio.com. Basta dar ao seu agente de IA um link de produto de qualquer uma dessas plataformas, e ele importará o produto para o DSers e o enviará para a sua loja. (Links do 1688.com também são reconhecidos, mas exigem que a autorização de fonte 1688 esteja habilitada na sua conta DSers.)

Accio.com — Busca de produtos com IA

Accio.com é o assistente de sourcing com IA da Alibaba. Você descreve o que está procurando (ex.: "fones de ouvido sem fio abaixo de US$ 5") e ele busca no AliExpress e na Alibaba para você.

Como usar com o DSers MCP:

Acesse accio.com e pesquise produtos em linguagem natural.
Navegue pelos resultados. Ao encontrar um produto de que goste, clique nele para abrir o painel de detalhes do produto.
Copie a URL da barra de endereços do seu navegador — ela terá um formato parecido com: https://www.accio.com/c/xxx?productId=1005009871053792&ds=aliexpress.com
Envie esse link para o seu agente de IA, por exemplo: "Importe este produto e envie para minha loja: [cole a URL]"
O agente cuida do resto — não é preciso nenhuma configuração adicional.

Isso funciona tanto para produtos do AliExpress quanto da Alibaba encontrados no Accio.

O que você precisa

Uma conta DSers (o plano gratuito funciona)
Uma loja Shopify ou Wix já conectada no DSers
Um cliente de IA compatível com MCP — Cursor, Claude Desktop, Windsurf ou qualquer cliente que suporte MCP

Início rápido

Etapa 1: Faça login (uma única vez — abre o seu navegador)

npx @akacoder404/dsers-mcp login

Uma janela do navegador abre a página oficial de login do DSers. Você faz login no próprio site do DSers — sua senha nunca passa por esta ferramenta. Após o login, a sessão é criptografada e salva localmente.

Etapa 2: Adicione ao seu cliente MCP (nenhuma credencial necessária)

{
  "mcpServers": {
    "dsers-mcp": {
      "command": "npx",
      "args": ["-y", "@akacoder404/dsers-mcp"]
    }
  }
}

Só isso. Nenhuma senha em arquivos de configuração.

Autenticação — login sem senha

Sua senha do DSers nunca toca esta ferramenta. Veja como o login funciona:

Você executa npx @akacoder404/dsers-mcp login
Seu navegador abre a página oficial de login do DSers
Você faz login no próprio site do DSers, como de costume
A ferramenta captura sua sessão de login e a criptografa localmente
Pronto — a partir daí, o servidor MCP simplesmente funciona. Nenhuma senha em qualquer arquivo de configuração.

Funciona com Chrome, Edge, Brave e outros navegadores Chromium. No Mac, Safari também funciona.

As sessões duram cerca de 6 horas. Quando expira, seu agente de IA pedirá para você executar login novamente — leva 10 segundos.

Trocando de conta?

npx @akacoder404/dsers-mcp logout
npx @akacoder404/dsers-mcp login

Para desenvolvedores: O servidor também aceita a variável de ambiente DSERS_TOKEN para ambientes headless/CI. Para a maioria dos usuários, basta usar login.

Exemplos de uso

Depois de configurado, basta conversar com seu agente de IA em linguagem natural:

"Importe este produto e envie para minha loja Shopify como rascunho: https://www.aliexpress.com/item/1005006372921430.html"

"Importe este produto, aumente o preço em 2,5x e envie: https://www.aliexpress.com/item/1005006372921430.html"

"Importe estes 3 produtos em lote e envie todos para minha loja: [URL1] [URL2] [URL3]"

"Envie este produto para todas as minhas lojas conectadas"

"Reescreva o título e a descrição para SEO e depois envie para minha loja"

O agente descobre quais ferramentas chamar. Você não precisa saber nomes de ferramentas ou parâmetros.

Instalação a partir do código-fonte

# Clone
git clone https://github.com/akacoder404/dsers-mcp.git
cd dsers-mcp

# Install
npm install

# Type check
npx tsc --noEmit

# Run tests
npm test

Estrutura do projeto

dsers-mcp/
├── src/
│   ├── index.ts              # MCP server entry — tool registration
│   ├── cli.ts                # CLI entrypoint (login, logout, stdio server)
│   ├── service.ts            # Import flow orchestration
│   ├── 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/                     # Unit tests
├── package.json
├── tsconfig.json
└── .env.example

Quatorze ferramentas

#	Ferramenta	O que ela faz
1	`dsers_store_discover`	Veja suas lojas conectadas, métodos de envio disponíveis, regras de preço e quais regras você pode aplicar
2	`dsers_rules_validate`	Teste suas regras de preço ou de título antes de aplicar — detecta erros cedo
3	`dsers_product_import`	Cole a URL de um produto, opcionalmente aplique regras de preço/título e veja uma prévia antes de enviar
4	`dsers_product_preview`	Revise um produto já importado — título, preço, variantes e estoque em um relance
5	`dsers_product_update_rules`	Edite preço, conteúdo, imagens ou regras de variantes em um produto já importado (mesclagem incremental — sem nova importação)
6	`dsers_product_visibility`	Defina se o produto aparece na sua loja ou permanece como rascunho oculto
7	`dsers_store_push`	Envie produtos para sua loja Shopify ou Wix — um por vez, em lote ou para todas as lojas de uma vez
8	`dsers_job_status`	Verifique se um envio foi concluído e se foi bem-sucedido
9	`dsers_product_delete`	Exclua um produto da lista de importação do DSers (irreversível, exige confirmação)
10	`dsers_import_list`	Navegue pela lista de importação em preparação com custo, preço de venda, estoque, status de margem e alertas de estoque baixo
11	`dsers_my_products`	Liste produtos já enviados para uma loja específica, com URLs de fornecedor para reimportação
12	`dsers_find_product`	Pesquise o pool de produtos DSers por palavra-chave ou imagem; os resultados incluem import_url para importação em um passo
13	`dsers_sku_remap`	Troca de fornecedor no nível de SKU em um produto ativo na loja. Veja a prévia antes de aplicar.
14	`dsers_orders`	Liste e filtre seus pedidos DSers por status — acompanhe o andamento do fulfillment no dropshipping

Todas as ferramentas retornam mensagens de erro claras, para que seu agente de IA saiba o que deu errado e o que fazer em seguida — sem códigos de erro enigmáticos.

Verificações de segurança antes do envio

Antes de enviar um produto para sua loja, a ferramenta verifica automaticamente erros comuns:

Bloqueios rígidos (o envio não é concluído): vender abaixo do custo do fornecedor, preço de venda zero, todas as variantes sem estoque
Avisos (o envio é concluído, mas você verá um alerta): margem de lucro abaixo de 10%, estoque abaixo de 5 unidades, preço de venda abaixo de US$ 1

Se algo parecer errado, seu agente de IA informará exatamente qual variante tem o problema e por quê. Se você tiver certeza de que está tudo certo, pode ignorar usando force_push.

Detecção de conflitos de regras de preço

Se sua loja DSers tiver uma Regra de Preço própria habilitada (básica/padrão/avançada) e você também definir regras de preço pelo MCP, o envio será bloqueado — não apenas alertado. O agente mostrará duas opções de correção:

Defina pricing_rule_behavior='apply_store_pricing_rule' nas opções de envio para aceitar a regra de preço da loja
Desative a Regra de Preço nas configurações da sua loja DSers para usar a precificação do MCP

Quatro prompts

Fluxos de trabalho prontos que seu cliente de IA pode usar diretamente:

Prompt	Descrição
`dsers_workflow_quick-import`	Importe um único produto e envie para a loja como rascunho
`dsers_workflow_bulk-import`	Importação em lote com multiplicador de preço
`dsers_workflow_multi-push`	Envie um produto para todas as lojas conectadas
`dsers_workflow_seo-optimize`	Importe, reescreva título e descrição com IA para SEO e envie

Variáveis de ambiente

Variável	Obrigatória	Descrição
`DSERS_ENV`	Não	`production` (padrão) ou `test`
`DSERS_BASE_URL`	Não	Substitui a URL base da API
`IMPORT_MCP_STATE_DIR`	Não	Diretório de estado do job (padrão: `.state`)

Próximos passos

Suporte a mais plataformas de loja às quais o DSers já se conecta (eBay, Wish etc.)
Modelos de regras de preço mais inteligentes
Opções de sincronização de inventário mais granulares

Tem uma ideia ou pedido de recurso? Abra uma issue — sugestões e contribuições de outros desenvolvedores são muito bem-vindas.

Licença

MIT