SkillHub

lcsc

v1.0.0

通过 camoufox-cli 浏览器自动化操作立创商城，完成元器件搜索、查看详情、加入购物车、BOM 配单、PCB/SMT 下单等操作。Use when 用户需要搜索立创商城元器件、查看商品详情、加入购物车、BOM 配单、PCB/SMT 下单、查看订单等立创商城操作。

Sourced from ClawHub, Authored by SinKy-Yan

Installation

Please help me install the skill `lcsc` from SkillHub official store. npx skills add SinKy-Yan/lcsc

立创商城浏览器自动化助手

适用场景

当用户的任务涉及以下立创商城相关操作时，必须通过 camoufox-cli 操作立创商城页面：

  • 搜索元器件（按型号、关键词、品牌）
  • 查看商品详情（参数、价格、库存、封装、数据手册）
  • 加入购物车
  • 查看/管理购物车
  • BOM 配单
  • PCB/SMT 下单
  • 查看订单状态、物流信息
  • 查看优惠券、PLUS 会员权益
  • 任何涉及立创商城的页面操作

如何调用

camoufox-cli 路径: /opt/homebrew/bin/camoufox-cli

必须使用上面的完整路径调用 camoufox-cli（它可能不在默认 PATH 中）。

# 打开立创商城首页
/opt/homebrew/bin/camoufox-cli open "https://www.szlcsc.com/"

# 获取当前页面 URL 和标题
/opt/homebrew/bin/camoufox-cli url
/opt/homebrew/bin/camoufox-cli title

# 获取页面交互元素（aria 树）
/opt/homebrew/bin/camoufox-cli snapshot -i

# 点击元素（使用 ref）
/opt/homebrew/bin/camoufox-cli click @e123

# 填写输入框（先清空再输入）
/opt/homebrew/bin/camoufox-cli fill @e456 "NE555"

# 输入文本（不清空）
/opt/homebrew/bin/camoufox-cli type @e456 "NE555"

# 按下按键（如 Enter）
/opt/homebrew/bin/camoufox-cli press Enter

# 滚动页面
/opt/homebrew/bin/camoufox-cli scroll down 500

# 等待元素加载或 URL 变化
/opt/homebrew/bin/camoufox-cli wait @e123
/opt/homebrew/bin/camoufox-cli wait --url https://www.szlcsc.com/search?q=NE555

# 获取元素文本
/opt/homebrew/bin/camoufox-cli text @e123

# 执行 JavaScript
/opt/homebrew/bin/camoufox-cli eval "document.title"

常用工作流程

1. 搜索元器件

# 打开立创商城首页
/opt/homebrew/bin/camoufox-cli open "https://www.szlcsc.com/"

# 等待搜索框加载
/opt/homebrew/bin/camoufox-cli wait @e123

# 填写搜索框并按回车搜索
/opt/homebrew/bin/camoufox-cli fill @e123 "NE555"
/opt/homebrew/bin/camoufox-cli press Enter

# 等待搜索结果加载
/opt/homebrew/bin/camoufox-cli wait --url https://www.szlcsc.com/search?q=NE555

# 获取搜索结果页面元素
/opt/homebrew/bin/camoufox-cli snapshot -i

2. 查看商品详情

# 点击商品链接
/opt/homebrew/bin/camoufox-cli click @e456

# 等待详情页加载
/opt/homebrew/bin/camoufox-cli wait --url https://item.szlcsc.com/

# 获取详情页文本或元素
/opt/homebrew/bin/camoufox-cli text @e789
/opt/homebrew/bin/camoufox-cli snapshot -i

3. 加入购物车

# 在商品详情页选择数量、规格
/opt/homebrew/bin/camoufox-cli fill @e123 "10"

# 点击“加入购物车”按钮
/opt/homebrew/bin/camoufox-cli click @e456

# 等待操作完成
/opt/homebrew/bin/camoufox-cli wait 2000

4. BOM 配单

# 打开 BOM 配单页面
/opt/homebrew/bin/camoufox-cli open "https://bom.szlcsc.com/bom.html"

# 等待页面加载
/opt/homebrew/bin/camoufox-cli wait @e123

# 上传 BOM 表或填写型号
# ...（根据页面元素操作）

5. PCB/SMT 下单

# 打开 PCB 下单页面
/opt/homebrew/bin/camoufox-cli open "https://www.jlc.com/newOrder/#/pcb/pcbPlaceOrder"

# 等待页面加载
/opt/homebrew/bin/camoufox-cli wait @e123

# 填写参数、上传文件
# ...（根据页面元素操作）

camoufox-cli 常用命令速查

命令 用途 关键参数
open 导航到 URL url
back 返回上一页 -
forward 前进到下一页 -
reload 刷新页面 -
url 打印当前 URL -
title 打印页面标题 -
snapshot [-i] [-s sel] 获取页面元素树 -i: 交互模式, -s: 限定范围
click @ref 点击元素 ref
fill @ref "text" 清空输入框并输入文本 ref, text
type @ref "text" 不清空直接输入文本 ref, text
select @ref "option" 选择下拉选项 ref, option
check @ref 切换复选框 ref
hover @ref 悬停在元素上 ref
press 按下按键 key (如 Enter, Control+a)
text @ref|selector 获取元素文本内容 ref 或 selector
eval "js expression" 执行 JavaScript js 表达式
screenshot [--full] [f] 截图到文件或 stdout --full: 全屏, f: 文件路径
pdf 保存页面为 PDF 文件路径
scroll [px] 滚动页面 dir: up/down, px: 像素数（默认 500）
wait <ms|@ref|--url p> 等待时间/元素/URL ms: 毫秒数, @ref: 元素, --url: URL
tabs 列出打开的标签页 -
switch 切换标签页 标签页索引
close-tab 关闭当前标签页 -
sessions 列出活动会话 -
cookies [import|export] 管理 cookies import/export

注意事项

  • 点击或导航后需等待页面加载（使用 wait 命令），再读取新内容
  • 使用 snapshot -i 获取交互元素树，找到合适的 ref 再操作
  • fill 命令会先清空输入框再输入，适合搜索框等场景
  • type 命令不会清空输入框，适合追加内容
  • 优先使用 camoufox-cli 的专用命令（snapshot, click, fill 等），eval 作为补充