datasheet-lens

datasheet-lens

datasheet-lensは、電子部品のデータシートを一元管理するストアです。各データシートは一度だけ保存され、使用するプロジェクトに紐付けられます。これにより、プロジェクトに参加する各メンバーとAIエージェントが、同じ正確なドキュメントを利用できます。

• 電子設計。 設計リポジトリ内のプロジェクトファイルdatasheet-lens.tomlに、設計で使用する部品とそのデータシートを記載します。datasheet-lensは、このリストをCADプロジェクト（KiCadやその他のEDAツール）の部品と同じ状態に保ちます。
• ソフトウェアとファームウェア。 開発者とそのAIエージェントは、ハードウェアチームと同じデータシート、つまり、出所不明のコピーではなく、同じドキュメントとリビジョンを利用できます。
• 両方で使える単一の情報源。 ハードウェア設計とソフトウェアでは、1つのプロジェクトファイルを共有することも、同じ部品を記載したプロジェクトファイルをそれぞれ用意することもできます。ストアは各PDFをSHA-256で識別するため、どちらのプロジェクトでも同じドキュメントを利用できます。

LLMエージェントはMCP サーバーを通じてデータシートを読み取ります。このツールはデータシートをテキストに変換しません。変換すると、上付き文字が失われたり、表の行が結合されたり、列がずれたり、グラフから読み取った値が誤ったりといった、一見正しく見えるエラーが生じます。datasheet-lensは内容を探すためのインデックスを作成し、必要に応じて元のページや領域をモデルに提供します。モデルは作業に必要な部分だけを読み、各値を原本から読み取ります。

ステータス：開発中（バージョン0.3）。ツールは動作し、テストも用意されています。インターフェースは変更される場合があります。

機能

• ドキュメントを詳細に確認。 インデックス（アウトライン、表と図のキャプション、ページの品質）、テキスト検索、要素ID付きのページマップに加え、要素、領域、キャプション（「Table 57」。表が複数ページにわたる場合はdoclingも使用）、またはページ全体の画像を300～600 dpiで取得できます。
• 全プロジェクトで共有する一元管理ストア。 各ユーザーは、すべての設計プロジェクトで使用するストア（デフォルトは~/.datasheet-lens）を1つ持ちます。各PDFは、そのインデックス、要素マップ、部品、セッションが読み取ったファクトとともに、1回だけ（SHA-256で）保存されます。あるプロジェクトが追加したデータシートは、他のすべてのプロジェクトですぐに利用できます。再ダウンロード、再インデックス、再読み込みは不要です。1つの部品にデータシート、マニュアル、正誤表を紐付けることもできます。
• ファクト。 セッションが読み取った値は、その出典（ドキュメント、ページ、要素）とともに保存されるため、後続のセッションで見つけることができます。
• プロジェクトファイル。 設計リポジトリ内のdatasheet-lens.tomlに、設計で使用する部品とそのドキュメントを記載します。このファイルはリポジトリとともにチームで共有されます。project_checkは、内容をCADプロジェクトの部品と照合します。
• 発注可能な部品。 データシートに記載された発注コードと、販売代理店の公式API（現在はMouser）から取得するライフサイクル状態、在庫、価格を利用できます。スクレイピングは行いません。
• チームサーバー（オプション）。 チームでドキュメント、部品、ファクト、各ドキュメントのインデックスと要素マップを共有するストアです。各メンバーは、接続がなくても動作し、サーバーと同期するローカルストアを保持します。サーバー（datasheet-lens[server]）にはロールとトークンを持つアカウント機能があり、セットアップウィザードを使ってPostgreSQL、Garageオブジェクトストア、nginx、Let's Encrypt証明書をインストールできます。

代表的な用途

datasheet-lens は、設計プロジェクトの入力ドキュメントを管理し、リポジトリに保存するのに役立ちます。BOM を CAD プロジェクトと一致させます。エージェントが BOM を確認し、設計を元のデータシートと照合できるようにします。

• 設計に必要なデータシートを漏れなく Git に保存し、チームの誰もが同じものを使用できるようにします。
• プロジェクトと CAD プロジェクトの部品を比較し、不足、余分、相違のある部品を確認します。
• 基本部品の具体的な発注可能 MPN を選び、発注できることを確認します。
• 回路図をデータシートと照合して確認します。ピン、絶対最大定格、ロジックレベル、応用回路が対象です。
• フットプリントをデータシートのパッケージ図と比較します。
• ファームウェア用にレジスタマップ、ビットフィールド、タイミング値を読み取り、出典とともに事実として保存します。
• 同じ部品を複数のプロジェクトで使用できます。あるプロジェクトのデータシートと事実は、同じユーザーのほかのプロジェクトでもすぐに利用できます。

