---
name: chip-fetcher-site-snapeda
description: >-
  How chip-fetcher navigates SnapEDA (SnapMagic) to download a chip's CAD bundle
  — symbol, footprint, 3D STEP, and the Fusion/Eagle .lbr + Altium IntLib —
  through a logged-in pup Chrome profile. The canonical template for a
  source-site skill. Read before driving a SnapEDA fetch, or when a SnapEDA fetch
  stalls at the login wall or the download button. Trigger words: snapeda,
  snapmagic, snapeda login, snapeda download, snapeda blocked, snapeda step,
  snapeda symbol footprint, snapeda lbr, snapeda intlib.
---

# Site: SnapEDA (SnapMagic)

SnapEDA is the highest-yield non-manufacturer rung: it has symbol + footprint +
3D + Eagle/Fusion `.lbr` + Altium for most mainstream parts, behind a free login.

## Reach
- Search: `https://www.snapeda.com/search/?q=<MPN>&SearchType=parts`
- Resolve to the part page (first exact-MPN result). The part page URL looks like
  `https://www.snapeda.com/parts/<MPN>/<Manufacturer>/view-part/`.

## Gate
- Requires a logged-in account to download. Use the persistent pup profile
  configured for SnapEDA; credentials come from `chip-fetcher creds` (key
  `snapeda`), entered **only** into SnapEDA's own login form.
- The session cookie persists in the profile for ~weeks; re-login only when the
  download button bounces back to a login modal.

## Download flow
1. On the part page, click **Download** (top-right). A format panel opens.
2. Pick the targets chip-fetcher wants: **Symbol and Footprint** (KiCad), **3D
   Model** (STEP), and the **Eagle/Fusion** library; Altium if offered.
3. SnapEDA emails-gates some downloads — the logged-in session usually skips that;
   if a "check your email" interstitial appears, the profile isn't logged in.
4. The download lands as a `.zip` in the desktop's Downloads.

## Catch
- chip-fetcher pulls the zip off the desktop (`adom-desktop pull_file`), unpacks
  into `library/<MPN>/`, and normalizes filenames (`<MPN>.step`, `.kicad_sym`,
  `.kicad_mod`, `-fusion.lbr`, `.IntLib`).

## When it breaks
- **Bounced to a login modal on Download** → the profile lost its session.
  Re-login with the `snapeda` creds, then retry. Don't paste creds anywhere but
  the SnapEDA login form.
- **"Request this design" instead of Download** → SnapEDA doesn't have this part's
  model yet. Fall to the next ladder rung; don't spin.
- **Moved Download button / new format panel** → SnapEDA reskinned. Screenshot the
  part page, find the new control by its label ("Download", format names), update
  the flow above, and publish the fix (see `../../CONTRIBUTING.md`).