データシート

agentee datasheet (MCP の datasheet_fetch、datasheet_text、datasheet_add) は、部品データシートを一度取得して、すべてのプロジェクトとエージェントが共有するキャッシュ ~/.cache/agentee/datasheets/ ($AGENTEE_DATASHEETS または $XDG_CACHE_HOME で移動可能) に保存し、テキストとして読み戻します。

agentee datasheet fetch lna                    # every part of a layout or schematic
agentee datasheet fetch U3                     # one part, by reference, symbol or part number
agentee datasheet fetch TMC2209-LA
agentee datasheet fetch U3 --url https://example.com/u3.pdf
agentee datasheet text TMC2209-LA --find VS    # passages holding VS, with page and line
agentee datasheet text U3 --pages 4-6
agentee datasheet add XYZ123 ~/Downloads/xyz123.pdf --manufacturer Acme
agentee datasheet list
agentee datasheet purge                        # drop every copy no library part pins

部品のデータシートは、以下の順序で検索されます。回路図の datasheet フィールド、シンボルの datasheet URL、次にキーを持つ各ディストリビュータがその mpn にリストしているデータシート (Maker MPN フィールドは分割され、リストされている部品の先頭である部品番号、例えば TMC2209-LA-T の TMC2209-LA は、そのデータシートを使用します)。ダウンロードはブラウザのユーザーエージェントを使用し、HTTP 429 と 5xx でリトライし、HTML ページから PDF にリンクをたどり、一度タイムアウトしたホストについては実行の残りでは諦めます。PDF のみ保存されます。

コピーは MAKER/MPN/HASH.pdf にあり、各コピーの URL、ソース、SHA-256、取得日、および最初のページまたは最後のページから読み取った改訂行を保持する meta.json があります。これにより、部品は一度だけ取得され、新しい改訂版が古いものの隣に置かれます。text は pdftotext -layout でコピーを読み、テキストを PDF の隣に保持します。部品がキャッシュされている場合はネットワークにアクセスせず、キャッシュされていない場合は先に取得します (--offline は代わりに拒否します)。--find は単語全体にマッチし、大文字を含む単語は大文字小文字を区別し、--context で各ヒットの前後の行を表示します。

設計またはその中の部品の取得は、プロジェクトルートの datasheets.toml に使用したものを書き込みます:

[[parts]]
key = "TPS7A9101DSKR"
manufacturer = "TI"
refs = ["U9", "U24"]
url = "https://www.ti.com/lit/ds/symlink/tps7a91.pdf"
source = "symbol TPS7A91"
sha256 = "1ab38416..."
revision = "SBVS282A – DECEMBER 2016 – REVISED SEPTEMBER 2026"
fetched = "2026-10-09"

[[parts]]
key = "SPF5189Z"
refs = ["U1"]
missing = "https://www.qorvo.com/products/d/da001910: HTTP 429"

check は、シンボルや部品にデータシート URL がなく、ここに記録もない mpn を持つ部品、および最後の取得でデータシートが見つからなかった部品に対して警告します (ルール datasheet)。修正は、datasheet add によるユーザーの PDF、または動作する URL です。