app
Mouser Electronics Search
Public Made by Adomby adom
Mouser component search in your workspace — stock, quantity price breaks, datasheets and lifecycle. CLI verbs, a Hydrogen app, and a shared backend service.
← Commit history
Publish 1.0.5
7 files changed
+78−90
README.md+30−78@@ -1,100 +1,52 @@-# Mouser Electronics Search+# adom-mouser -**Mouser's catalog — stock, price breaks, datasheets and lifecycle — right in your workspace.**+Mouser Electronics component search for the Adom ecosystem — one Rust binary, three modes: -+- **CLI verbs** — `adom-mouser search|part|health` for quick JSON-returning shell use.+- **Hydrogen webview app** — `adom-mouser app` opens a searchable UI as a first-class Hydrogen tab.+- **Backend HTTP service** — `adom-mouser serve` runs the shared proxy (port 8775) used by the `service-mouser` container. -`adom-mouser` is the single-vendor Mouser tool for the Adom ecosystem — one Rust binary, three-faces:+Replaces the former `gallia/services/mouser/server.js` + `gallia/mouser/mcp/` setup. No MCP server, no Adom Viewer dependency. -- **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.+## Quick start ```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.----## 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.----## Scriptable from the first keystroke+# One-shot search (auto-detects backend, or falls back to direct Mouser call)+adom-mouser search "STM32F103RBT6" -`search` returns JSON; `part` fetches one MPN; `health` checks the backend. Pipe any of it into-`jq`, a BOM, or another Claude step.+# Interactive UI+adom-mouser app ---```bash-adom-mouser search "STM32F103RBT6" | jq '.components[0]'-adom-mouser part "595-LM358DR"-adom-mouser health+# Run the backend on the service container+MOUSER_API_KEY=<key> adom-mouser serve ``` -## Install--```bash-adom-wiki pkg install adom-mouser-```+See `SKILL.md` for the full command reference and typical workflows. -## How it works+## Architecture ```- 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)+┌─────────────────────────────────┐ ┌─────────────────────────┐+│ any container │ │ service-mouser │+│ │ │ │+│ $ adom-mouser search "ESP32" │───POST──▶│ adom-mouser serve │+│ $ adom-mouser app │ │ port 8775 │+│ (Hydrogen webview tab) │ │ MOUSER_API_KEY set │+│ │ │ 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.+Consumer containers point `MOUSER_API` at the service container's public URL; locally, the CLI will also autodetect `http://127.0.0.1:8775` if a backend is running on the same box. -## 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.+## Build ```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+./build.sh # cargo build --release → copy to /usr/local/bin → adom-mouser install ``` -> **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.+MIT.
SKILL.md+1−1@@ -188,7 +188,7 @@ adom-mouser search "LM317" adom-mouser app # UI reads $MOUSER_API automatically ``` -Users don't need to set `MOUSER_API` explicitly — `adom-mouser` is a Tier A app (see `adom-app-model`), so it's installed by every `adompkg install` run from the registry. The CLI autodetects a local `adom-mouser serve` on 127.0.0.1:8775 and falls back to calling Mouser directly if `MOUSER_API_KEY` is set locally.+Gallia users don't need to set `MOUSER_API` explicitly — `adom-mouser` is a Tier A app (see `adom-app-model`), so it's installed by every `gallia/install.mjs` run from the wiki binary. The CLI autodetects a local `adom-mouser serve` on 127.0.0.1:8775 and falls back to calling Mouser directly if `MOUSER_API_KEY` is set locally. ### Local-only (quick testing)
bin/adom-mouser⋯ 1 unchanged line ⋯
package.json+29−2@@ -1,6 +1,6 @@ { "slug": "adom-mouser",- "version": "1.0.3",+ "version": "1.0.5", "type": "app", "description": "Mouser component search in your workspace \u2014 stock, quantity price breaks, datasheets and lifecycle. CLI verbs, a Hydrogen app, and a shared backend service.", "dependencies": {},@@ -35,5 +35,32 @@ ], "hero": { "path": "screenshots/hero.png"- }+ },+ "discovery_triggers": [+ "mouser",+ "mouser parts",+ "mouser pricing",+ "mouser search",+ "mouser part number",+ "component search",+ "part lookup",+ "price breaks",+ "datasheet mouser",+ "in stock mouser"+ ],+ "discovery_pitch": "Search Mouser Electronics for components, pricing, stock, and datasheets \u2014 CLI + webview app + shared backend service.",+ "sample_prompts": [+ {+ "label": "find an ESP32-S3-WROOM module on Mouser",+ "prompt": "find an ESP32-S3-WROOM module on Mouser"+ },+ {+ "label": "what does an STM32F103RBT6 cost at Mouse",+ "prompt": "what does an STM32F103RBT6 cost at Mouser"+ },+ {+ "label": "Mouser stock for a USB-C receptacle",+ "prompt": "Mouser stock for a USB-C receptacle"+ }+ ] }
page.json+14−5@@ -4,7 +4,7 @@ "slug": "adom-mouser", "title": "Mouser Electronics Search", "brief": "Mouser component search in your workspace — stock, quantity price breaks, datasheets and lifecycle. CLI verbs, a Hydrogen app, and a shared backend service.",- "version": "1.0.4",+ "version": "1.0.5", "install": { "binary_name": "adom-mouser", "install_dir": "",@@ -35,9 +35,18 @@ "path": "screenshots/hero.png" }, "sample_prompts": [- "find an ESP32-S3-WROOM module on Mouser",- "what does an STM32F103RBT6 cost at Mouser",- "Mouser stock for a USB-C receptacle"+ {+ "label": "find an ESP32-S3-WROOM module on Mouser",+ "prompt": "find an ESP32-S3-WROOM module on Mouser"+ },+ {+ "label": "what does an STM32F103RBT6 cost at Mouse",+ "prompt": "what does an STM32F103RBT6 cost at Mouser"+ },+ {+ "label": "Mouser stock for a USB-C receptacle",+ "prompt": "Mouser stock for a USB-C receptacle"+ } ], "discovery_triggers": [ "mouser",@@ -51,7 +60,7 @@ "datasheet mouser", "in stock mouser" ],- "discovery_pitch": "Search Mouser Electronics for components, pricing, stock, and datasheets — CLI + Hydrogen webview app + shared backend service.",+ "discovery_pitch": "Search Mouser Electronics for components, pricing, stock, and datasheets — CLI + webview app + shared backend service.", "metadata": { "platform": "linux" },
skills/adom-mouser-build/SKILL.md+3−3@@ -44,10 +44,10 @@ A release syncs five places to the same version X.Y.Z: curl -s https://mouser-<slug>.adom.cloud/health | jq '.version' # → "X.Y.Z" ``` -7. **Verify on a fresh user container** (optional, but catches install regressions):+7. **Verify on a fresh user container** (optional, but catches gallia regressions): ```bash # on a fresh container:- adompkg install --refresh # Tier A block fetches from the registry+ node ~/gallia/install.mjs # Tier A block fetches from wiki adom-mouser --version # → "adom-mouser X.Y.Z" ``` @@ -57,7 +57,7 @@ A release syncs five places to the same version X.Y.Z: - [ ] Wiki page at `apps/adom-mouser` renders the new `install_hint` one-liner - [ ] User has seen a working screenshot of the webview - [ ] No console errors via `GET /console`-- [ ] `adompkg install --refresh` still pulls + installs the new version (Tier A)+- [ ] `gallia/install.mjs` Tier A block still works (pulls + installs the new version) - [ ] **Brand audit — in-app icons are monochrome white.** Run: ``` grep -nE 'fill="#00b8b0"|stroke="#00b8b0"|color: var\(--accent\)' src/app/*.html src/app/*.svg 2>/dev/null
skills/adom-mouser/SKILL.md+1−1@@ -188,7 +188,7 @@ adom-mouser search "LM317" adom-mouser app # UI reads $MOUSER_API automatically ``` -Users don't need to set `MOUSER_API` explicitly — `adom-mouser` is a Tier A app (see `adom-app-model`), so it's installed by every `adompkg install` run from the registry. The CLI autodetects a local `adom-mouser serve` on 127.0.0.1:8775 and falls back to calling Mouser directly if `MOUSER_API_KEY` is set locally.+Gallia users don't need to set `MOUSER_API` explicitly — `adom-mouser` is a Tier A app (see `adom-app-model`), so it's installed by every `gallia/install.mjs` run from the wiki binary. The CLI autodetects a local `adom-mouser serve` on 127.0.0.1:8775 and falls back to calling Mouser directly if `MOUSER_API_KEY` is set locally. ### Local-only (quick testing)