datasheet-lens は回路図自体を読み取りません。部品は CAD ツール、その MCP サーバー、または BOM ファイルから取得します。各用途の手順については、doc/use-cases.md を参照してください。

インストール

datasheet-lens には Python 3.11 以降が必要です。Linux、macOS、Windows で動作します。

pipx install datasheet-lens
datasheet-lens init

datasheet-lens init は中央ストア（デフォルトでは ~/.datasheet-lens、または環境変数 DATASHEET_LENS_HOME で指定されたフォルダー）を作成します。より優れた要素マップ（表と図）を利用できる docling もインストールできます。docling は任意ですが、ディスク容量が数 GB 必要です。インストールしない場合、ツールはテキストレイヤーを使用します。

Claude Code に MCP サーバー（stdio）を登録します。

claude mcp add --scope user datasheet-lens -- datasheet-lens-mcp

別の MCP クライアントを使用する場合は、引数なしでコマンド datasheet-lens-mcp を設定します。サーバーはエージェントに手順を提供します。doc/installation.md および doc/mcp-server.md を参照してください。

クイックスタート

設計リポジトリのルートフォルダーで実行します。

datasheet-lens project init     # the project file, and a block in AGENTS.md, CLAUDE.md
datasheet-lens add PATH|URL     # add a datasheet; it proposes the MPN of the part
datasheet-lens sync             # copy the documents into the project folder
datasheet-lens check BOM.csv    # compare the project with a BOM of the CAD project

エージェントは MCP サーバーを通じて同じ機能を使用します。AGENTS.md または CLAUDE.md のブロックで、エージェントに手順を伝えます。project init は既存のファイルだけを変更します。ブロックが必要な場合は、先にいずれかのファイルを作成してください。

コマンド	機能
add PATH|URL	ドキュメントをストアとプロジェクトに追加します
ls、sync	プロジェクトを表示するか、そのコピーを同期します
check BOM.csv	プロジェクトと CAD プロジェクトの BOM（CSV）を比較し、MPN、Value、Value_Confirmed フィールドの変更と競合を検出します（KiCad と Eagle の BOM エクスポートでのみテスト済み）
set MPN -m NEW	プロジェクトの部品の MPN、基本部品、カテゴリ、またはメーカーを変更します
rm MPN	プロジェクトから部品（または -d DOC でドキュメント）を削除します
search TEXT --part MPN	部品のドキュメント内でテキストを検索します
codes DOC	データシートの発注可能なコードを表示します
links MPN	データシート、在庫、シンボル、フットプリント、3D モデルの検索リンクを表示します
find MPN	販売代理店で部品を検索します（ライフサイクル、在庫、価格）
stock	各プロジェクト部品のライフサイクル状態と在庫を表示します
key NAME	販売代理店の API キー、またはチームサーバーのトークン（key team）を保存します
server connect URL	ストアをチームサーバーに接続します。server sync、server（状態）も使用できます
dist NAME ...	販売代理店を選択します（全体に適用するか、プロジェクトには --local を指定）

すべてのコマンドとオプションについては、doc/cli.md を参照してください。

各ユーザーは、販売代理店ごとに個人用 API キーを持っています。Mouser API Hub で無料の Mouser キーを取得し（Cart API キーではなく、Search API キーを使用）、datasheet-lens key mouser を実行します。doc/distributors.md を参照してください。

ドキュメント

ドキュメント	内容
doc/installation.md	要件、インストール、init、docling、保存場所、アップグレード、アンインストール
doc/use-cases.md	代表的な用途、手順
doc/mcp-server.md	MCP サーバー：登録、指示、すべてのツール
doc/agent-workflow.md	エージェントによるデータシートの読み方と例
doc/projects.md	プロジェクトファイル、レイアウト、同期、チームでのワークフロー、CAD プロジェクトとの整合性
doc/cli.md	すべての CLI コマンドとオプションのリファレンス
doc/distributors.md	販売代理店データ、API キー、販売代理店の選択、検索リンク
doc/team-server.md	チームサーバー：インストール、アカウントとトークン、ストアの接続、同期、API
doc/architecture.md	開発者向け：設計上の決定事項とモジュール構成
doc/development.md	開発環境のセットアップ、テスト、コードと文章のスタイル

開発

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m pytest

doc/development.mdを参照してください。

ライセンス

MITです。LICENSEを参照してください。