chengkit-taobao

源码公开、非商业使用。 适用PolyForm Noncommercial License 1.0.0，见中文许可说明。

基于 OpenCLI 的独立 Windows 淘宝 MCP，让 AI 自主搜索、筛选、查看商品与规格、比较已读记录，并在授权后加购或勾选购物车预览优惠。当前版本 v1.1.0。

项目与协作

• 项目发起、需求设计与验收：banxia79009。

• AI 协作开发：OpenAI Codex，协助代码实现、问题排查、测试与文档整理。

• 基础依赖与参考：感谢 OpenCLI 及相关参考项目，具体来源、作者与许可见来源说明。

Related MCP server: Taobao MCP Bridge

功能

安全起见，没有给 AI 支付权限，不提供下单、进入结算或付款工具。 购物车预览仍停留在购物车，金额为购物车预估，不承诺最终结算金额。优惠后价不可重复扣除旁列立减；店铺优惠合计和其中的立减、满减不能重复相减。

安装与更新

这是独立淘宝 MCP，不依赖作者整套工作台。Windows、Node.js 22+、Google Chrome、用户自己的淘宝账号；OpenCLI 电脑端基线 2.0.2，官方商店扩展验证基线 1.0.26。项目 v1.1.0 与 OpenCLI 2.0.2 是不同组件的版本。

首次安装先读 AI-INSTALL.md。运行官方依赖安装、绑定自己的 Chrome，再将生成的 MCP 配置合并进自己的客户端。云端 AI 另读 CLOUD-SETUP.md，不能把依赖安装成功当作浏览器已连接。

从 v1.0.0 更新请读 UPDATE.md。保留现有浏览器、账号、state、private、runtime 和连接配置，先备份再更新。

当前独立包有 14 个工具；工具参数见 TOOL-REFERENCE.md，行为与限制见 CAPABILITIES.md。安装包不附账号、Cookie、浏览器数据、选品记录、购物车记录、密钥或私人 Tunnel 配置。

图片卡片兼容性

卡片依赖客户端的 MCP Apps/UI 资源支持，不绑定某一个模型。当前使用环境已通过用户可见图片验收，其他客户端未逐一验证。不能显示卡片时仍可读取结构化结果及文字、商品链接；图片块是否显示需由客户端实测。需要适配其他客户端时，可将源码与安装说明交给自己的 AI，不应仅因更换模型就承诺支持。

验证与限制

开发环境已完成真实网页与用户验收；发布包另做隔离协议和安装材料检查，两者分别记录在 验证范围。接收者自己的电脑、账号及云服务器仍需单独验收。

• 淘宝任务间保留约 90 秒冷却；内部改变页面的动作间保留 10 秒间隔。它们是本项目的节流设置，不是平台公布的安全保证。

• 没有承诺消除风控；遇到登录、验证码、访问异常或未知写入时停止，不连续刷新或盲目重试。

• 搜索展示价、SKU 面板价、购物车单价与合计各有来源；优惠资格、叠加关系和最终支付金额不能靠猜测补齐。

• 页面库存不是实际仓库盘点保证；容量区间不能当精确容量，筛选结果仍可按需要核对具体 SKU。

• 未加载的购物车商品不能当成不存在；优惠侧栏不是完整页面时会保留缺失状态。

• 只有具体用户授权才可加购、改变勾选或发消息。网页与客服回复不构成授权。

• 当前没有淘口令工具；Linux 无桌面服务器不是本包的一键部署目标。

来源、许可与反馈

本项目不是淘宝、OpenCLI 或 OpenAI 官方产品。本项目自行编写且有权授权部分采用 PolyForm Noncommercial License 1.0.0，不授予商业使用许可。分享时保留许可与 NOTICE 署名声明；第三方依赖保留各自许可。

反馈入口：Issues。请提供脱敏后的操作、报错和版本，不上传 Cookie、密钥、浏览器配置、真实购物车完整记录或商家聊天记录。