trendyol-seller-mcp

Trendyol マーケットプレイスセラー API 向けの非公式 MCP サーバーです。トルコの e コマース出品者が AI アシスタント(Claude Desktop、Claude Code、その他の任意の MCP クライアント)を使って日々のストア運用を操作できます。商品の一覧表示、注文パッケージの確認、返品の確認、そして明示的に有効にした場合のみ、顧客からの質問への回答や在庫・価格の更新もできます。

Trendyol とは一切提携していません。 これは Koray Nar(イスタンブール)による独立したオープンソースプロジェクトです。Trendyol セラーパネルの Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri(パネルのマスターユーザーのみ閲覧可能)で確認できる あなた自身の API 認証情報を使って、公式セラー API に接続します。

Koray は自身の AI 自動化業務を支えるためにこれを開発し、公開ポートフォリオの一部として公開しています。モック化されたテストスイートを備えた実動するツールであり、ユーザー数やクライアント、本番運用を保証するものではありません。

Türkçe Özet

trendyol-seller-mcp, Trendyol Pazaryeri satıcı API'si için resmî olmayan bir MCP sunucusudur. Claude gibi bir yapay zeka asistanının mağazanızla konuşmasını sağlar: ürünleri listeler, sipariş paketlerini ve iadeleri görüntüler, müşteri sorularını okur. Yazma işlemleri (soru cevaplama, stok/fiyat güncelleme) varsayılan olarak kapalıdır; yalnızca TRENDYOL_ALLOW_WRITES=true ortam değişkenini ayarlarsanız çalışır.

Gerekli bilgiler: Satıcı ID, API Key ve API Secret — bunları Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri sayfasında bulabilirsiniz. Proje Trendyol ile bağlantılı değildir; kendi API bilgilerinizle, kendi sorumluluğunuzda kullanılır. Sipariş verilerinde müşteri adı ve adresi varsayılan olarak gizlenir (yalnızca şehir gösterilir).

Related MCP server: Yandex Market Seller MCP Server

ツール

書き込みガード(最初に必ず読んでください)

2 つの書き込みツールは二重にガードされています。

1. サーバープロセスに環境変数 TRENDYOL_ALLOW_WRITES=true が設定されていない限り、明確なメッセージを返して拒否します。これがないと、サーバーは厳密に読み取り専用となり、AI アシスタントがストアを変更することはできません。

2. クライアント側の検証は、リクエストがマシンから送信される前に実行されます(回答の長さは 10〜2000 文字、在庫・価格バッチは最大 1000 件、各項目にバーコード必須)。

推奨される使い方: まず読み取り専用で実行し、workflow に信頼が置けるようになってから TRENDYOL_ALLOW_WRITES=true を設定してください。顧客からの質問への回答は公開され、1 つの質問につき一度だけ投稿できます。

設定

リクエストは HTTP Basic 認証(キー/シークレット)を使用し、Trendyol が自己統合に必須とする User-Agent である <sellerId> - SelfIntegration を使用します。

クイックスタート

Python 3.11 以降と 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

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"
      }
    }
  }
}

書き込みツールを有効にする場合にのみ、env に "TRENDYOL_ALLOW_WRITES": "true" を追加してください。

プライバシーに関する注意

• get_orders は、デフォルトで顧客名と完全な配送先住所を伏せ、都市のみを返します。実際に必要なときだけ呼び出しごとに include_pii=True を渡してください。

• get_customer_questions と get_claims は、顧客名を返すことはありません。

• 認証情報は環境変数からのみ取得され、ディスクに書き込まれることはありません。

制限事項(率直な一覧)

• 非公式: Trendyol はいつでも API を変更できます。エンドポイントは developers.trendyol.com(v2.0 ドキュメント、EN)で 2026-08-25 に確認したものです。

• 6種類の一般的な操作のみをカバーしており、API の全体には対応していません(商品作成、配送ラベル、請求書、Webhook エンドポイントなし)。

• update_price_and_stock は Trendyol の batchRequestId を返します、バッチ結果エンドポイントをポーリングしてはいるわけではありません。必要な場合はご自身でバッチの状態をご確認ください。

• Trendyol のドキュメントでは、質問ページが 50 件、注文ページが 200 件に上限とされています。このサーバーはその上限を守ります。この商品フィルタ (V1) のページサイズには明示された上限がないため、そのまま渡します。

• Trendyol の国際(iTR 以外)向けマーケットプレイス API は対象外で、テストも行っていません。

• キャッシュなし、リトライループなし。429 は Retry-After 値とともに返され、呼び出し側の AI が再試行を行うタイミングを判断できます。

• モックしたレスポンスに対して構築・テストされたものです。フィールド名は、Trendyol のドキュメントで同じフィールドに関複数名前がある場合に、寛容なフォールバックを持たせています。

ライセンス

MIT © 2026 Koray Nar