Dsers MCP

Un MCP de Dsers con un conjunto de 14 herramientas (y en expansión) para permitir que tu agente acceda y edite tu dsers.

GitHubPrueba este MCPPatrocinado

Documentación

DSers MCP — Automatiza el dropshipping con herramientas de IA / importación de AliExpress a Shopify y Wix

Un servidor MCP de código abierto para automatizar la importación de productos en DSers, editar variantes en lote y publicar en Shopify o Wix mediante IA.

中文文档

DSers MCP es un servidor MCP (Model Context Protocol) de código abierto que permite a los agentes de IA automatizar todo el flujo de importación de DSers — desde la URL del producto en AliExpress / Alibaba / Accio.com hasta el listado en tu tienda Shopify o Wix. Importación masiva, edición de variantes en lote, limpieza de títulos de AliExpress, aplicación de reglas de precios y publicación en múltiples tiendas — todo con una sola frase para tu agente de IA.

¿Qué puede hacer?

Importación con un clic — pega un enlace de producto y tu agente de IA lo importa a DSers automáticamente
Limpieza de títulos — elimina el exceso de palabras clave desordenadas de los títulos de AliExpress y los convierte en algo legible
Reglas de precios — multiplicador de margen (p. ej. 2.5x), margen fijo (p. ej. +$5), precios comparativos / de oferta
Importación por lotes — importa varios productos a la vez con una lista de URLs
Publicación multi-tienda — publica un producto en todas tus tiendas conectadas de Shopify y Wix de una sola vez
Seguimiento de pedidos — lista y filtra tus pedidos de DSers por estado (pendiente, en espera de envío, completado, etc.)
Controles de seguridad — bloquea automáticamente publicaciones que resulten en precios por debajo del costo, precio cero o stock cero
Optimización SEO — permite que la IA reescriba el título y la descripción para mejorar el posicionamiento en buscadores antes de publicar

Fuentes de productos compatibles

Funciona con enlaces de productos de AliExpress, Alibaba.com y Accio.com. Solo tienes que darle a tu agente de IA un enlace de producto de cualquiera de estas plataformas, y este importará el producto a DSers y lo publicará en tu tienda. (Los enlaces de 1688.com también se reconocen, pero requieren que tu cuenta de DSers tenga habilitada la autorización de fuente 1688).

Accio.com — Búsqueda de productos con IA

Accio.com es el asistente de búsqueda de productos con IA de Alibaba. Describes lo que buscas (p. ej. "auriculares inalámbricos por menos de $5") y el busca en AliExpress y Alibaba por ti.

Cómo usarlo con DSers MCP:

Ve a accio.com y busca productos en lenguaje natural.
Revisa los resultados. Cuando encuentres un producto que te guste, haz clic en él para abrir el panel de detalles del producto.
Copia la URL de la barra de direcciones de tu navegador — se verá algo así: https://www.accio.com/c/xxx?productId=1005009871053792&ds=aliexpress.com
Dale ese enlace a tu agente de IA, p. ej.: "Importa este producto y publícalo en mi tienda: [pegar URL]"
El agente se encarga del resto — no se necesita configuración adicional.

Esto funciona tanto para productos de AliExpress como de Alibaba encontrados en Accio.

Lo que necesitas

Una cuenta de DSers (el plan gratuito funciona)
Una tienda Shopify o Wix ya conectada en DSers
Un cliente de IA compatible con MCP — Cursor, Claude Desktop, Windsurf, o cualquier cliente que soporte MCP

Inicio rápido

Paso 1: Inicia sesión (una sola vez — se abre tu navegador)

npx @akacoder404/dsers-mcp login

Se abre una ventana del navegador con la página oficial de inicio de sesión de DSers. Tú inicias sesión en el sitio web propio de DSers — tu contraseña nunca pasa por esta herramienta. Después de iniciar sesión, la sesión se cifra y se guarda localmente.

Paso 2: Añádelo a tu cliente MCP (no se necesitan credenciales)

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

Eso es todo. Sin contraseñas en archivos de configuración.

Autenticación — Inicio de sesión sin contraseña

Tu contraseña de DSers nunca toca esta herramienta. Así funciona el inicio de sesión:

Ejecutas npx @akacoder404/dsers-mcp login
Tu navegador abre la página oficial de inicio de sesión de DSers
Inicias sesión en el sitio web propio de DSers, como siempre
La herramienta captura tu sesión de inicio de sesión y la cifra localmente
Listo — a partir de ahora, el servidor MCP simplemente funciona. Sin contraseñas en ningún archivo de configuración.

Funciona con Chrome, Edge, Brave y otros navegadores Chromium. En Mac, Safari también funciona.

Las sesiones duran unas 6 horas. Cuando caducan, tu agente de IA te pedirá que ejecutes login de nuevo — toma 10 segundos.

¿Cambiar de cuenta?

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

Para desarrolladores: El servidor también acepta la variable de entorno DSERS_TOKEN para entornos headless/CI. Para la mayoría de los usuarios, basta con usar login.

Ejemplos de uso

