lcsc

LCSC Electronics — 部品検索、データシート、注文

関連スキル

スキル	目的
kicad	回路図の解析 — 部品検索用に MPN を抽出します
bom	BOM 管理 — 販売代理店をまたいだ調達を調整します
jlcpcb	PCB アセンブリ — 同じ部品ライブラリを共有します
spice	動作 SPICE モデル用に LCSC のパラメトリックデータを使用します（認証不要）

LCSC は JLCPCB の姉妹会社で、同じ部品ライブラリと Cxxxxx 部品番号を共有しています。量産向けの調達（JLCPCB／PCBWay での基板実装）には LCSC を使用してください。試作には DigiKey／Mouser を使用します。BOM の管理とエクスポートのワークフローについては、bom を参照してください。

DigiKey／Mouser との主な違い

• API キー不要 — jlcsearch のコミュニティ API は無料でオープンです
• 低価格 — 特に受動部品や中国製 IC で低価格です
• JLCPCB との連携 — JLCPCB のアセンブリ BOM でも同じ LCSC 部品番号を使用します
• PDF を直接ダウンロード可能 — LCSC の CDN（wmsc.lcsc.com）はボット対策なしでデータシートを提供します
• 最小発注数量（MOQ）が少ない — 多くの部品は 1 個から購入できます
• 倉庫 — 深圳（JS）、珠海（ZH）、香港（HK）
• ウェブサイト：https://www.lcsc.com

LCSC 部品番号

形式：Cxxxxx（例：C14663）。これは LCSC と JLCPCB の両方で共通の識別子です。次の用途に使用します。

• LCSC での直接注文
• JLCPCB アセンブリでの BOM 照合（jlcpcb スキルを参照）
• プラットフォーム間での相互参照

部品検索

search_lcsc.py を使用して、LCSC と JLCPCB の電子部品を検索し、リアルタイム在庫の確認、価格帯の調査、ベーシック部品と拡張部品の識別、パラメトリック属性の取得を行えます。API キーは不要です。

# Search by keyword or description
python3 <skill-path>/scripts/search_lcsc.py "tactile switch"

# Search for basic parts only (no JLCPCB extended loading fees)
python3 <skill-path>/scripts/search_lcsc.py "0805 100R" --basic

# Filter by package/footprint and stock
python3 <skill-path>/scripts/search_lcsc.py "red led" --package 0805 --in-stock

# Inspect full component details (manufacturer, datasheet URL, price breaks, parametric attributes)
python3 <skill-path>/scripts/search_lcsc.py "C318884" --details

# Output machine-readable JSON (for scripts and agent workflows)
python3 <skill-path>/scripts/search_lcsc.py "ME2108" --limit 5 --json

# Sort results by price or stock
python3 <skill-path>/scripts/search_lcsc.py "microcontroller STM32" --sort price

# Parametric category search (rows carry package, stock, price and attributes)
python3 <skill-path>/scripts/search_lcsc.py "STM32" --category microcontrollers

このスクリプトは次の処理を行います。

• 検索には無料の jlcsearch コミュニティ API を照会し、その後、正確な Cxxxxx 検索と --details で表示するすべての検索結果について、LCSC の直接の商品詳細エンドポイントから情報（メーカー、データシート URL、価格段階）を補完します。検索結果ごとに 0.5 秒間隔で追加リクエストを 1 回送信します。jlcsearch に Cxxxxx コードの行がない場合は、直接検索を代替手段として使用します。
• 結果を見やすいターミナル表に整形し、LCSC #、MPN、Package、Basic/Ext のステータス、Stock、Price、Description を強調表示します
• JLCPCB 製造時の PCB アセンブリ BOM コストを最適化するため、--basic フィルターに対応します
• BOM の自動補完やエージェントのワークフロー向けに --json に対応します

jlcsearch API リファレンス

LCSC の検索には jlcsearch コミュニティ API の使用を推奨します。認証は不要です。

ベース URL： https://jlcsearch.tscircuit.com

一般検索

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

