用途
trendyol-seller-mcp 是一个非官方的 MCP 服务器，封装了 Trendyol 市场卖家 API，目标是让土耳其电商卖家能够通过 AI 助手（Claude Desktop、Claude Code 或任何其他 MCP 客户端）驱动日常店铺运营。
主要能力
通过该项目可以：
- 列出产品
- 查看订单包裹
- 查看退货
- 读取客户问题
- 在显式启用后，回答客户问题、更新库存与价格
写入工具具有双重防护：除非为服务器进程设置了环境变量 TRENDYOL_ALLOW_WRITES=true，否则这两个写入工具会拒绝执行并给出明确提示；未设置时服务器严格只读，AI 助手无法更改店铺。
在任何请求离开本机之前会进行客户端校验：回答长度 10–2000 字符，库存/价格批量最多 1000 项，每项必须提供条形码。
使用方式
需要卖家自己的 API 凭证，可在 Trendyol 卖家面板：Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri（仅面板主用户可见）中找到，包括：Satıcı ID、API Key 和 API Secret。
请求使用 HTTP Basic 认证（key/secret），并使用 Trendyol 对自主集成所要求的 User-Agent：<sellerId> - SelfIntegration。
环境要求：Python 3.11+ 和 uv。
配置方式：添加到 claude_desktop_config.json 中。仅当希望写入工具生效时，才在 env 中添加 "TRENDYOL_ALLOW_WRITES": "true"。
建议先以只读方式运行，在信任该工作流后再设置 TRENDYOL_ALLOW_WRITES=true。对客户问题的回答是公开的，且每个问题只能发布一次。
get_orders 默认会隐藏客户姓名和完整收货地址，仅返回城市；当确实需要时，可在单次调用中传入 include_pii=true。get_customer_questions 和 get_claims 从不返回客户姓名。凭证仅来自环境变量，不会写入磁盘。
适用场景
适用于土耳其电商卖家通过 AI 助手处理日常店铺运营，包括产品管理、订单与退货查看、客户问答以及库存和价格调整。
限制
- 非官方：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。
本项目与 Trendyol 无关联，是 Koray Nar 的独立开源项目，使用自己的 API 凭证并自负责任。
