Trendyol MCP

Enzifiri tarafından geliştirilmiştir — https://github.com/enzifiri Ücretsiz ve açık kaynaklıdır. Resmi bir Trendyol ürünü değildir; Trendyol ile bağlantısı yoktur.

Trendyol Partner (Marketplace) API'si için bir Model Context Protocol sunucusu. Claude, Cursor, VS Code Copilot gibi yapay zekâ asistanlarına şunları kazandırır:

• Tüm geliştirici dokümantasyonu: developers.trendyol.com'daki 96 kılavuz sayfası ve 93 API işleminin tam OpenAPI tanımı pakete gömülüdür. API anahtarı olmadan da arama yapılabilir, şemalar ve örnek kod görülebilir.

• Çoklu mağaza: 1 ya da 20 mağaza fark etmez. Her mağazayı kendi bilgisayarınızda bir kez tanımlarsınız, asistan hangi mağazada işlem yapacağını seçer. Okuma işlemleri tüm mağazalarda tek seferde de çalıştırılabilir.

• 93 API işleminin tamamı: ürün, stok/fiyat, sipariş, iade, fatura, webhook, soru-cevap, finans, adres, ortak etiket ve ihracat (AutoFT) işlemleri tek bir araçla yapılabilir. Kimlik doğrulama, zorunlu User-Agent ve sellerId otomatik eklenir.

• Güvenli varsayılanlar: API bilgileri pakette ya da sohbette yer almaz, sadece sizin bilgisayarınızda saklanır. Canlı mağazalarda değişiklik yapma izni siz açmadıkça kapalıdır. dryRun ile istek göndermeden önce görülebilir.

Kurulum (2 adım)

Node.js 18.17 veya üstü gerekir (nodejs.org).

1. Mağazalarınızı ekleyin

Terminalde çalıştırın. Program Satıcı ID, API Key ve API Secret bilgilerini sorar (Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri):

npx -y trendyol-mcp stores add

Birden fazla mağazanız varsa her biri için tekrarlayın. Bilgilerin doğru olup olmadığını kontrol etmek için:

npx -y trendyol-mcp stores test

2. Asistanınıza ekleyin

Claude Code:

claude mcp add trendyol -- npx -y trendyol-mcp

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json), VS Code (.vscode/mcp.json, burada anahtar "servers") için:

{
  "mcpServers": {
    "trendyol": {
      "command": "npx",
      "args": ["-y", "trendyol-mcp"]
    }
  }
}

Bu kadar. Ayar dosyasına API bilgisi yazmanız gerekmez. Sonradan mağaza ekleyip çıkardığınızda asistanı yeniden başlatmanız da gerekmez.

Related MCP server: trendyol-seller-mcp

Mağaza yönetimi

npx -y trendyol-mcp stores add [ad]        # ekle / güncelle
npx -y trendyol-mcp stores list            # listele
npx -y trendyol-mcp stores test [ad]       # bağlantıyı doğrula (ad verilmezse hepsi)
npx -y trendyol-mcp stores default <ad>    # varsayılan mağaza
npx -y trendyol-mcp stores remove <ad>     # sil
npx -y trendyol-mcp stores path            # dosyanın yeri

Komut sormadan da çalışabilir (betikler için):

npx -y trendyol-mcp stores add kozmetik --seller-id 123456 --api-key KEY --api-secret SECRET --label "Kozmetik" --env prod --allow-write hayir --yes

Mağazalar ~/.trendyol-mcp/stores.json dosyasında saklanır (Windows: C:\Users\<kullanıcı>\.trendyol-mcp\stores.json). Dosyayı elle de düzenleyebilirsiniz:

{
  "defaultStore": "kozmetik",
  "stores": {
    "kozmetik":   { "label": "Kozmetik", "sellerId": "123456", "apiKey": "...", "apiSecret": "...", "environment": "prod", "allowWrite": false },
    "elektronik": { "sellerId": "654321", "apiKey": "...", "apiSecret": "...", "environment": "prod", "allowWrite": true },
    "test":       { "sellerId": "999", "apiKey": "...", "apiSecret": "...", "environment": "stage", "allowWrite": true }
  }
}

Bu dosyayı kimseyle paylaşmayın, GitHub'a yüklemeyin.

Gelişmiş: ortam değişkenleri

Araçlar

Örnek kullanım

Asistanınıza doğal dille sorabilirsiniz:

• "Tüm mağazalarımda bugün gelen yeni siparişleri listele."

• "Elektronik mağazasında X barkodlu ürünün stoğunu 50 yap." (sadece yazma izni açık mağazada çalışır)

• "Trendyol'da stok ve fiyat nasıl güncellenir? Örnek TypeScript kodu yaz."

• "createProducts için zorunlu alanlar neler? Elimdeki ürün JSON'unu buna dönüştür."

• "Kozmetik mağazasındaki cevaplanmamış müşteri sorularını getir ve cevap taslakları hazırla."

Notlar

• Rate limit: aynı uç noktaya 10 saniyede en fazla 50 istek gönderilebilir. 429 alınırsa sunucu bekleyip otomatik olarak tekrar dener. Ürün servislerinin grup bazlı limitleri için asistana 1-servis-limitleri sayfasını okutabilirsiniz.

• Test ortamı IP yetkilendirmesi gerektirir. Yetki yoksa 503 hatası döner. Ayrıntılar 3-canlı-test-ortam-bilgileri sayfasında.

• Toplu işlemler (ürün oluşturma, stok/fiyat güncelleme) bir batchRequestId döndürür. İşlemin sonucu bu ID ile getBatchRequestResult üzerinden sorgulanır.

• Büyük yanıtlar (örneğin kategori ağacı) maxResponseChars sınırında kırpılır.

Geliştirme

git clone https://github.com/enzifiri/trendyol-mcp.git
cd trendyol-mcp
npm install
npm test            # derler, CLI ve tüm MCP araçlarını dener (gerçek istek göndermez)
npm run inspect     # MCP Inspector ile arayüzden deneme
npm run update-docs # developers.trendyol.com'dan dokümanları yeniden indirip kataloğu üretir

src/index.ts         Giriş: argümansız → MCP sunucusu, "stores …" → CLI
src/server.ts        MCP araç tanımları
src/cli.ts           Mağaza yönetimi komutları
src/config.ts        Mağaza dosyası ve ortam değişkenleri
src/client.ts        Trendyol HTTP istemcisi (auth, User-Agent, retry, yazma koruması)
src/catalog.ts       Doküman kataloğu, arama, şema özetleme, örnek kod
src/attribution.ts   Geliştirici bilgisi
scripts/             Doküman indirme, katalog üretme, duman testi
data/catalog.json    Üretilmiş katalog (96 kılavuz + 93 işlem)

Lisans

MIT, ayrıntılar için LICENSE dosyasına bakın. Dokümantasyon içeriğinin hakları Trendyol'a aittir. Bu proje, geliştiricilerin erişimini kolaylaştırmak için yalnızca bir kopyasını içerir.