核心用法
browser-commerce-base 是一套面向电商场景的浏览器自动化工作流 Skill，专为 OpenClaw 平台设计。其核心能力覆盖三大场景：公开商品浏览（无需登录）、私人账户操作（需登录态）以及跨平台比价。用户通过选择不同浏览器配置文件（openclaw 默认公开浏览，user 仅限登录态页面）实现风险隔离。
标准执行流程遵循"状态检查 → 站点聚焦 → 快照捕获 → 交互操作 → 证据留存"的闭环：
1. 启动或复用浏览器实例
2. 针对目标平台（淘宝、京东、拼多多、美团、饿了么、唯品会、SHEIN、大众点评等）打开稳定标签页
3. 使用 snapshot 捕获页面结构，优先采用 --interactive 模式获取稳定元素引用
4. 按优先级提取：平台标识 → 页面类型 → 商品标题 → 当前价格 → 券后/会员价 → 店铺信息 → 销量评价 → 物流承诺 → SKU 规格 → 风险提示
5. 关键节点截图存档，动态页面辅以 requests/errors/response body 诊断
页面类型专项策略
| 页面类型 | 核心目标 | 关键动作 |
|---------|---------|---------|
| 搜索结果页 | 快速多品比价 | 识别商品卡片、价格文本、店铺名、销量标签，结构化汇总 Top 候选 |
| 商品详情页 | 单品决策就绪 | 提取标题、多档位价格、服务标识、SKU 选择器，监控促销倒计时 |
| 购物车/订单/优惠券页 | 安全利用登录态 | 仅切换 `user` 配置，只读检查，禁止支付/下单等不可逆操作 |
| 地理位置敏感页 | 判断配送可行性 | 结合浏览器地理上下文，明确标注位置假设依赖 |
显著优点
1. 平台覆盖全面：原生适配国内主流电商生态，兼顾跨境平台（SHEIN）
2. 风险分层设计：openclaw/user 双配置强制隔离，默认不触碰私人账户
3. 交互稳定性优先：摒弃脆弱 CSS 选择器，依赖快照返回的可操作引用（actionable refs）
4. 证据链完整：价格变动、优惠券生效、库存状态均要求截图佐证
5. 动态页面容错：内置 requests/response body 抓包能力，应对前端渲染不全场景
潜在缺点与局限性
1. 平台反爬对抗：电商站点频繁更新 DOM 结构，可能导致快照元素失效
2. 登录态有效期：user 配置依赖本地浏览器 Cookies，跨会话可能需重新授权
3. 价格时效性：促销价格、优惠券库存实时变化，提取结果存在分钟级延迟
4. SKU 组合爆炸：复杂规格商品（如手机颜色×存储×套餐）需多轮交互，耗时增加
5. 地理围栏限制：部分平台配送判断需精确经纬度，浏览器模拟存在偏差
适合人群
- 理性消费者：大额采购前的跨平台比价需求
- 运营/买手：竞品监控、价格追踪、促销情报收集
- 自动化测试：电商前端回归验证、优惠券链路测试
- 研究分析：电商生态数据采样（需遵守 Robots 协议）
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 账户安全 | 登录态泄露、异常操作触发风控 | 默认使用 `openclaw`，登录操作明确提示用户 |
| 资金风险 | 误触支付、自动下单 | 硬性边界：禁止完成支付、禁止最终订单提交 |
| 法律合规 | 爬虫协议违规、数据滥用 | 仅提取公开可见信息，不涉及用户隐私数据爬取 |
| 结果误导 | 价格已变、优惠券失效 | 强制附带时间戳与截图，明确标注"截至提取时刻" |
安全边界（硬性约束）
- ❌ 不完成支付流程
- ❌ 不提交最终订单（无明确确认）
- ❌ 不修改账户设置、地址、支付方式（除非显式请求）
- ✅ 登录页面优先"观察+建议"而非直接操作