trendyol-seller-mcp

Un servidor MCP no oficial para la API de vendedores de Trendyol Marketplace, para que los vendedores turcos de comercio electrónico puedan realizar las operaciones diarias de su tienda desde un asistente de IA (Claude Desktop, Claude Code o cualquier otro cliente MCP): listar productos, consultar paquetes de pedidos, revisar devoluciones y — cuando esté expresamente habilitado — responder preguntas de clientes y actualizar el stock y los precios.

No está afiliado a Trendyol. Este es un proyecto independiente de código abierto de Koray Nar (Estambul). Se comunica con la API oficial de vendedores usando tus propias credenciales de API, que puedes encontrar en el Panel de Vendedor de Trendyol: Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri (visible solo para el usuario principal del panel).

Creado por Koray para apoyar su propia práctica de automatización con IA y publicado como parte de su portafolio público. Es una herramienta funcional con una suite de pruebas simuladas: no implica métricas de usuarios, clientes ni afirmaciones de producción.

Resumen

trendyol-seller-mcp es un servidor MCP no oficial para la API de vendedores de Trendyol Marketplace. Permite que un asistente de IA como Claude hable con tu tienda: lista productos, consulta paquetes de pedidos y devoluciones, y lee preguntas de clientes. Las operaciones de escritura (responder preguntas, actualizar stock y precios) están desactivadas por defecto; solo se activan si estableces la variable de entorno TRENDYOL_ALLOW_WRITES=true.

Información necesaria: ID de vendedor, API Key y API Secret; puedes encontrarlos en la página Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri. El proyecto no está afiliado a Trendyol; se usa con tus propias credenciales de API y bajo tu propia responsabilidad. En los datos de los pedidos, el nombre y la dirección del cliente se ocultan por defecto (solo se muestra la ciudad).

Related MCP server: Yandex Market Seller MCP Server

Herramientas

Protección de escritura (lee esto primero)

Las dos herramientas de escritura están doblemente protegidas:

1. Rechazan la solicitud con un mensaje claro a menos que la variable de entorno TRENDYOL_ALLOW_WRITES=true esté definida en el proceso del servidor. Sin ella, el servidor es estrictamente de solo lectura: un asistente de IA no puede modificar tu tienda.

2. La validación en el cliente se ejecuta antes de que cualquier solicitud salga de tu equipo (respuesta de 10 a 2000 caracteres, máximo 1000 artículos por lote de stock/precio, código de barras obligatorio por artículo).

Recomendación: ejecuta primero el modo de solo lectura y define TRENDYOL_ALLOW_WRITES=true solo cuando confíes en el flujo de trabajo. Las respuestas a las preguntas de los clientes son públicas y solo pueden publicarse una vez por pregunta.

Configuración

Las solicitudes usan autenticación HTTP Basic (key/secret) y el User-Agent que Trendyol exige para integraciones propias: "<sellerId> - SelfIntegration".

Inicio rápido

Requiere Python 3.11+ y uv.

git clone https://github.com/koraynar/trendyol-seller-mcp
cd trendyol-seller-mcp
uv venv && uv pip install -e '.[dev]'
uv run --extra dev pytest   # all tests are offline (httpx.MockTransport), no live calls

Claude Code

claude mcp add trendyol-seller \
  --env TRENDYOL_SELLER_ID=123456 \
  --env TRENDYOL_API_KEY=your-key \
  --env TRENDYOL_API_SECRET=your-secret \
  -- uv run --directory /absolute/path/to/trendyol-seller-mcp trendyol-seller-mcp

Claude Desktop

Añade esto a claude_desktop_config.json:

{
  "mcpServers": {
    "trendyol-seller": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/trendyol-seller-mcp",
        "trendyol-seller-mcp"
      ],
      "env": {
        "TRENDYOL_SELLER_ID": "123456",
        "TRENDYOL_API_KEY": "your-key",
        "TRENDYOL_API_SECRET": "your-secret"
      }
    }
  }
}

Añade "TRENDYOL_ALLOW_WRITES": "true" a env solo cuando quieras activar las herramientas de escritura.

Notas de privacidad

• get_orders oculta por defecto el nombre del cliente y la dirección de envío completa, y devuelve solo la ciudad; pasa include_pii=True en cada llamada cuando realmente lo necesites.

• get_customer_questions y get_claims nunca devuelven los nombres de los clientes.

• Las credenciales provienen únicamente de variables de entorno; no se escribe nada en disco.

Limitaciones (lista honesta)

• No oficial: Trendyol puede cambiar la API en cualquier momento; los endpoints se verificaron contra developers.trendyol.com (documentación v2.0, EN) el 25 de agosto de 2026.

• Cubre seis operaciones comunes, no toda la superficie de la API (no incluye la creación de productos, etiquetas de envío, facturas ni webhooks).

• update_price_and_stock devuelve el batchRequestId de Trendyol, pero no consulta el endpoint de resultados del lote; comprueba el estado del lote tú mismo si es necesario.

• La documentación de Trendyol limita las páginas de preguntas a 50 elementos y las de pedidos a 200; este servidor se ajusta a esos límites. No se encontró un límite documentado para el tamaño de página del filtro de productos (V1), así que se envía tal cual.

• La API del marketplace internacional (no TR) de Trendyol no está contemplada ni probada.

• No hay caché ni bucle de reintentos: un 429 se muestra con el valor Retry-After para que el asistente que llama pueda decidir cuándo reintentar.

• Pruebas y desarrollo hechos con respuestas simuladas; los nombres de los campos incluyen respaldos tolerantes cuando la documentación de Trendyol muestra más de un nombre para el mismo campo.

Licencia

MIT © 2026 Koray Nar