> # ⚠️ DEPRECATED
> **This page is deprecated. The official app is now [adom/adom-chip-fetcher](https://wiki.adom.inc/adom/adom-chip-fetcher).** Install it with `adompkg install adom/adom-chip-fetcher`. This page is no longer maintained.

# chip-fetcher

Download manufacturer-grade chip CAD bundles (STEP + KiCAD symbol + KiCAD footprint + datasheet + design-help PDFs) into a structured library by driving Chrome via [pup](https://github.com/adom-inc/adom-desktop).

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

```bash
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)
```

## Verified vendors

| Vendor | Path | Notes |
|---|---|---|
| Texas Instruments | `vendor.ultralibrarian.com/TI/embedded/...` | mfr-direct via UL |
| STMicroelectronics | `vendor.ultralibrarian.com/stmicro/embedded/...` | mfr-direct via UL |
| Analog Devices | `vendor.ultralibrarian.com/adi/embedded/...` | mfr-direct via UL |
| Microchip | `vendor.ultralibrarian.com/microchip/...` | mfr-direct via UL (iframe) |
| NXP | `nxp.com` (BXL) + `nxp.componentsearchengine.com` (STEP) | mfr-direct |
| Espressif | Mouser ECAD-Model fallback | mfr-uploaded to SamacSys |
| Lattice | Mouser ECAD-Model fallback | mfr-uploaded to SamacSys |
| Renesas | Mouser ECAD-Model fallback | mfr-uploaded to SamacSys |

See [SKILL.md](https://wiki-ufypy5dpx93o.adom.cloud/apps/chip-fetcher) for the full skill documentation, vendor URL patterns, and the failure-mode notes captured from real Adom-user feedback.

## Install

```bash
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/](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.