パラメーター：

• q — 検索クエリ（MPN、LCSC コード、または説明のキーワードに一致）
• package — オプションのフットプリントフィルター（例：0402）
• limit — 最大検索結果数（既定値は 100）
• full — 指定できますが、フィールドは追加されません（以前の extra ブロックは廃止されています。以下を参照）

カテゴリー別検索

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

レスポンス形式

一般検索は {"components": [...]} を返します。2026-09 時点では、各検索結果に含まれるのは次のフィールドのみです。full=true を指定しても、extra ブロック（メーカー、データシート URL、倉庫別在庫、属性、価格段階）は返されなくなりました。

{
  "lcsc": 318884,
  "mfr": "TS-1187A-B-A-B",
  "package": "SMD-4P,5.1x5.1mm",
  "is_basic": true,
  "is_preferred": false,
  "description": "-30℃~+85℃ 1.5mm 1.6N ... SMD-4P,5.1x5.1mm Tactile Switches ROHS",
  "stock": 1683297,
  "price": 0.0197
}

主なフィールド：

• lcsc — 数値の LCSC ID（「C」プレフィックスなし）。LCSC コードにするには先頭に C を付けます
• mfr — メーカー型番（メーカー名は含まれません）
• is_basic — JLCPCB のベーシック部品（セットアップ料金なし）の場合は true、is_preferred — JLCPCB の優先拡張部品
• stock / price — JLCPCB アセンブリでの在庫数と単価（USD）

カテゴリー別エンドポイントは {"<category>": [...]} を返します。キーは components ではなくカテゴリー名です。一般検索とは行の形式が異なり、price の代わりに price1、in_stock、空の description、パラメトリック列（例：resistance、cpu_core）、JSON 文字列としての attributes が含まれます。

{"resistors": [{"lcsc": 25804, "mfr": "0603WAF1002T5E", "description": "", "stock": 37165617,
  "price1": 0.000842857, "in_stock": true, "package": "0603", "resistance": 10000,
  "is_basic": true, "is_preferred": false,
  "attributes": "{\"Resistance\":\"10kΩ\",\"Power(Watts)\":\"100mW\",\"Tolerance\":\"±1%\"}"}]}

LCSC の製品詳細情報（補足）

メーカー、データシート URL、価格段階を取得するには、Cxxxxx コードを使って LCSC 独自のエンドポイントに問い合わせます。認証不要で、JSON が返され、成功時の code は 200 です。

GET https://wmsc.lcsc.com/ftps/wm/product/detail?productCode=C318884

便利な result フィールド：productModel（MPN）、brandNameEn（メーカー）、pdfUrl（データシートの直接 PDF）、encapStandard（パッケージ）、productIntroEn / productDescEn（説明）、stockNumber（LCSC 在庫番号）、productPriceList[]（ladder = 最小数量、usdPrice）。fetch_datasheet_lcsc.search_lcsc_direct() はこの処理をラップし、結果を jlcsearch の辞書形式（extra.number、extra.mpn、extra.manufacturer.name、extra.datasheet.pdf、price 内の価格段階リスト）に正規化します。search_lcsc.py は Cxxxxx の補足情報取得にこれを使用し、jlcsearch に結果がない場合のフォールバックとしても使用します。

レート制限

どちらの API もレート制限を明記していませんが、適切な間隔を空けてください。呼び出しの間に 0.5 秒の遅延を設けます。

データシートのダウンロードと同期

LCSC の CDN は、ボット対策や特別なヘッダーなしでデータシート PDF を直接提供します。そのため、LCSC は DigiKey と並ぶ信頼性の高いデータシートソースです。

データシートディレクトリの同期

sync_datasheets_lcsc.py を使用して、KiCad プロジェクトと同じ階層にある datasheets/ ディレクトリを管理します。DigiKey および Mouser のスキルと同じワークフローおよび manifest.json 形式です。API キーは不要です。

# Sync datasheets for a KiCad project
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)
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)
python3 <skill-path>/scripts/sync_datasheets_lcsc.py --mpn-list mpns.txt --output ./datasheets

