# Mouser Electronics Search

**Mouser's catalog — stock, price breaks, datasheets and lifecycle — right in your workspace.**

![Mouser stock and pricing in your Adom workspace — CLI, a Hydrogen app, and a shared backend, with 40-minute drone delivery to Fort Worth](/blob/app/adom-mouser/screenshots/hero.png)

`adom-mouser` is the single-vendor Mouser tool for the Adom ecosystem — one Rust binary, three
faces:

- **CLI** — `adom-mouser search | part | health` for quick JSON-returning shell use and BOMs.
- **Hydrogen app** — `adom-mouser app` opens a searchable UI as a first-class Hydrogen tab.
- **Backend service** — `adom-mouser serve` runs the shared proxy (port 8775) that powers the
  `service-mouser` container and feeds [`adom-parts-search`](/adom/adom-parts-search).

It replaces the old `service-mouser` + MCP setup: no MCP server.

```bash
adom-wiki pkg install adom-mouser
adom-mouser search "ESP32-S3-WROOM-1"
```

## Search like you mean it

Type a full MPN for an exact hit, or a parametric phrase like `LDO 3.3V 500mA SOT-23` to browse.
Every result card shows the manufacturer photo, Mouser PN + MPN, stock, unit price, lead time,
RoHS/lifecycle flags and the key attributes — so you can decide without leaving the workspace.

![adom-mouser results for an ESP32-S3-WROOM module — product photos, stock, price, price breaks and attribute flags](/blob/app/adom-mouser/screenshots/results-esp32.png)

## Quantity pricing and the parts that matter

Price breaks are first-class: the card shows the full quantity ladder so you know what a reel
actually costs, not just the qty-1 sticker. Connectors, passives, modules, MCUs — the same clean
card for everything.

![adom-mouser results for USB-C receptacles — multiple manufacturers with pin count, current rating and quantity price breaks](/blob/app/adom-mouser/screenshots/results-usbc.png)

## Scriptable from the first keystroke

`search` returns JSON; `part` fetches one MPN; `health` checks the backend. Pipe any of it into
`jq`, a BOM, or another Claude step.

![Terminal showing adom-mouser search piped to jq for the first component, then a health check reporting the backend is healthy](/blob/app/adom-mouser/screenshots/cli.png)

```bash
adom-mouser search "STM32F103RBT6" | jq '.components[0]'
adom-mouser part "595-LM358DR"
adom-mouser health
```

## Install

```bash
adom-wiki pkg install adom-mouser
```

## How it works

```
  any container                         service-mouser
  $ adom-mouser search "ESP32"  ──POST──▶  adom-mouser serve  (:8775)
  $ adom-mouser app                        MOUSER_API_KEY set
    (Hydrogen webview tab)                 10-min LRU cache
                                                 │
                                                 ▼
                                          api.mouser.com (v2)
```

The CLI auto-detects the backend (or a local `:8775`), and falls back to a direct Mouser call when
no backend is reachable. **40-minute drone delivery** from Mouser's Mansfield, TX warehouse to our
Fort Worth facility is why Mouser is the preferred vendor across Adom tooling.

## See also

- [`adom-parts-search`](/adom/adom-parts-search) — searches Mouser, DigiKey and JLCPCB at once and picks the best buy.

## Open source — make it yours, then give it back

This app is **open source under the MIT license**. Fork it, rewrite it, rename it, bend it to your
own workflow — and when you've made it better, **send your changes back to the Adom Wiki so the
whole community benefits**. Every wiki page is a git repo with a package registry on top, so
contributing back is first-class — improvements that land here ship to every Adom user who installs
the app.

```bash
adom-wiki pkg install adom-mouser      # install it
#   …edit the source to taste…
adom-wiki pkg publish             # publish your own fork, or
#   open a pull request against this page so the change lands for everyone
```

> **One caveat — the search backend is an Adom service.** The actual lookups run against
> Adom's hosted Mouser backend (`service-mouser`), which uses **Adom's vendor API credentials and counts against Adom's quota**. That
> hosted backend is an Adom service and is **subject to change** — rate limits, endpoints, and
> availability can move at any time. Everything client-side (the CLI, the webview, the rendering
> and recommendation logic) is yours to fork and republish; the cloud API quota is not.

## License

MIT © Adom — do what you want with the code, just pass it on.