[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1809":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":14,"lastSyncTime":28,"discoverSource":29},1809,"TaoBaoApis","cv-cat\u002FTaoBaoApis","cv-cat","淘宝算法逆向，淘宝api，websockets自动运营，淘宝AI Agent基座",null,"Python",200,85,1,2,0,8,11,39,24,5.8,false,"master",true,[],"2026-06-12 02:00:33","# 🎁 TaobaoApis — 淘宝第三方 API 集成库，AI 客服智能体底座\n\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.9%2B-blue)](https:\u002F\u002Fwww.python.org\u002F)\n[![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode.js-18%2B-green)](https:\u002F\u002Fnodejs.org\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-orange)](LICENSE)\n\n> **在 AI 大模型爆发的时代，每一个淘宝卖家都值得拥有一个 7×24 小时不下线的智能客服。**\n> 本项目封装了淘宝平台完整的消息通信能力，为开发者构建 AI 客服智能体提供可靠、稳定的底层 API 支撑。\n\n**⚠️ 严禁用于发布不良信息、违法内容！如有侵权请联系作者删除。**\n\n---\n\n## 为什么需要这个项目？\n\n```\n用户私信 ──► [TaobaoApis] ──► 你的 AI Agent（LLM \u002F RAG \u002F 规则引擎）──► 自动回复\n               ▲                                                          │\n               └──────────────── 发送消息 \u002F 图片 ◄────────────────────────┘\n```\n\n淘宝官方没有开放 IM 消息接口。想要接入 GPT、Claude、本地大模型来做智能客服，首先需要能**稳定收发消息**。TaobaoApis 解决的正是这个前置问题：\n\n- 逆向还原了淘宝 WebSocket 私信协议（sign 签名 + base64 + Protobuf）\n- 封装全部 HTTP 接口（sign 参数已解密）\n- 提供统一的消息收发抽象层，开发者只需关注业务逻辑\n\n**你负责接 AI 大脑，我们负责打通淘宝的神经。**\n\n---\n\n## 已实现功能\n\n| 模块 | 功能 | 状态 |\n|------|------|------|\n| HTTP API | 淘宝所有 HTTP 接口（sign 签名已解密） | ✅ |\n| WebSocket | 私信实时收发（sign + base64 + Protobuf 协议） | ✅ |\n| 消息类型 | 文字、图片消息 | ✅ |\n| 会话管理 | 获取全部历史聊天记录 | ✅ |\n| 主动发送 | 主动向指定用户发消息 | ✅ |\n| Token 维持 | 自动刷新登录态，常驻进程不掉线 | ✅ |\n| 获取聊天记录 | 获取与指定用户的历史消息记录 | ✅ |\n| 商品信息 | 获取商品详情 | ✅ |\n| 媒体上传 | 上传图片并发送 | ✅ |\n\n---\n\n## 快速开始\n\n### 环境要求\n\n- Python 3.9+\n- Node.js 18+（用于执行签名算法 JS）\n\n### 安装依赖\n\n```bash\npip install -r requirements.txt\n```\n\n### 配置 Cookie\n\n登录 [taobao.com](https:\u002F\u002Fwww.taobao.com) 后，从浏览器开发者工具中复制完整 Cookie 字符串，填入代码对应位置：\n\n```python\n# taobao_live.py 底部\ncookies_str = r'your_cookie_string_here'\n```\n\n> Cookie 必须是**登录后的状态**，否则无法获取消息。\n\n\n### 直接运行\n\n```bash\npython taobao_live.py\n```\n\n---\n\n## 项目结构\n\n```\nTaobaoApis\u002F\n├── taobao_live.py       # 主入口：WebSocket 消息监听 & 回复逻辑（在此接入 AI）\n├── taobao_apis.py       # HTTP API 封装（登录、刷新 Token、商品详情、上传媒体）\n├── message\u002F\n│   ├── types.py         # 消息类型定义（TextContent \u002F ImageContent \u002F AudioContent）\n├── utils\u002F\n│   └── taobao_utils.py  # 工具函数（sign 签名、Cookie 处理、消息解密）\n├── static\u002F\n│   └── taobao_js_*.js   # 逆向 JS（sign 签名核心算法）\n├── requirements.txt\n└── Dockerfile\n```\n\n---\n\n## 接入 AI 智能体\n\n在 `taobao_live.py` 的 `handle_message` 方法中替换回复逻辑即可：\n\n```python\nasync def handle_message(self, message, websocket):\n    # ... 解析 send_user_id, cid, send_message ...\n\n    # 原始 echo 回复（示例）\n    # reply = f'{send_user_name} 说了: {send_message}'\n\n    # 接入 AI 大模型（示例）\n    reply = await your_ai_agent(send_message)          # GPT \u002F Claude \u002F Qwen \u002F 本地模型\n\n    await self.send_msg(websocket, cid, send_user_id, make_text(reply))\n```\n\n---\n\n## 注意事项\n\n- `taobao_live.py` 是消息收发主入口，所有 AI 回复逻辑在此扩展\n- `taobao_apis.py` 包含 HTTP 接口模板，可按需添加其他接口\n\n---\n\n## 参与贡献\n\n欢迎任何形式的贡献！无论是修复 Bug、新增接口、完善文档还是分享你基于本项目构建的 AI 应用，PR 随时欢迎。\n\n**提交 PR 前请确认：**\n\n- 代码风格与现有代码保持一致\n- 新增接口请附上简要说明（接口用途、入参、返回示例）\n- 如果改动较大，建议先开 Issue 讨论方案\n\n**你也可以通过 Issue 来：**\n\n- 反馈 Bug 或接口失效\n- 提出新功能建议\n- 分享使用中遇到的问题\n\n---\n\n## 额外说明\n\n1. 感谢 Star ⭐ 和 Follow，项目会持续更新\n2. 作者联系方式在主页，有问题随时联系\n3. 欢迎 PR 和 Issue，也欢迎关注作者其他项目\n4. 如果此项目对您有帮助，欢迎请作者喝一杯奶茶 ~~\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FSpider_XHS\u002Fblob\u002Fmaster\u002Fauthor\u002Fwx_pay.png\" width=\"380px\" alt=\"微信赞赏码\">\n  \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fcv-cat\u002FSpider_XHS\u002Fblob\u002Fmaster\u002Fauthor\u002Fzfb_pay.jpg\" width=\"380px\" alt=\"支付宝收款码\">\n\u003C\u002Fdiv>\n\n---\n\n## Star 趋势\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#cv-cat\u002FTaoBaoApis&Date\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=cv-cat\u002FTaoBaoApis&type=Date&theme=dark\" \u002F>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=cv-cat\u002FTaoBaoApis&type=Date\" \u002F>\n    \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=cv-cat\u002FTaoBaoApis&type=Date\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n\n\n\n## 🍔 交流群\n\n如果你对爬虫和 AI Agent 感兴趣，请加作者主页 wx 通过邀请加入群聊\n\nps: 请加群14、15，人满或者过期 issue | wx 提醒\n\n![group14](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F736fa3a2-1e7d-4681-af5e-c15dbefde1cd)\n\n![group15](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdbc24f80-4307-46d7-ae83-98d694a306b6)\n\n","TaobaoApis 是一个淘宝第三方 API 集成库，为开发者提供构建 AI 客服智能体所需的底层支持。项目核心功能包括逆向还原的淘宝 WebSocket 私信协议（支持 sign 签名、base64 和 Protobuf）以及封装的所有 HTTP 接口（已解密 sign 参数）。它还提供了统一的消息收发抽象层，简化了消息处理流程。此外，该项目支持文字和图片消息的实时收发、会话管理、主动发送消息、自动刷新登录态等功能。适合需要在淘宝平台上实现 7×24 小时在线智能客服的应用场景，特别是结合 GPT、Claude 或本地大模型进行智能回复的情况。","2026-06-11 02:46:09","CREATED_QUERY"]