はじめに
電子機器の開発・製造に関わる現場では、BOM(Bill of Materials:部品表)の管理が欠かせません。設計変更のたびに「前回との差分はどこ?」「この部品、まだ入手できる?」を手作業で確認するのは時間がかかり、ミスも起きやすいです。
そこで、PythonでBOM比較ツールを自作してGitHubで公開しました。
本記事では、ツールの概要・使い方・実装のポイントをハンズオン形式で紹介します。
GitHubリポジトリ
https://github.com/bluerey0331/bom_diff_tool
ツールでできること
| 機能 | 概要 |
|---|---|
| BOM差分比較 | 追加・削除・Quantity変更・Manufacturer変更を自動検出 |
| 廃品・NRND検出 | DigiKey / Mouser APIと連携してライフサイクルを確認 |
| 代替品表示 | 廃品部品の代替候補を一覧表示 |
| Excelレポート出力 | 差分・ライフサイクル結果をシート別に出力 |
| カラム名カスタマイズ | 現場ごとに異なるBOMのカラム名に対応 |
| Prepareツール | 任意のExcelから必要な列だけ残して保存 |
動作イメージ(テキストUI):
┌─────────────────────────────────────────────────────────┐
│ ⬡ BOM Diff Tool v1.0.0 + DigiKey │
├──────────────┬──────────────────────────────────────────┤
│ OLD BOM FILE │ +Added │ -Removed │ △Qty │ △Mfr │
│ [old.xlsx ]… │ ─────────────────────────────────────── │
│ NEW BOM FILE │ Part Number │ Mfr Name │ Qty │
│ [new.xlsx ]… │ GRM188R61... │ Murata │ 100 │
│ ▶ Compare │ │
│ │ ⚡ Lifecycle タブ │
│ DIGIKEY API │ GRM188R61... │ 🔴 Obsolete │
│ [Client ID ] │ LQW18AN10... │ 🟠 NRND │
│ [Secret ] │ │
│⚡ Check Life.│ SUBSTITUTES │
│ MOUSER API │ RC0402JR-07 │ Source: DigiKey │
│ [API Key ] │ GRM155R61... │ Source: Mouser │
│⚡ Check Msr. │ │
│ SUMMARY │ ⚙ 設定 │
│ Obsolete [ 2]│ │
│ NRND [ 1]│ │
└──────────────┴──────────────────────────────────────────┘
環境・使用技術
- Python 3.11+
- tkinter(標準ライブラリ、GUI)
- pandas(Excel読み込み・差分検出)
- openpyxl(Excelレポート出力)
- requests(DigiKey / Mouser API通信)
- DigiKey Product Information API v4
- Mouser Search API v2
セットアップ
1. クローン&インストール
git clone https://github.com/bluerey0331/bom_diff_tool.git
cd bom-diff-tool
pip install -r requirements.txt
requirements.txt はシンプルです。
pandas>=2.0.0
openpyxl>=3.1.0
requests>=2.31.0
2. 設定ファイルの作成
cp config.ini.example config.ini
config.ini にAPI認証情報を記入します(後述)。
3. 起動
python main.py # GUIモード
python main.py --cli # CLIモード
使い方:基本のBOM比較
STEP 1:Prepareツールで前処理(任意)
現場のExcelにはBOM比較に不要な列(Unit Price、Lead Timeなど)が含まれていることが多いです。Prepareツールで必要な4列だけを残します。
python prepare.py
起動すると、ファイルを選ぶとカラム一覧がチェックボックスで表示されます。
- ✅ 残す列(緑):⚙設定で定義した4列が自動的にON
- ☐ 削除する列(赤):それ以外はデフォルトOFF
old.xlsx / new.xlsx として保存して完了。
STEP 2:BOM比較
-
old.xlsx(旧BOM)とnew.xlsx(新BOM)を選択 - ▶ Compare をクリック
- 結果が4つのタブに表示される
| タブ | 内容 |
|---|---|
| + Added | 新BOMにのみある部品 |
| - Removed | 旧BOMにのみある部品 |
| △ Qty Changed | 数量が変わった部品 |
| △ Mfr Changed | メーカーが変わった部品 |
STEP 3:Excelレポートを保存
↓ Save Excel Report でレポートを保存。4つのシートに整理して出力されます。
使い方:ライフサイクルチェック(DigiKey / Mouser API)
BOM比較後、そのまま部品のライフサイクルも確認できます。
DigiKeyの場合
- DigiKey Developer Portal でアプリを登録
- Client ID と Client Secret を取得
- 左パネルに入力して ⚡ Check DigiKey をクリック
Mouserの場合
- Mouser API Hub からSearch APIを申請(メールでキーが届く)
- 左パネルに入力して ⚡ Check Mouser をクリック
APIキーは config.ini に書いておくと次回から自動読み込みされます。
[digikey]
client_id = xxxxxxxxxxxxxxxx
client_secret = xxxxxxxxxxxxxxxx
[mouser]
api_key = xxxxxxxxxxxxxxxx
結果はLifecycleタブに色分け表示されます。
| 色 | ステータス | 意味 |
|---|---|---|
| 🔴 赤 | Obsolete | 廃品(製造中止) |
| 🟠 橙 | NRND | 新規設計非推奨 |
| 🟢 緑 | Active | 現行品 |
| ⬛ グレー | Unknown | 未登録 |
廃品・NRNDの行をクリックすると、下部の代替品テーブルに候補が表示されます。どのAPIで取得したかも「Source」列で確認できます。
実装のポイント
1. カラム名を設定ファイルで管理する
現場ごとにBOMのカラム名が違う問題を解決するため、カラム名を config.ini で管理しています。
# src/column_config.py(抜粋)
DEFAULT_COLUMNS = {
"part_number": "Manufacturer Part Number",
"manufacturer": "Manufacturer Name",
"quantity": "Requested Quantity 1",
"description": "Description",
}
def get_required_columns() -> list[str]:
"""設定から必須カラム名リストを返す"""
config = _read_ini()
return [
config.get("columns", key, fallback=default).strip()
for key, default in DEFAULT_COLUMNS.items()
]
loader.py・comparator.py・report.py はすべてこの関数を参照するため、設定を変えるだけで全体に反映されます。GUIの ⚙設定 ボタンからも変更可能です。
2. DigiKey と Mouser で共通インターフェースを使う
2つのAPIを同じ形式で返すようにしています。
# 共通の戻り値フォーマット
{
"part_number": "GRM188R61A106KE69D",
"lifecycle": "obsolete", # active / nrnd / obsolete / unknown
"status_label": "Obsolete",
"substitutes": [
{
"mfr_part_number": "GRM188R61A106KE69J",
"manufacturer": "Murata",
"source": "digikey", # or "mouser"
}
],
"error": "",
}
GUIとレポート出力はこのフォーマットだけを扱うため、APIが増えても変更が最小限になります。
3. Mouser APIの代替品は1回のリクエストで取得できる
DigiKeyはSubstitutionsエンドポイントへの別リクエストが必要ですが、Mouserは1回の検索レスポンスに SuggestedReplacement フィールドが含まれています。
# src/mouser_client.py(抜粋)
def _parse_substitutes(suggested: str) -> list[dict]:
"""カンマ区切りの代替品文字列をリストに変換"""
if not suggested:
return []
return [
{"mfr_part_number": pn.strip(), "source": "mouser"}
for pn in suggested.split(",")
if pn.strip()
]
4. GUIのブロッキングを防ぐ
API呼び出しは threading.Thread で別スレッドで実行し、UIが固まらないようにしています。
# src/gui.py(抜粋)
def _run_digikey_check(self):
self._dk_btn.config(state="disabled", text="Checking…")
threading.Thread(
target=self._digikey_worker,
args=(client_id, client_secret),
daemon=True
).start()
def _digikey_worker(self, client_id, client_secret):
# バックグラウンドで1件ずつ処理
for i, pn in enumerate(self._new_part_numbers):
lc = client.check_lifecycle(pn)
# UIへの更新は after() でメインスレッドに渡す
self.after(0, self._on_dk_progress, i + 1, total, pn, lc)
self.after(0, self._on_dk_done, results)
プロジェクト構成
bom-diff-tool/
├── main.py # エントリーポイント
├── prepare.py # 前処理ツール
├── requirements.txt
├── config.ini.example # 設定テンプレート
├── sample_old.xlsx # サンプルBOM(旧)
├── sample_new.xlsx # サンプルBOM(新)
└── src/
├── column_config.py # カラム名設定
├── comparator.py # 差分検出ロジック
├── digikey_client.py # DigiKey API
├── mouser_client.py # Mouser API
├── gui.py # メインGUI
├── loader.py # Excel読み込み
├── preprocessor.py # 前処理ロジック
├── report.py # Excelレポート出力
└── settings_dialog.py # 設定ダイアログ
テストは pytest で書いており、GitHub Actions で Python 3.11 / 3.12 の自動テストが走ります。
pip install pytest
pytest tests/ -v
サンプルデータで試してみる
リポジトリにはすぐ試せるサンプルデータが含まれています。
cp sample_old.xlsx old.xlsx
cp sample_new.xlsx new.xlsx
python main.py
サンプルには以下の変更点が仕込まれています。
| 変更種別 | 部品番号 |
|---|---|
| 追加 | RC0402JR-070R1L |
| 削除 | MMBT3904LT1G |
| Qty変更 | LQW18AN10NG00D(50→80) |
| Mfr変更 | ERJ-2RKF1001X(Panasonic→Yageo) |
まとめ
本記事のまとめです。
- BOM差分比較はpandasのDataFrameインデックス比較で実現(シンプル&高速)
- カラム名の柔軟対応は設定ファイル集約パターンで解決
- DigiKey / Mouser APIの統合は共通インターフェースで最小限の変更に
- GUIのブロッキング防止はthreading + after()で対応
現場で実際に使いながら機能を足していったので、「あったらいいな」が詰まっています。IssueやPRも歓迎です。
GitHubリポジトリ
https://github.com/bluerey0331/bom_diff_tool
MITライセンス・商用利用可能です。