trendyol-seller-mcp

비공식 MCP 서버로, Trendyol Marketplace 판매자 API용입니다. 터키 이커머스 판매자들은 AI 어시스턴트(Claude Desktop, Claude Code 또는 다른 MCP 클라이언트)를 통해 일상적인 스토어 운영을 처리할 수 있습니다. 상품을 등록하고, 주문 패키지를 확인하고, 반품을 검토하고, 명시적으로 활성화했을 때 — 고객 질문에 답하고 재고/가격을 업데이트할 수 있습니다.

Trendyol과 관련 없는 비공식 프로젝트입니다. 이 프로젝트는 Koray Nar(이스탄불)가 만든 독립 오픈소스입니다. 공식 판매자 API에 자신의 API 자격 증명을 사용하여 연결하며, 해당 정보는 Trendyol Seller Panel에서 확인할 수 있습니다: Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri (패널의 마스터 사용자에게만 표시됩니다).

Koray가 자신의 AI 자동화 작업을 지원하기 위해 만들었고, 공개 포트폴리오의 일부로 게시했습니다. 실제 동작하는 도구이며, 목(mocked) 테스트 스위트를 갖추고 있습니다. 사용자 수나 클라이언트, 프로덕션 사용을 암시하지 않습니다.

터키어 요약

trendyol-seller-mcp, Trendyol Pazaryeri 판매자 API를 위한 비공식 MCP 서버입니다. Claude 같은 AI 어시스턴트가 사용자의 스토어와 대화할 수 있게 합니다: 상품을 나열하고, 주문 패키지와 반품을 조회하고, 고객 문의를 읽습니다. 쓰기 작업(문의 답변, 재고/가격 갱신)은 기본적으로 비활성화되어 있습니다. TRENDYOL_ALLOW_WRITES=true 환경 변수를 설정했을 때만 동작합니다.

필요한 정보: 판매자 ID, API Key, API Secret — 이 값은 Satıcı Panelı > Hesaplanı > Hesaplarım > Entegrasyon Bilgileri 페이지에서 찾을 수 있습니다. 이 프로젝트는 Trendyol과 관련이 없습니다. 자신의 책임 하에 본인 API 정보로 사용됩니다. 주문 데이터에서 고객 이름과 주소는 기본적으로 숨겨집니다(도시만 표시됩니다).

Related MCP server: Yandex Market Seller MCP Server

도구

쓰기 보호 장치 (먼저 읽어 보세요)

두 개의 쓰기 도구는 이중 proses:

1. TRENDYOL_ALLOW_WRITES=true 환경 변수가 서버 pro게에 설되지 않으면 명확한 메시지와 함께 거부합니다. 이 변수가 없으면 서버는 엄격한 읽기 전용으로 동작하므로 AI 어시스턴트가 스토어를 변경할 수 없습니다.

2. 어느 리크엔스트가 사용장치엔에서 나가기 전에 클라엔인트 측 검층이 실행됩니다(답변 길이 10–1000자는 max 1000 item per stock/price batch, item별 barcode required).

추가운 권장: 먼저 읽기 전용으로 사용하고, 반복 워크플로우를 신한 후에만 ENDY_ALLOW_RWITES=true를 설. 고객 질문에 대한 답변은 공개 이며 문의당 ^만 게시할 수 있습니다.

설정

요청은 HTTP Basic Auth(key/secret)를 사용하며, Trendyol이 자체 연동(self-integration)에서 요구하는 User-Agent인 "<sellerId> - SelfIntegration"를 함께 사용합니다.

빠른 시작

Python 1+ 및 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를 변경할 수 있습니다. 엔드포인트는 2026-08-25을 기준으로 developers.trendyol.com(v2.0 문서, 영어)에서 검증하였습니다.

• 6가지 일반적인 작업만 지원하며, 전체 API 표면은 다루지 않습니다(상품 생성, 배송 라벨, 청구서, 웹훅 엔드포인트 없음).

• update_price_and_stock는 Trendyol의 batchRequestId를 반환하지만, 배치 결과 엔드포인트를 폴링하지는 않습니다. 필요하면 직접 배치 상태를 확인하세요.

• Trendyol의 문서는 문의 페이지를 50건, 주문을 200건으로 제한합니다. 이 서버는 해당 기준으로 조정합니다. 상품 필터(V1) 페이지 크기에 대한 문서화된 제한은 없으므로 그대로 전달합니다.

• Trendyol의 국제(비-터키) 마켓플레이스 API는 대상으로 하지도 않고 테스트하지 않았습니다.

• 캐싱이나 재시도 루프가 없습니다. 429 응답에 Retry-After 값을 함께 노출하므로, 호출한 어시스턴트가 재시도 시점을 결정할 수 있습니다.

• 목(mocked) 응답을 대상으로 빌드하고 테스트했습니다. Trendyol 문서가 같은 필드에 둘 이상의 이름을 제시하는 경우, 관대한 대체 이름을 포함합니다.

라이선스

MIT © 2026 Koray Nar