DigiKey Electronics Search

@@ -2,94 +2,98 @@  **DigiKey's catalog — millions of parts, real-time stock and quantity pricing — one command away.** -`adom-digikey` is the single-vendor DigiKey tool for the Adom ecosystem: one Rust binary with three-faces — a JSON **CLI**, a first-class **Hydrogen webview app**, and the shared **backend service**-that powers `service-digikey` and feeds [`adom-parts-search`](/adom/adom-parts-search).+![DigiKey's catalog one command away — real-time stock, quantity pricing and datasheets in your Adom workspace](/blob/app/adom-digikey/screenshots/hero.png) -## Install+`adom-digikey` is the single-vendor DigiKey tool for the Adom ecosystem — one Rust binary, three+faces: -```bash-adompkg install adom-digikey-```+- **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). -## Quick start+It replaces the old `service-digikey` + MCP setup: no MCP server, no Adom Viewer.  ```bash-# One-shot search (auto-detects backend, falls back to a direct DigiKey call)+adompkg install adom-digikey adom-digikey search "BME280"--# Interactive UI as a Hydrogen tab-adom-digikey app--# One exact part-adom-digikey part "296-TPS62840DLCRCT-ND" ``` -## Screenshots+## Real-time stock, straight to the bench -### Real-time stock, straight to the bench-DigiKey shines when you need it today. Every card shows live stock, qty-1 price + the break ladder,-lead time, RoHS and lifecycle — and the deep catalog means the obscure sensor or alt is right there.+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 plus Sensirion alternatives with stock, pricing and interface attributes](/blob/app/adom-digikey/screenshots/results-sensors.png)+![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) -### The exact part, and its alternates-Search a function (`buck regulator 1A SOT-23`) or a precise MPN; parametric data surfaces the specs-that drive the decision, so the substitute is one glance away when the first choice is out.+## Find the exact part, and its alternates -![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)+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. -### Scriptable from the first keystroke-`search`/`part`/`health` return JSON — pipe to `jq`, a BOM, or another Claude step.+![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) -![Terminal showing adom-digikey search piped to jq for the first component, then a health check reporting the backend OAuth fresh](/blob/app/adom-digikey/screenshots/cli.png)+## Scriptable from the first keystroke -## Dependencies+`search` returns JSON; `part` fetches one MPN; `health` checks the backend's OAuth token. Pipe it+into `jq`, a BOM, or another Claude step. -| Dependency | Required? | Why |-|---|---|---|-| `service-digikey` backend (`adom-digikey serve`) | Recommended | Manages the DigiKey OAuth handshake + token refresh + cache; the CLI auto-detects it |-| Direct DigiKey API | Fallback | Used automatically when no backend is reachable |+![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) -## Features+```bash+adom-digikey search "TPS62840DLCR" | jq '.components[0]'+adom-digikey part "296-TPS62840DLCRCT-ND"+adom-digikey health+``` -- **Three faces** — CLI verbs, a Hydrogen webview app, and the shared backend service.-- **OAuth handled for you** — the backend does the DigiKey v4 handshake + token refresh.-- **Deep catalog + parametrics** — millions of parts; cards surface the spec that matters.-- **The go-to alternate** — when Mouser is out or long-lead, [`adom-parts-search`](/adom/adom-parts-search) flips to DigiKey automatically.+## Install -## Talk to the AI+```bash+adompkg install adom-digikey+``` -- "price a TPS62840 buck on DigiKey"-- "is the BME280 in stock at DigiKey"-- "find a 1A buck regulator in SOT-23 on DigiKey"-- "datasheet for an SHT40 on DigiKey"+## How it works -## Skills+```+  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)+``` -| Skill | Purpose |-|---|---|-| `adom-digikey` | When/how Claude drives the search — verbs, MPN vs keyword, reading the cards |-| `adom-digikey-build` | Release workflow (build, publish to the wiki) |+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. -## CLI reference+## See also -| Command | What it does |-|---|---|-| `adom-digikey search "<q>"` | Search DigiKey → JSON |-| `adom-digikey part "<dk-pn>"` | Fetch one part → JSON |-| `adom-digikey app` | Open the searchable Hydrogen tab |-| `adom-digikey health` | Check the backend + OAuth token |-| `adom-digikey serve` | Run the shared backend proxy (port 8777) |+- [`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, improve it, then send it back: `adompkg-publish` your own version, or open a pull request against this page so the change lands for everyone.+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+adompkg install adom-digikey      # install it+#   …edit the source to taste…+adompkg 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.** Lookups run against Adom's hosted DigiKey-> backend (`service-digikey`), which uses Adom's API credentials and counts against Adom's quota —-> an Adom service, **subject to change**. Everything client-side is yours to fork and republish.+> **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