chip-fetcher

The stack

adom-chip-fetcher is the top of a stack, one command pulls a manufacturer-grade part bundle by orchestrating a tier of focused Adom apps. Each box below is a real app (click through to its page):

Download manufacturer-grade chip CAD bundles (STEP + KiCAD symbol + KiCAD footprint + datasheet + design-help PDFs) into a structured library by driving Chrome via pup.

The defining rule: fetch from the manufacturer's own website first, only fall back to Mouser, DigiKey, or Component Search Engine when the manufacturer doesn't self-host CAD, and only with explicit user approval.

What it does

chip-fetcher fetch TPS62840            # opens the TI page → UL deep-link → drives the form → auto-pulls
chip-fetcher pull '<windows-path>'     # pulls a downloaded zip from the user's desktop
chip-fetcher import path/to/zip --mpn  # absorbs a downloaded file into library/<MPN>/
chip-fetcher list                       # shows what's in library/ vs missing per slot
chip-fetcher login <source>             # opens a vendor login page in the chip-fetcher pup profile
chip-fetcher install                    # deploys SKILL.md to ~/.claude/skills/chip-fetcher/

After running, each chip lands in:

library/<MPN>/
├── <MPN>.step          # rich manufacturer STEP, named PRODUCTs (Body, ThermalPin, PinsArrayLR, PinsArrayTB)
├── <MPN>.kicad_sym
├── <MPN>.kicad_mod
├── <MPN>.pdf           # datasheet
├── <MPN>-errata-*.pdf
├── <MPN>-appnote-*.pdf
├── <MPN>-hwguide.pdf
└── info.json           # provenance trail (mfr-direct vs mouser-fallback)

Reuse first, then align pin-1

Reuse before re-fetch. The sourcing ladder now starts at the Adom Wiki (Source::AdomWiki): if the part is already published as a component bundle, chip-fetcher pulls that bundle (.kicad_sym / .kicad_mod / STEP / datasheet) instead of scraping vendors. Free, fast, and Adom-consistent. It only falls through to the manufacturer-first ladder when there's no published match.

Pin-1 alignment. From the dashboard you can Align pin-1 in chipsmith: line up the 3D chip's pin-1 with the footprint's pin-1 and sign off. chip-fetcher reads the sign-off back, derives the footprint's own pin-1 corner straight from the .kicad_mod, shows a Pin-1 status on every card (and flags a chip-vs-footprint mismatch), and gate --strict requires it.

Each card is one part. The Pin-1 badge shows the footprint target (fp NW) until you align + sign off in chipsmith, then it locks to the chip corner (Pin-1 checkmark NW).

Verified vendors

Email-delivered CAD (JST)

Some manufacturers email the CAD file instead of serving a download. JST is the reference case: since April 2025, requesting a STEP/IGES on jst-mfg.com sends it as an email attachment. The full flow, driving your real Chrome past Cloudflare, the License Agreement form, retrieving the attachment via adom-google (Gmail) or a build-your-own fetcher for other providers, and the breadcrumb pattern that keeps chip-fetcher provider-agnostic, is documented in its own sub-README:

➡️ docs/jst-email-gated-cad.md, Email-delivered CAD: the JST flow (and how to add any email-gated manufacturer)

🏆 docs/jst-showcase.md, Showcase (with screenshots): how chip-fetcher cracked JST's Cloudflare + email gate end-to-end, and bundled the 5 most-common JST connectors with symbol + footprint + 3D.

⚖️ Note on JST files: JST's download License Agreement (clause 2) prohibits redistributing their CAD to third parties, so we do not rehost JST's emailed STEP/IGES or datasheets. Connector component pages we publish use the redistributable KiCad libraries for symbol/footprint/3D and link to JST for any JST-authored model.

Agents: the same content lives in the skill as playbooks/jst.md + playbooks/jst-email-retrieval.md.

Demo (60s, narrated)

▶ Watch the 60-second demo, proven end-to-end on PHR-2: JST's global catalog → the License Agreement form → the "data has been sent to your email address" confirmation → adom-google pulls the emailed PHR-2.STEP → the chip-fetcher library card with its auto-rendered 3D model.

Reproducible recipe (scenes, narration, TTS config): demo/jst-email-gated-cad-demo-script.md.

See SKILL.md for the full skill documentation, vendor URL patterns, and the failure-mode notes captured from real Adom-user feedback.

Install

curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/chip-fetcher/chip-fetcher \
  -o /usr/local/bin/chip-fetcher && chmod +x /usr/local/bin/chip-fetcher && chip-fetcher install

Companion specs

Two adom-desktop fix-it specs live in scripts/:

• adom-desktop-pullfile-speed-prompt.md, streaming binary WS frames + HTTP fallback so 50+ MB files (NXP reference manuals) don't time out
• adom-desktop-credential-vault-prompt.md, DPAPI/Keychain-encrypted credential vault hooked into puppeteer.page.authenticate() so basic-auth popups never appear

Paste either into Claude Code on the desktop to implement.

License

MIT, © 2026 Adom Industries Inc. Open source; see LICENSE. Modify, fork, and redistribute freely.