# DigiKey Electronics Search

**DigiKey's catalog — millions of parts, real-time stock and quantity pricing — one command away.**

![DigiKey's catalog one command away — real-time stock, quantity pricing and datasheets in your Adom workspace](/blob/app/adom-digikey/screenshots/hero.png)

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

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

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

```bash
adom-wiki pkg install adom-digikey
adom-digikey search "BME280"
```

## Real-time stock, straight to the bench

DigiKey shines when you need it *today*. Every card shows live stock, qty-1 price and the full
break ladder, lead time, RoHS and lifecycle — and DigiKey's deep catalog means the obscure sensor
or alt part is usually right there.

![adom-digikey results for a BME280 humidity sensor — Bosch, alternatives from Sensirion, with stock, pricing and interface attributes](/blob/app/adom-digikey/screenshots/results-sensors.png)

## Find the exact part, and its alternates

Search a function (`buck regulator 1A SOT-23`) or a precise MPN. DigiKey's parametric data lets the
cards surface the specs that actually drive a decision — Iq, Iout, Vin range, package — so the
substitute is one glance away when the first choice is out.

![adom-digikey results for a TPS62840 buck regulator with alternates from TI and Monolithic Power, showing current, input range and price breaks](/blob/app/adom-digikey/screenshots/results-buck.png)

## Scriptable from the first keystroke

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

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

```bash
adom-digikey search "TPS62840DLCR" | jq '.components[0]'
adom-digikey part "296-TPS62840DLCRCT-ND"
adom-digikey health
```

## Install

```bash
adom-wiki pkg install adom-digikey
```

## How it works

```
  any container                          service-digikey
  $ adom-digikey search "BME280" ──POST──▶  adom-digikey serve  (:8777)
  $ adom-digikey app                        DIGIKEY_CLIENT_ID + OAuth
    (Hydrogen webview tab)                  token-refresh + cache
                                                 │
                                                 ▼
                                          api.digikey.com (v4)
```

The backend manages the DigiKey OAuth handshake and token refresh for you; the CLI auto-detects it
(or a local `:8777`). DigiKey is the go-to alternate when Mouser is out of stock or long-lead —
see how [`adom-parts-search`](/adom/adom-parts-search) flips the recommendation automatically.

## 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-digikey      # 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 DigiKey backend (`service-digikey`), 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.