lcsc

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

LCSC Electronics — Component Search, Datasheets & Ordering

LCSC Electronics — 元件搜索、Datasheet下载与订购

Related Skills

Skill	Purpose
`kicad`	Schematic analysis — extracts MPNs for part lookup
`bom`	BOM management — orchestrates sourcing across distributors
`jlcpcb`	PCB assembly — shares the same parts library
`spice`	Uses LCSC parametric data for behavioral SPICE models (no auth needed)

技能	用途
`kicad`	原理图分析——提取MPN用于元件查找
`bom`	BOM管理——协调多分销商采购
`jlcpcb`	PCB装配——共享同一元件库
`spice`	使用LCSC参数数据构建行为SPICE模型（无需授权）

Key Differences from DigiKey/Mouser

与DigiKey/Mouser的主要区别

No API key needed — jlcsearch community API is free and open
Lower prices — especially for passives and Chinese-manufactured ICs
JLCPCB integration — same LCSC part numbers used in JLCPCB assembly BOMs
Direct PDF downloads — LCSC's CDN (wmsc.lcsc.com) serves datasheets without bot protection
Low MOQ — many parts available in quantities as low as 1
Warehouses — Shenzhen (JS), Zhuhai (ZH), Hong Kong (HK)
Website:
```
https://www.lcsc.com
```

无需API密钥——jlcsearch社区API免费开放
价格更低——尤其是无源元件和国产IC
JLCPCB集成——JLCPCB装配BOM中使用相同的LCSC元件编号
直接PDF下载——LCSC的CDN（wmsc.lcsc.com）提供datasheet下载，无机器人防护
最低起订量（MOQ）低——许多元件起订量低至1件
仓库分布——深圳（JS）、珠海（ZH）、香港（HK）
官网：
```
https://www.lcsc.com
```

LCSC Part Numbers

LCSC元件编号

Format:

Cxxxxx

(e.g.,

C14663

). This is the universal identifier across both LCSC and JLCPCB. Use it for:

Direct ordering on LCSC
BOM matching in JLCPCB assembly (see
```
jlcpcb
```
skill)
Cross-referencing between platforms

格式：

Cxxxxx

（例如

C14663

）。这是LCSC和JLCPCB通用的标识符，可用于：

在LCSC直接订购
JLCPCB装配中的BOM匹配（查看
```
jlcpcb
```
技能）
跨平台交叉参考

jlcsearch API Reference

jlcsearch API参考

The jlcsearch community API is the recommended way to search LCSC. No authentication required.

Base URL:

https://jlcsearch.tscircuit.com

jlcsearch社区API是搜索LCSC的推荐方式。无需身份验证。

基础URL：

https://jlcsearch.tscircuit.com

General Search

通用搜索

GET /api/search?q=<query>&limit=20&full=true

Parameters:

```
q
```
— search query (matches MPN, LCSC code, or description keywords)
```
package
```
— optional footprint filter (e.g.,
```
0402
```
)
```
limit
```
— max results (default 100)
```
full
```
— set to
```
true
```
to include all fields (datasheet URL, specs, stock per warehouse)

GET /api/search?q=<query>&limit=20&full=true

参数：

```
q
```
——搜索查询（匹配MPN、LCSC编码或描述关键词）
```
package
```
——可选封装筛选器（例如
```
0402
```
）
```
limit
```
——最大结果数（默认100）
```
full
```
——设为
```
true
```
可包含所有字段（datasheet URL、规格参数、各仓库库存）

Category-Specific Search

分类特定搜索

GET /resistors/list.json?search=10k+0402
GET /capacitors/list.json?search=100nF+0402
GET /microcontrollers/list.json?search=STM32
GET /voltage_regulators/list.json?search=3.3V

GET /resistors/list.json?search=10k+0402
GET /capacitors/list.json?search=100nF+0402
GET /microcontrollers/list.json?search=STM32
GET /voltage_regulators/list.json?search=3.3V

Response Format

响应格式

Results are returned as

{"components": [...]}

. With

full=true

, each component has:

json