Una vez configurado, solo habla con tu agente de IA en lenguaje natural:

"Importa este producto y publícalo en mi tienda de Shopify como borrador: https://www.aliexpress.com/item/1005006372921430.html"

"Importa este producto, aplica un margen de precio de 2.5x y publícalo: https://www.aliexpress.com/item/1005006372921430.html"

"Importa estos 3 productos en lote y publícalos todos en mi tienda: [URL1] [URL2] [URL3]"

"Publica este producto en todas mis tiendas conectadas"

"Reescribe el título y la descripción para SEO y luego publícalo en mi tienda"

El agente decide qué herramientas llamar. No necesitas saber nombres de herramientas ni parámetros.

Instalación desde el código fuente

# 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

Estructura del proyecto

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

Catorce herramientas

#	Herramienta	Qué hace
1	`dsers_store_discover`	Consulta tus tiendas conectadas, métodos de envío disponibles, reglas de precios y qué reglas puedes aplicar
2	`dsers_rules_validate`	Prueba tus reglas de precios o títulos antes de aplicarlas — detecta errores a tiempo
3	`dsers_product_import`	Pega una URL de producto, opcionalmente aplica reglas de precios/títulos y obtén una vista previa antes de publicar
4	`dsers_product_preview`	Revisa un producto ya importado — título, precio, variantes y stock de un vistazo
5	`dsers_product_update_rules`	Edita precios, contenido, imágenes o reglas de variantes en un producto ya importado (fusión incremental — sin reimportar)
6	`dsers_product_visibility`	Define si el producto aparece en tu tienda o permanece como borrador oculto
7	`dsers_store_push`	Envía productos a tu tienda Shopify o Wix — uno a la vez, en lote, o a todas las tiendas a la vez
8	`dsers_job_status`	Verifica si una publicación terminó y si fue exitosa
9	`dsers_product_delete`	Elimina un producto de la lista de importación de DSers (irreversible, requiere confirmación)
10	`dsers_import_list`	Navega por la lista de importación en proceso con costo, precio de venta, stock, estado de margen y alertas de stock bajo
11	`dsers_my_products`	Lista productos ya publicados en una tienda específica, con URLs de proveedor para reimportación
12	`dsers_find_product`	Busca en el pool de productos de DSers por palabra clave o imagen; los resultados incluyen import_url para importación en un paso
13	`dsers_sku_remap`	Cambio de proveedor a nivel de SKU en un producto de tienda en vivo. Vista previa antes de aplicar.
14	`dsers_orders`	Lista y filtra tus pedidos de DSers por estado — realiza seguimiento del progreso de cumplimiento del dropshipping

Todas las herramientas devuelven mensajes de error claros para que tu agente de IA sepa qué salió mal y qué hacer a continuación — sin códigos de error crípticos.

Controles de seguridad antes de publicar

Antes de publicar un producto en tu tienda, la herramienta verifica automáticamente errores comunes:

Bloqueos estrictos (la publicación no se realizará): vender por debajo del costo del proveedor, precio de venta cero, todas las variantes sin stock
Advertencias (la publicación se realiza, pero verás una alerta): margen de beneficio inferior al 10%, stock inferior a 5 unidades, precio de venta inferior a $1

Si algo parece incorrecto, tu agente de IA te indicará exactamente qué variante tiene el problema y por qué. Si estás seguro de que está bien, puedes anularlo con force_push.

Detección de conflictos de reglas de precios

Si tu tienda de DSers tiene su propia Regla de precios habilitada (básica/estándar/avanzada) y además defines reglas de precios a través de MCP, la publicación será bloqueada — no solo advertida. El agente mostrará dos opciones de corrección:

Establece pricing_rule_behavior='apply_store_pricing_rule' en las opciones de publicación para aceptar la regla de precios de la tienda
Deshabilita la Regla de precios en la configuración de tu tienda de DSers para usar los precios de MCP en su lugar

Cuatro prompts

Flujos de trabajo listos para usar que tu cliente de IA puede utilizar directamente:

Prompt	Descripción
`dsers_workflow_quick-import`	Importa un solo producto y publícalo en la tienda como borrador
`dsers_workflow_bulk-import`	Importación por lotes con multiplicador de precios
`dsers_workflow_multi-push`	Publica un producto en todas las tiendas conectadas
`dsers_workflow_seo-optimize`	Importa, reescribe con IA el título y la descripción para SEO y luego publica

Variables de entorno

Variable	¿Requerida?	Descripción
`DSERS_ENV`	No	`production` (predeterminado) o `test`
`DSERS_BASE_URL`	No	Anula la URL base de la API
`IMPORT_MCP_STATE_DIR`	No	Directorio de estado de trabajos (predeterminado: `.state`)

Lo que viene después

Soporte para más plataformas de tiendas a las que DSers ya se conecta (eBay, Wish, etc.)
Plantillas de reglas de precios más inteligentes
Opciones de sincronización de inventario más granulares

¿Tienes una idea o solicitud de función? Abre un issue — las sugerencias y contribuciones de otros desarrolladores son muy bienvenidas.

Licencia

MIT