多平台加购物车 Skill#

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

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

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

---

前置条件#

1. Brave 浏览器 以远程调试模式运行： bash

   /Applications/Brave\ Browser.app/Contents/MacOS/Brave\ Browser --remote-debugging-port=9222
   
   

2. 各平台已登录（淘宝/拼多多/闲鱼必须，京东建议）

3. brave-browser-agent skill 已激活（提供 cdp_exec.py）

---

快速开始#

bash

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

---

通用工作流程#

text

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

每步操作后 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 不正确购物车显示"请选择款式"，重新提取选择器失效先截图查看实际页面，按文字匹配按钮

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

javascript

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统一搜索脚本