trendyol-seller-mcp

一个非官方的 MCP 服务器，用于 Trendyol Marketplace 卖家 API，让土耳其电商卖家可以通过 AI 助手（Claude Desktop、Claude Code 或任何其他 MCP 客户端）来执行日常店铺运营：列出商品、检查订单包裹、查看退货，并在显式启用时——回答客户问题以及更新库存/价格。

与 Trendyol 并无关联：这是一个由 Koray Nar（伊斯坦布尔）发起的独立开源项目。它使用你自己的 API 凭据与官方卖家 API 通信，你可以在 Trendyol 卖家面板下的 Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri 中找到这些凭据（仅对面板的主用户可见）。

这是 Koray 为支持自己 AI 自动化实践而构建的工具，并作为其公开作品集的一部分发布。它是一个实际可用的工具，附有一套 mock 测试——并不暗示任何用户数量、客户规模或生产级承诺。

土耳其语摘要

trendyol-seller-mcp 是用于 Trendyol Pazaryeri 卖家 API 的非官方 MCP 服务器。它让像 Claude 这样的 AI 助手与你的店铺对话：列出商品、查看订单包裹和 iadeler、读取客户问题。写入操作（回答提问、更新库存/价格）默认是关闭的；只有在设置了 TRENDYOL_ALLOW_WRITES=true 环境变量后才会运行。

所需信息：Satıcı ID、API Key 和 API Secret——你可以在 Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri 页面找到。该项目与 Trendyol 无关；使用你自己的 API 信息，风险自负。订单数据中，客户姓名和地址默认隐藏（仅显示城市）。

Related MCP server: Yandex Market Seller MCP Server

工具

写入保护（请先阅读）

这两个写入工具是双重受保护的：

1. 除非服务器进程已设置环境变量 TRENDYOL_ALLOW_WRITES=true，否则它们会拒绝并提示明确消息。没有该变量，服务器严格只读——AI 助手无法更改你的店铺。

2. 客户端校验会在请求离开你的机器之前执行（回答长度 10–2000 个字符，每次库存/价格批量最多 1000 项，每项必须提供 barcode）。

建议：先以只读模式运行，直到你信任该流程后，再设置 TRENDYOL_ALLOW_WRITES=true。对客户问题的回答是公开的，并且每个问题只能发布一次。

配置

请求使用 HTTP Basic 认证（key/secret），并带有 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"
      }
    }
  }
}

仅当你想启用写入工具时，才将 "TRENDYOL_ALLOW_WRITES": "true" 放入 env。

隐私说明

• get_orders 默认会删除客户姓名和完整发货地址，仅返回城市；确实需要时，每次调用传入 include_pii=true。

• get_customer_questions 和 get_claims 永远不返回客户姓名。

• 凭据仅来自环境变量，不会写入磁盘。

限制（如实清单）

• 非官方：Trendyol 可随时改变 API；这些端点已于 2026-08-25 根据 developers.trendyol.com（v2.0 文档，英文）验证。

• 覆盖六种常见操作，而非完整 API 能力（没有商品创建、运单标签、发票或 webhook 端点）。

• update_price_and_stock 返回 Trendyol 的 batchRequestId，但不会轮询批次状态端点；如需要请自行查看批次状态。

• Trendyol 的文档将问题页上限为 50 项、订单页上限为 200 项；本服务器会钳制在这些限制内。产品筛选（V1）的页大小没有文档化上限，因此按原样透传。

• Trendyol 的国际（非 TR）市场 API 不在目标或测试范围内。

• 没有缓存，也不重试重试——429 会连同 Retry-After 值返回，让调用的助手决定何时重试。

• 是基于 mock 响应构建和测试的；在 Trendyol 文档对同一字段给出多个名称时，字段名中包含容错回退。

许可证

MIT © 2026 Koray Nar