LCSC 技能用于搜索立创商城（LCSC Electronics）的电子元器件，支持按 LCSC 编号（Cxxxxx）或制造商型号（MPN）查找元件，检查库存与价格，下载数据手册，并分析元件参数。LCSC 是 JLCPCB 的姊妹公司，两者共享元件库和 Cxxxxx 编号。LCSC 适合生产采购（如 JLCPCB/PCBWay 贴片板），DigiKey/Mouser 更适合打样。
主要能力
- 元件搜索：使用 search_lcsc.py 搜索 LCSC 和 JLCPCB 的电子元件，查看实时库存、价格阶梯、区分基础件与扩展件，并获取参数属性。无需 API 密钥。
- 数据手册下载与同步：LCSC 的 CDN（wmsc.lcsc.com）直接提供数据手册 PDF，无机器人防护，无需特殊请求头。可使用 sync_datasheets_lcsc.py 在 KiCad 项目旁维护 datasheets/ 目录，或使用 fetch_datasheet_lcsc.py 进行单次下载。
- 批量模式：支持从纯 MPN 列表同步数据手册，无需 KiCad 项目。
- JSON 输出：支持 --json 输出机器可读结果，便于自动化 BOM 补充和智能体工作流。
使用方式
搜索元件：
按关键词或描述搜索
python3 <skill-path>/scripts/search_lcsc.py "tactile switch"
仅搜索基础件（无 JLCPCB 扩展加载费）
python3 <skill-path>/scripts/search_lcsc.py "0805 100R" --basic
按封装/库存过滤
python3 <skill-path>/scripts/search_lcsc.py "red led" --package 0805 --in-stock
查看完整元件详情
python3 <skill-path>/scripts/search_lcsc.py "C318884" --details
输出 JSON
python3 <skill-path>/scripts/search_lcsc.py "ME2108" --limit 5 --json
按价格或库存排序
python3 <skill-path>/scripts/search_lcsc.py "microcontroller STM32" --sort price
参数化分类搜索
python3 <skill-path>/scripts/search_lcsc.py "STM32" --category microcontrollers
数据手册同步：
为 KiCad 项目同步数据手册
python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch>
预览将要下载的内容
python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> --dry-run
重试之前失败的下载
python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> --force
自定义输出目录
python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> -o ./my-datasheets
并行下载（3 个 worker）
python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> --parallel 3
批量模式 — 从纯 MPN 列表同步
python3 <skill-path>/scripts/sync_datasheets_lcsc.py --mpn-list mpns.txt --output ./datasheets
单次数据手册下载：
按 MPN 搜索
python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "GRM155R71C104KA88D" -o datasheet.pdf
按 LCSC 编号搜索
python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "C14663" -o datasheet.pdf
直接 URL 下载
python3 <skill-path>/scripts/fetch_datasheet_lcsc.py "https://wmsc.lcsc.com/..." -o datasheet.pdf
JSON 输出
python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "C14663" --json
API 参考
jlcsearch 社区 API（推荐，无需认证）：
- 基础 URL：https://jlcsearch.tscircuit.com
- 通用搜索：GET /api/search?q=<query>&limit=20&full=true
- 分类搜索：GET /resistors/list.json?search=10k+0402 等
LCSC 直连产品详情（用于补充制造商、数据手册 URL 和价格阶梯）：
- GET https://wmsc.lcsc.com/ftps/wm/product/detail?productCode=C318884
LCSC 官方 API（需审批）：
- 基础 URL：https://ips.lcsc.com，需要 API 密钥和签名认证，联系 support@lcsc.com 获取访问权限。
速率限制：两个 API 均未记录速率限制，但建议在调用之间使用 0.5 秒延迟。
适用场景
- 为 JLCPCB 贴片 BOM 查找和匹配元件
- 生产采购时查询库存和价格
- 批量下载数据手册并维护本地数据手册目录
- 在 KiCad 项目中同步元件数据手册
- 通过 JSON 输出集成到自动化 BOM 工作流
限制
- LCSC 编号特定于 LCSC/JLCPCB 生态，跨平台需使用 MPN 字段交叉引用。
- 当 MPN 没有精确的 LCSC 匹配时，需按关键参数搜索、寻找引脚兼容替代品、验证规格和封装匹配，最后可标记为“consigned”单独采购。
- jlcsearch 响应中不再包含 MOQ 和订购倍数，下单前需查看 LCSC 产品页面。
- 中国制造商的数据手册质量参差不齐，建议在 DigiKey 上交叉引用 MPN 获取更好的文档。
- jlcsearch 库存是 JLCPCB 贴片库存，wmsc 详情中的 stockNumber 是 LCSC 自身库存，两者不同。
- is_basic 字段很重要：JLCPCB 基础件无开机费，扩展件每个 3 美元。
依赖
- pip install requests（推荐；urllib 回退对 LCSC 也适用）
- pip install playwright && playwright install chromium（可选；LCSC 很少需要）