# KAEV 淘宝导购MCP v2.0

直调淘宝联盟官方API的MCP服务器。纯Python，零Node依赖，不经过任何第三方。

Kael for Vael.

## 环境变量

| 变量 | 必填 | 说明 |
|------|------|------|
| `TAOBAO_APP_KEY` | ✅ | 淘宝联盟开放平台 AppKey |
| `TAOBAO_APP_SECRET` | ✅ | AppSecret |
| `TAOBAO_SESSION` | 可选 | 授权session（部分接口需要） |
| `TAOBAO_ADZONE_ID` | 可选 | 推广位ID（PID最后一段） |
| `PORT` | 可选 | 监听端口，默认8080 |

## 部署

```bash
pip install fastmcp httpx

export TAOBAO_APP_KEY=你的appkey
export TAOBAO_APP_SECRET=你的appsecret
export TAOBAO_ADZONE_ID=你的adzone_id
python3 server.py
```

## 工具

| 工具 | 功能 | 对应API |
|------|------|------|
| `search_products` | 搜索商品 | taobao.tbk.dg.material.optional |
| `get_item_info` | 商品详情 | taobao.tbk.item.info.get |
| `create_tpwd` | 生成淘口令 | taobao.tbk.tpwd.create |
| `shorten_url` | 长链转短链 | taobao.tbk.spread.get |
| `activity_link` | 官方活动转链 | taobao.tbk.activity.info.get |
| `featured_products` | 精选物料 | taobao.tbk.dg.optimus.material |
| `server_info` | 服务器状态 | - |

## 权限要求

在淘宝联盟开放平台申请以下权限包：

- 16189 物料信息查询
- 16516 物料搜索
- 11655 淘口令生成
- 12340 长链转短链
- 18294 官方活动转链
- 16518 物料精选
- 27939 商品物料获取（可选）

## v1 → v2 变更

v1 通过 sinataoke npm包间接调用淘宝API。2026年9月6日 sinataoke 被npm安全团队接管（包替换为0.0.1-security，配置服务下线），整个生态不可用。

v2 直接调用淘宝联盟官方API（eco.taobao.com/router/rest），使用自有AppKey，MD5签名，纯Python实现。不依赖任何第三方包装服务。