Mouser Electronics Search

@@ -2,97 +2,94 @@  **Mouser's catalog — stock, price breaks, datasheets and lifecycle — right in your workspace.** +`adom-mouser` is the single-vendor Mouser 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-mouser` and feeds [`adom-parts-search`](/adom/adom-parts-search). -`adom-mouser` is the single-vendor Mouser tool for the Adom ecosystem — one Rust binary, three-faces:+## Install -- **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).+```bash+adompkg install adom-mouser+``` -It replaces the old `gallia/services/mouser` + MCP setup: no MCP server, no Adom Viewer.+## Quick start  ```bash-adompkg install adom-mouser+# One-shot search (auto-detects backend, falls back to a direct Mouser call) adom-mouser search "ESP32-S3-WROOM-1"++# Interactive UI as a Hydrogen tab+adom-mouser app++# One exact part+adom-mouser part "595-LM358DR" ``` -## Search like you mean it+## Screenshots -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.+### Search like you mean it+Full MPN for an exact hit, or a parametric phrase like `LDO 3.3V 500mA SOT-23`. Each card shows the+manufacturer photo, Mouser PN + MPN, stock, price, lead time, RoHS/lifecycle and key attributes.  ![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.+### Quantity pricing, first-class+Price breaks are shown on every card, so you know what a reel actually costs — not just the qty-1+sticker.  ![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+### Scriptable from the first keystroke+`search`/`part`/`health` return JSON — pipe to `jq`, a BOM, or another Claude step. -`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 healthy](/blob/app/adom-mouser/screenshots/cli.png) -![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)+## Dependencies -```bash-adom-mouser search "STM32F103RBT6" | jq '.components[0]'-adom-mouser part "595-LM358DR"-adom-mouser health-```+| Dependency | Required? | Why |+|---|---|---|+| `service-mouser` backend (`adom-mouser serve`) | Recommended | Shared 10-min cache + a single `MOUSER_API_KEY`; the CLI auto-detects it |+| Direct Mouser API | Fallback | Used automatically when no backend is reachable | -## Install+## Features -```bash-adompkg install adom-mouser-```+- **Three faces** — CLI verbs, a Hydrogen webview app, and the shared backend service.+- **Rich cards** — photo, Mouser PN + MPN, stock, price + breaks, lead time, RoHS, lifecycle, attrs.+- **Backend autodetect** — uses the shared proxy if present, else a direct call.+- **40-min drone delivery** from Mansfield, TX to Fort Worth is why Mouser is the preferred vendor. -## How it works+## Talk to the AI -```-  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)-```+- "find an ESP32-S3-WROOM module on Mouser"+- "what does an STM32F103RBT6 cost at Mouser"+- "Mouser stock for a USB-C receptacle"+- "datasheet for an LM358 on Mouser" -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.+## Skills -## See also+| Skill | Purpose |+|---|---|+| `adom-mouser` | When/how Claude drives the search — verbs, MPN vs keyword, reading the cards |+| `adom-mouser-build` | Release workflow (build, publish to the wiki) | -- [`adom-parts-search`](/adom/adom-parts-search) — searches Mouser, DigiKey and JLCPCB at once and picks the best buy.+## CLI reference -## Open source — make it yours, then give it back+| Command | What it does |+|---|---|+| `adom-mouser search "<q>"` | Search Mouser → JSON |+| `adom-mouser part "<mouser-pn>"` | Fetch one part → JSON |+| `adom-mouser app` | Open the searchable Hydrogen tab |+| `adom-mouser health` | Check the backend + API key |+| `adom-mouser serve` | Run the shared backend proxy (port 8775) | -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.+## Open source — make it yours, then give it back -```bash-adompkg install adom-mouser      # 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-```+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. -> **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.+> **One caveat — the search backend is an Adom service.** Lookups run against Adom's hosted Mouser+> backend (`service-mouser`), 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.  ## License