{
  "lcsc": 14663,
  "mfr": "GRM155R71C104KA88D",
  "package": "0402",
  "description": "",
  "datasheet": "https://www.lcsc.com/datasheet/...",
  "stock": 2751535,
  "price": [{"qFrom": 1, "qTo": 9, "price": 0.0069}, ...],
  "basic": 0,
  "extra": {
    "number": "C71629",
    "mpn": "GRM155R71C104KA88D",
    "manufacturer": {"id": 4, "name": "Murata Electronics"},
    "package": "0402",
    "description": "16V 100nF X7R ±10% 0402 ...",
    "quantity": 2751535,
    "whs-js": 1234567,
    "whs-zh": 567890,
    "whs-hk": 0,
    "moq": 100,
    "order_multiple": 100,
    "packaging": "Tape & Reel (TR)",
    "packaging_num": 10000,
    "datasheet": {"pdf": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/...pdf"},
    "images": [{"96x96": "...", "224x224": "...", "900x900": "..."}],
    "rohs": true,
    "url": "https://www.lcsc.com/product-detail/...",
    "attributes": {
      "Capacitance": "100nF",
      "Voltage Rated": "16V",
      "Temperature Coefficient": "X7R",
      "Tolerance": "±10%"
    },
    "prices": [{"min_qty": 100, "max_qty": 499, "currency": "USD", "price": 0.0048}, ...]
  }
}

Key fields:

```
lcsc
```
— numeric LCSC ID (without "C" prefix)
```
extra.number
```
— full LCSC code with prefix (e.g.,
```
C71629
```
)
```
extra.mpn
```
— manufacturer part number
```
extra.manufacturer.name
```
— manufacturer
```
extra.datasheet.pdf
```
— direct PDF URL (wmsc.lcsc.com CDN, downloads without auth)
```
extra.attributes
```
— parametric specs (capacitance, voltage, etc.)
```
extra.quantity
```
— total stock across all warehouses
```
extra.whs-js
```
,
```
extra.whs-zh
```
,
```
extra.whs-hk
```
— stock per warehouse
```
basic
```
—
```
1
```
if JLCPCB basic part (no setup fee),
```
0
```
if extended
```
extra.moq
```
— minimum order quantity
```
extra.order_multiple
```
— must order in multiples of this
```
extra.rohs
```
— RoHS compliance (boolean)

结果以

{"components": [...]}

形式返回。当

full=true

时，每个元件包含：

json

{
  "lcsc": 14663,
  "mfr": "GRM155R71C104KA88D",
  "package": "0402",
  "description": "",
  "datasheet": "https://www.lcsc.com/datasheet/...",
  "stock": 2751535,
  "price": [{"qFrom": 1, "qTo": 9, "price": 0.0069}, ...],
  "basic": 0,
  "extra": {
    "number": "C71629",
    "mpn": "GRM155R71C104KA88D",
    "manufacturer": {"id": 4, "name": "Murata Electronics"},
    "package": "0402",
    "description": "16V 100nF X7R ±10% 0402 ...",
    "quantity": 2751535,
    "whs-js": 1234567,
    "whs-zh": 567890,
    "whs-hk": 0,
    "moq": 100,
    "order_multiple": 100,
    "packaging": "Tape & Reel (TR)",
    "packaging_num": 10000,
    "datasheet": {"pdf": "https://wmsc.lcsc.com/wmsc/upload/file/pdf/v2/lcsc/...pdf"},
    "images": [{"96x96": "...", "224x224": "...", "900x900": "..."}],
    "rohs": true,
    "url": "https://www.lcsc.com/product-detail/...",
    "attributes": {
      "Capacitance": "100nF",
      "Voltage Rated": "16V",
      "Temperature Coefficient": "X7R",
      "Tolerance": "±10%"
    },
    "prices": [{"min_qty": 100, "max_qty": 499, "currency": "USD", "price": 0.0048}, ...]
  }
}

关键字段：

```
lcsc
```
——数字格式的LCSC ID（不含“C”前缀）
```
extra.number
```
——带前缀的完整LCSC编码（例如
```
C71629
```
）
```
extra.mpn
```
——制造商零件编号
```
extra.manufacturer.name
```
——制造商名称
```
extra.datasheet.pdf
```
——直接PDF URL（wmsc.lcsc.com CDN，无需授权即可下载）
```
extra.attributes
```
——参数规格（电容值、电压等）
```
extra.quantity
```
——所有仓库总库存
```
extra.whs-js
```
,
```
extra.whs-zh
```
,
```
extra.whs-hk
```
——各仓库库存
```
basic
```
——若为JLCPCB基础元件则为
```
1
```
（无设置费），扩展元件则为
```
0
```
```
extra.moq
```
——最低起订量
```
extra.order_multiple
```
——必须按此倍数订购
```
extra.rohs
```
——RoHS合规性（布尔值）

Rate Limits

速率限制

The jlcsearch API is community-run with no documented rate limits, but be respectful — use delays of 0.5s between calls.

jlcsearch API由社区运营，无文档记录的速率限制，但请合理使用——调用间隔保持0.5秒。

Datasheet Download & Sync

Datasheet下载与同步

LCSC's CDN serves datasheet PDFs directly — no bot protection, no special headers needed. This makes LCSC a reliable datasheet source alongside DigiKey.

LCSC的CDN直接提供datasheet PDF下载——无机器人防护，无需特殊请求头。这使得LCSC成为DigiKey之外可靠的datasheet来源。

Datasheet Directory Sync

Datasheet目录同步

Use

sync_datasheets_lcsc.py

to maintain a

datasheets/

directory alongside a KiCad project. Same workflow and

manifest.json

format as the DigiKey and Mouser skills. No API key required.

bash

undefined

使用

sync_datasheets_lcsc.py

脚本为KiCad项目维护

datasheets/

目录。工作流和

manifest.json

格式与DigiKey和Mouser技能相同。无需API密钥。

bash

undefined

Sync datasheets for a KiCad project

同步KiCad项目的datasheet

python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch>

Preview what would be downloaded

预览将要下载的内容

python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> --dry-run

Retry previously failed downloads

重试之前下载失败的文件

python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> --force

Custom output directory

自定义输出目录

python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> -o ./my-datasheets

Parallel downloads (3 workers)

并行下载（3个工作进程）

python3 <skill-path>/scripts/sync_datasheets_lcsc.py <file.kicad_sch> --parallel 3

Batch mode — sync from a plain MPN list (no KiCad project required)

批量模式——从纯MPN列表同步（无需KiCad项目）

python3 <skill-path>/scripts/sync_datasheets_lcsc.py --mpn-list mpns.txt --output ./datasheets


**MPN-list batch mode** (KH-312) — when you have a list of MPNs but no
KiCad project to point at. One MPN per line; blank lines and `#`
comments (full-line and inline) are skipped; generic values are filtered
via `is_real_mpn()` and de-duplicated. Output defaults to `./datasheets/`
in the current working directory when `--output` is omitted.

The script:
- **Runs the kicad schematic analyzer** to extract components, MPNs, and LCSC codes
- **Accepts any identifier** — MPN, LCSC code, or other distributor PNs from KiCad symbol properties
- **Prefers LCSC code** for search (exact match) — falls back to MPN keyword search
- **Falls back to wmsc.lcsc.com API** when jlcsearch has no results for an LCSC code (Cxxxxx)
- **Downloads from LCSC CDN** — direct PDF URLs, no bot protection
- **Writes `manifest.json` manifest** — same format as DigiKey/Mouser skills
- **Verifies PDF content** — checks MPN, manufacturer, and description keywords
- **Rate-limited** — 0.5s between API calls (configurable with `--delay`)
- **Saves progress incrementally** — safe to interrupt

python3 <skill-path>/scripts/sync_datasheets_lcsc.py --mpn-list mpns.txt --output ./datasheets


**MPN列表批量模式**（KH-312）——当你有MPN列表但没有对应的KiCad项目时使用。每行一个MPN；空行和`#`注释（整行或行内）会被跳过；通用值会通过`is_real_mpn()`过滤并去重。若省略`--output`参数，默认输出到当前工作目录的`./datasheets/`。

该脚本：
- **运行KiCad原理图分析器**提取元件、MPN和LCSC编码
- **支持任意标识符**——MPN、LCSC编码或KiCad符号属性中的其他分销商零件编号
- **优先使用LCSC编码搜索**（精确匹配）——若无结果则回退到MPN关键词搜索
- **当jlcsearch无LCSC编码（Cxxxxx）结果时**，回退到wmsc.lcsc.com API
- **从LCSC CDN下载**——直接PDF URL，无机器人防护
- **生成`manifest.json`清单**——格式与DigiKey/Mouser技能相同
- **验证PDF内容**——检查MPN、制造商和描述关键词
- **速率限制**——API调用间隔0.5秒（可通过`--delay`配置）
- **增量保存进度**——中断后可安全恢复

Single Datasheet Download

单个Datasheet下载

Use

fetch_datasheet_lcsc.py

for one-off downloads.

bash

undefined

使用

fetch_datasheet_lcsc.py

脚本进行单次下载。

bash

undefined

Search by MPN

通过MPN搜索

python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "GRM155R71C104KA88D" -o datasheet.pdf

Search by LCSC code

通过LCSC编码搜索

python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "C14663" -o datasheet.pdf

Direct URL download

直接URL下载

python3 <skill-path>/scripts/fetch_datasheet_lcsc.py "https://wmsc.lcsc.com/..." -o datasheet.pdf

JSON output

JSON格式输出

python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "C14663" --json


The script:
- **OS-agnostic** — uses `requests` → `urllib` → `playwright` fallback chain (no wget/curl)
- **Validates PDF headers** — rejects HTML error pages
- **Falls back to alternative manufacturer sources** when LCSC URL fails
- **Exit codes**: 0 = success, 1 = download failed, 2 = search/API error
- **Dependencies**:
  - `pip install requests` (recommended; urllib fallback works fine for LCSC)
  - `pip install playwright && playwright install chromium` (optional; rarely needed for LCSC)

python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "C14663" --json


该脚本：
- **跨平台兼容**——使用`requests` → `urllib` → `playwright` fallback链（无需wget/curl）
- **验证PDF头**——拒绝HTML错误页面
- **当LCSC URL失效时**，回退到其他制造商来源
- **退出码**：0=成功，1=下载失败，2=搜索/API错误
- **依赖项**：
  - `pip install requests`（推荐；urllib fallback可正常用于LCSC）
  - `pip install playwright && playwright install chromium`（可选；LCSC场景极少需要）

LCSC Official API (Requires Approval)

LCSC官方API（需审批）

Base URL:

https://ips.lcsc.com

. Requires API key + signature authentication. Contact

support@lcsc.com

for access. Rarely needed — jlcsearch covers most use cases.

基础URL：

https://ips.lcsc.com

。需要API密钥+签名认证。联系

support@lcsc.com

获取权限。极少需要——jlcsearch可覆盖大多数使用场景。

Web Search Fallback

网页搜索回退

If the jlcsearch API is unavailable, search LCSC by fetching the website directly:

https://www.lcsc.com/search?q=<query>

若jlcsearch API不可用，可直接通过网页搜索LCSC：

https://www.lcsc.com/search?q=<query>

Cross-Referencing & Missing Equivalents

交叉参考与缺失等效型号

LCSC part numbers are specific to the LCSC/JLCPCB ecosystem. Use the

extra.mpn

field to cross-reference on DigiKey/Mouser.

When an MPN has no exact LCSC match:

Search by key parameters (e.g., "100nF 0402 X7R 16V")
Look for pin-compatible alternatives from Chinese manufacturers
Verify specs and footprint match — pad dimensions can vary even within the same package size
As a last resort, mark as "consigned" and source separately

LCSC元件编号是LCSC/JLCPCB生态系统特有的。可使用

extra.mpn

字段在DigiKey/Mouser上进行交叉参考。

当MPN无精确LCSC匹配时：

通过关键参数搜索（例如“100nF 0402 X7R 16V”）
寻找国产厂商的引脚兼容替代型号
验证规格和封装匹配——即使封装尺寸相同，焊盘尺寸也可能不同
最后可标记为“客户自备”并单独采购

Tips

小贴士

```
basic
```
field matters — JLCPCB basic parts have no setup fee; extended parts cost $3 each
Check stock per warehouse (
```
whs-js
```
,
```
whs-zh
```
,
```
whs-hk
```
) — availability varies
```
moq
```
and
```
order_multiple
```
— many parts require minimum quantities or specific multiples
Datasheet quality varies for Chinese manufacturers — cross-reference MPN on DigiKey for better docs

```
basic
```
字段很重要——JLCPCB基础元件无设置费；扩展元件每件需3美元
检查各仓库库存（
```
whs-js
```
,
```
whs-zh
```
,
```
whs-hk
```
）——可用性因仓库而异
```
moq
```
和
```
order_multiple
```
——许多元件要求最低订购量或特定倍数
国产厂商的datasheet质量参差不齐——可在DigiKey上交叉参考MPN获取更优质文档

lcsc

Original

Translation

LCSC Electronics — Component Search, Datasheets & Ordering

LCSC Electronics — 元件搜索、Datasheet下载与订购

Related Skills

相关技能

Key Differences from DigiKey/Mouser

与DigiKey/Mouser的主要区别

LCSC Part Numbers

LCSC元件编号

jlcsearch API Reference

jlcsearch API参考

General Search

通用搜索

Category-Specific Search

分类特定搜索

Response Format

响应格式

Rate Limits

速率限制

Datasheet Download & Sync

Datasheet下载与同步

Datasheet Directory Sync

Datasheet目录同步

Sync datasheets for a KiCad project

同步KiCad项目的datasheet

Preview what would be downloaded

预览将要下载的内容

Retry previously failed downloads

重试之前下载失败的文件

Custom output directory

自定义输出目录

Parallel downloads (3 workers)

并行下载（3个工作进程）

Batch mode — sync from a plain MPN list (no KiCad project required)

批量模式——从纯MPN列表同步（无需KiCad项目）

Single Datasheet Download

单个Datasheet下载

Search by MPN

通过MPN搜索

Search by LCSC code

通过LCSC编码搜索

Direct URL download

直接URL下载

JSON output

JSON格式输出

LCSC Official API (Requires Approval)

LCSC官方API（需审批）

Web Search Fallback

网页搜索回退

Cross-Referencing & Missing Equivalents

交叉参考与缺失等效型号

Tips

小贴士