ClawHub

Add to Cart (Multi-Platform)

Other

多平台电商加购物车/收藏自动化工具。通过 Brave Browser CDP 搜索商品并加入购物车（淘宝/京东）、收藏（拼多多）、或标记"想要"（闲鱼）。依赖 brave-browser-agent skill。不涉及支付，只做到加购/收藏为止。Not for: 价格比较、下单支付、商品推荐、订单管理。

Install

openclaw skills install @mayf3/add-to-cart

多平台加购物车 Skill

通过 Brave Browser Agent CDP 协议，自动化多电商平台搜索和加购/收藏。

支持: 淘宝（加购）、京东（加购）、拼多多（收藏）、闲鱼（想要）

⚠️ 只做到加购/收藏，不涉及支付。 下单付款由用户自己完成。

前置条件

  1. Brave 浏览器 以远程调试模式运行： 
    /Applications/Brave\ Browser.app/Contents/MacOS/Brave\ Browser --remote-debugging-port=9222
  2. 各平台已登录（淘宝/拼多多/闲鱼必须，京东建议）
  3. brave-browser-agent skill 已激活（提供 cdp_exec.py）

快速开始

SKILL_DIR="~/.openclaw/groups/workspace-oc_96ba3f8c3476edac2fb64ee89f842f4e/skills/brave-browser-agent"
CART_DIR="~/.openclaw/groups/workspace-oc_96ba3f8c3476edac2fb64ee89f842f4e/skills/add-to-cart"

# 1. 列出浏览器 tab
python3 $SKILL_DIR/scripts/cdp_exec.py list

# 2. 快捷搜索（任选平台）
$CART_DIR/scripts/add_to_cart.sh taobao "牛奶" price-asc
$CART_DIR/scripts/add_to_cart.sh jd "耳机" price-asc
$CART_DIR/scripts/add_to_cart.sh pdd "玩具"
$CART_DIR/scripts/add_to_cart.sh xianyu "二手书"

# 3. 查看结果
python3 $SKILL_DIR/scripts/cdp_exec.py eval <tab_id> "document.body.innerText.substring(0, 8000)"
python3 $SKILL_DIR/scripts/cdp_exec.py screenshot <tab_id> /tmp/result.png

通用工作流程

搜索商品 → 浏览结果 → 进入详情 → 选择规格 → 加购/收藏 → 验证

每步操作后 sleep 3（搜索/跳转 sleep 5），用 screenshot + innerText 确认。

各平台要点

淘宝 ⚠️ 必须用 API 加购

点击按钮方式会被反爬拦截（显示"成功"但未实际加购）。必须用 API 方式：

  1. 详情页选规格 → 提取 SKU ID（从 script 标签 JSON）
  2. 导航到 cart.taobao.com（同域确保登录态）
  3. 从 cookie 获取 _tb_token_
  4. 调用 https://cart.taobao.com/add_cart_item.htm?item_id=<ID>&sku_id=<SKU>&quantity=1&_tb_token_=<TOKEN>
  5. 验证返回 cartQuantity 增加

天猫详情页：按钮是动态 JS，需从 script[44] 提取 SKU 数据（skuBase.props + skuBase.skus）。

📖 完整操作代码见 references/platform-guides.md#淘宝

京东

  • 底部按钮区 .bottom-btns-root 包含"加入购物车"
  • 购物车数量 badge 可验证成功
  • 第三方商家页面结构可能不同

📖 完整操作代码见 references/platform-guides.md#京东

拼多多（收藏）

  • 无购物车，操作目标是"收藏"
  • 用移动版 mobile.yangkeduo.com 更稳定
  • SPAN innerText === '收藏' 匹配（已验证可靠）
  • 需 scrollIntoView + setTimeout(500ms)

📖 完整操作代码见 references/platform-guides.md#拼多多

闲鱼（想要）

  • 页面结构变化频繁，多用截图
  • "想要"按钮可能打开聊天界面（正常）

📖 完整操作代码见 references/platform-guides.md#闲鱼

常见问题速查

问题解决
淘宝加购"成功"但购物车为空用 API 方式，不要点击按钮
滑块验证码用户手动完成，间隔 5-10 秒再操作
频繁访问限制sleep 5，每分钟不超过 5 次操作
登录态失效浏览器中手动重新登录
SKU ID 不正确购物车显示"请选择款式"，重新提取
选择器失效先截图查看实际页面，按文字匹配按钮

通用按钮匹配（选择器失效时）：

const buttons = [...document.querySelectorAll('button, a, span, div')];
const target = buttons.find(b => b.innerText.includes('加入购物车'));
if (target) { target.click(); 'clicked'; } else { 'not found'; }

操作规范

  1. 每次操作前 list 获取最新 tab
  2. 操作后 sleep 3-5 等待加载
  3. 截图保存到 /tmp/ 目录
  4. 不要连续快速操作：每次点击后等 2-3 秒，搜索间隔 5 秒，同平台每分钟 ≤5 次
  5. 双重确认：screenshot + innerText

参考文档

文件内容
references/platform-guides.md各平台完整操作代码和注意事项
references/platform-selectors.mdCSS 选择器速查表
references/experience-log.md历史操作经验记录
scripts/add_to_cart.sh统一搜索脚本