trendyol-seller-mcp

trendyol-seller-mcp

一个面向 Trendyol Marketplace 卖家 API 的非官方 MCP 服务，让土耳其电商卖家可以通过 AI 助手（Claude Desktop、Claude Code 或任何其他 MCP 客户端）处理日常店铺运营：列出商品、查看订单包裹、审核退货，以及在明确启用后回答客户问题并更新库存和价格。

与 Trendyol 无关联。 这是由 Koray Nar（伊斯坦布尔）开发的独立开源项目。它使用您自己的 API 凭据调用官方卖家 API；您可以在 Trendyol Seller Panel 中找到这些凭据：Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri（仅主账号用户可见）。

Koray 开发此项目是为了支持自己的 AI 自动化实践，并将其作为公开作品集的一部分发布。这是一个可用工具，配有模拟测试套件；这并不意味着任何用户数量、客户或生产环境方面的声明。

Türkçe Özet

trendyol-seller-mcp 是面向 Trendyol Pazaryeri 卖家 API 的非官方 MCP 服务。它可以让 Claude 等 AI 助手与您的店铺对话：列出商品、查看订单包裹和退货、读取客户问题。写入操作（回答问题、更新库存/价格）默认关闭；只有设置环境变量 TRENDYOL_ALLOW_WRITES=true 后才会启用。

所需信息：卖家 ID、API Key 和 API Secret——您可以在 Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri 页面找到这些信息。此项目与 Trendyol 无关；请使用您自己的 API 信息并自行承担责任。订单数据中的客户姓名和地址默认隐藏（仅显示城市）。

工具

工具	类型	功能
get_products(page=0, size=50, approved=None, barcode="")	读取	分页列出商品，仅包含 barcode、title、quantity、salePrice、listPrice、approved。
get_orders(status="", start_date="", end_date="", page=0, size=50, include_pii=False)	读取	订单包裹：orderNumber、status、orderDate、totalPrice、商品行，以及仅客户所在城市。除非设置 include_pii=True，否则姓名/完整地址会被隐藏。日期接受 YYYY-MM-DD 或 epoch ms。状态值：Created、Picking、Invoiced、Shipped、Cancelled、Delivered、UnDelivered、Returned、AtCollectionPoint、UnSupplied。
get_customer_questions(status="WAITING_FOR_ANSWER", page=0, size=50)	读取	客户问答：id、问题文本、状态、商品、已有答案。其他状态：WAITING_FOR_APPROVE、ANSWERED、REPORTED、REJECTED。
answer_question(question_id, text)	写入	发布回答（10–2000 个字符，遵循 Trendyol 规则）。受保护，详见下文。
update_price_and_stock(items_json)	写入	批量更新库存/价格。items_json 是由 {"barcode", "quantity", "salePrice", "listPrice"} 组成的 JSON 数组（最多 1000 项）。返回 Trendyol 的 batchRequestId。受保护，详见下文。
get_claims(page=0, size=20)	读取	退货/索赔摘要，包含各商品状态和客户原因。不包含客户姓名。

写入保护（请先阅读）

这两个写入工具均有双重保护：

1. 除非为服务进程设置环境变量 TRENDYOL_ALLOW_WRITES=true，否则工具会拒绝执行并给出明确提示。未设置时，服务严格为只读模式——AI 助手无法更改您的店铺。
2. 请求离开您的设备前会先进行客户端验证（回答长度为 10–2000 个字符；每批库存/价格更新最多 1000 项；每项都必须提供条形码）。

建议：先以只读模式运行，只有在您信任该工作流后才设置 TRENDYOL_ALLOW_WRITES=true。客户问题的回答是公开内容，每个问题只能发布一次。

配置

环境变量	必填	含义
TRENDYOL_SELLER_ID	是	您的卖家（cari）ID。
TRENDYOL_API_KEY	是	来自 Entegrasyon Bilgileri 的 API 密钥。
TRENDYOL_API_SECRET	是	来自 Entegrasyon Bilgileri 的 API 密钥。
TRENDYOL_BASE_URL	否	默认为 https://apigw.trendyol.com/integration。在 Trendyol 的 staging 环境中，请设置为 https://stageapigw.trendyol.com/integration。
TRENDYOL_ALLOW_WRITES	否	设置为 true 以启用两个写入工具。其他任何值都会使它们保持禁用状态。

请求使用 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"
      }
    }
  }
}

仅当您希望启用写入工具时，才将 "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 值一并返回，由调用助手决定何时重试。
• 基于模拟响应构建并经过测试；对于 Trendyol 文档中同一字段存在多个名称的情况，字段名提供了兼容性回退。

许可证

MIT © 2026 Koray Nar