MPN リストの一括処理モード（KH-312） — KiCad プロジェクトがなく、MPN のリストだけがある場合に使用します。1 行につき MPN を 1 つ記述します。空行と # コメント（行全体および行内）はスキップされます。is_real_mpn() によって汎用値を除外し、重複を削除します。--output を省略した場合、出力先は現在の作業ディレクトリの ./datasheets/ になります。

このスクリプトは次の処理を行います。

• KiCad の回路図アナライザーを実行して、コンポーネント、MPN、LCSC コードを抽出します
• 任意の識別子を受け付けます — KiCad のシンボルプロパティにある MPN、LCSC コード、その他の販売代理店の部品番号を使用できます
• 検索には LCSC コードを優先します（完全一致）。該当がない場合は、MPN のキーワード検索に切り替えます
• LCSC コード（Cxxxxx）の場合、jlcsearch に結果がない、または結果にデータシート URL がないときは、wmsc.lcsc.com API にフォールバックします
• LCSC CDN からダウンロードします — PDF の直接 URL を使用し、ボット対策はありません
• manifest.json マニフェストを書き込みます — DigiKey/Mouser のスキルと同じ形式です
• PDF の内容を検証します — MPN、メーカー、説明に含まれるキーワードを確認します
• レート制限を適用します — API 呼び出しの間隔は 0.5 秒です（--delay で変更可能）
• 進捗を逐次保存します — 安全に中断できます

単一データシートのダウンロード

単発のダウンロードには fetch_datasheet_lcsc.py を使用します。

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

# Search by LCSC code
python3 <skill-path>/scripts/fetch_datasheet_lcsc.py --search "C14663" -o datasheet.pdf

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

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

このスクリプトは次の処理を行います。

• OS に依存しません — requests → urllib → playwright のフォールバックチェーンを使用します（wget/curl は不要です）
• PDF ヘッダーを検証します — HTML のエラーページを拒否します
• LCSC の URL が失敗した場合、代替メーカーのソースにフォールバックします
• 終了コード：0 = 成功、1 = ダウンロード失敗、2 = 検索/API エラー
• 依存関係：
  • pip install requests（推奨。LCSC では urllib のフォールバックも問題なく動作します）
  • pip install playwright && playwright install chromium（任意。LCSC では必要になることはほとんどありません）

LCSC 公式 API（承認が必要）

ベース URL： https://ips.lcsc.com。API キーと署名認証が必要です。利用するには [email protected] に問い合わせてください。必要になることはまれです。ほとんどの用途は jlcsearch で対応できます。

ウェブ検索によるフォールバック

jlcsearch API が利用できない場合は、ウェブサイトに直接アクセスして LCSC を検索します。

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

クロスリファレンスと同等品が見つからない場合

LCSC の部品番号は LCSC/JLCPCB のエコシステムに固有です。DigiKey/Mouser でクロスリファレンスするには、MPN の mfr フィールドを使用します。

MPN に完全一致する LCSC の部品がない場合：

1. 主な仕様で検索します（例：「100nF 0402 X7R 16V」）
2. 中国メーカー製のピン互換品を探します
3. 仕様とフットプリントが一致することを確認します。同じパッケージサイズでもパッド寸法が異なる場合があります
4. 最終手段として、「委託品」としてマークし、別途調達します

ヒント

• is_basic フィールドは重要です。JLCPCB の基本部品にはセットアップ料金がかかりませんが、拡張部品は 1 個あたり 3 ドルです。
• jlcsearch の stock は JLCPCB の実装用在庫です。wmsc の詳細情報にある stockNumber は LCSC 独自の在庫数であり、両者は異なります。
• MOQ と注文単位は jlcsearch のレスポンスに含まれなくなりました。注文する前に LCSC の製品ページを確認してください。
• 中国メーカーのデータシートは品質にばらつきがあります。より充実した資料を入手するには、DigiKey で MPN を照合してください。