app
Parts Search
Public Made by Adomby adom
One search box across Mouser, DigiKey and JLCPCB: parallel queries, side-by-side product photos, and a Mouser-preferred recommendation that reasons around stock and lead time.
← Commit history
Publish 2.0.13
6 files changed
+91−25
SKILL.md+1−15@@ -1,7 +1,6 @@ --- name: adom-parts-search-description: >-- Unified parts search across Mouser + DigiKey + JLCPCB with a Mouser-preferred best-source recommendation. CLI and Hydrogen webview app. IMPORTANT, vendor searches are quota-limited (shared daily API keys), so never poll or retry searches in a loop. Use when the user asks to source a part, price a component, compare vendors, check stock across distributors, or assemble a BOM. Trigger words: find part, search parts, source component, parts search, component search, where can I get, compare distributors, Mouser or DigiKey, compare prices, BOM sourcing, stock check, parts availability, open parts search, parts search app, parts search UI, parts search settings, parts search health, parts search dock.+description: Unified parts search across Mouser + DigiKey + JLCPCB with a Mouser-preferred best-source recommendation. CLI and Hydrogen webview app. IMPORTANT, vendor searches are quota-limited (shared daily API keys), so never poll or retry searches in a loop. Use when the user asks to source a part, price a component, compare vendors, check stock across distributors, or assemble a BOM. Trigger words: find part, search parts, source component, parts search, component search, where can I get, compare distributors, Mouser or DigiKey, compare prices, BOM sourcing, stock check, parts availability, open parts search, parts search app, parts search UI, parts search settings, parts search health, parts search dock. --- # adom-parts-search@@ -10,13 +9,6 @@ Searches Mouser + DigiKey + JLCPCB in parallel. Rust CLI + Hydrogen webview. Rec **Quota rule: NEVER search in a loop.** Every search spends the shared daily vendor API quota (Mouser's free tier is about 1000/day for everyone combined). One search per user question. Never retry a rate-limited vendor on a timer, never poll /search, never re-run a search to refresh a page (the page re-renders from `GET /state` for free). The server answers an identical repeat within 5 minutes from its own cache, but do not lean on that: just do not loop. -## Prefer Adom Basic Parts already on hand--For Adom/InstaPCB builds, begin with the existing [Adom Basic Parts catalog](https://wiki.adom.inc/adom/adom-basic-parts) and check live `pnp-inventory` quantities for the exact MPNs. Bias selection toward qualified stocked parts and reuse their component pages. Catalog membership and nominal value are not enough: verify actual quantity/packaging and electrical, thermal, mechanical, process and requested manufacturer-model provenance requirements. Adom Basic Parts is separate from JLCPCB's Basic tier.--If inventory disagrees with a user's physical-stock knowledge, preserve both observations and flag the count for reconciliation; do not silently claim the reels are absent or edit inventory. Record why a non-basic part is needed. When procurement or replenishment is required, use `adom-parts-search` and prefer Mouser for qualified available parts. Checking stock does not authorize reservations, orders or inventory changes.-- ## CLI **For user-facing searches, always use `show`.** It drives the webview tab AND prints the full vendor-by-vendor result to stdout, so the user sees product photos + 3-column comparison and the AI sees the same data textually. Auto-starts the app server + opens the tab on first run.@@ -235,9 +227,3 @@ Install from the wiki: ```bash adom-wiki pkg install adom/adom-parts-search ```--## InstaPCB purchasing and search guidance--Prefer Mouser for qualified components available in the required quantity and packaging: Adom is a short drive away, and drone delivery is planned. Treat drone delivery as a future capability until current operations confirm it; do not promise it as a present shipping option. Use `adom-parts-search show "<exact MPN>"` to show distributor stock and price comparisons in Hydrogen, preserving VS Code in its existing pane. Read the adom-parts-search skill for shared API quota limits; retain results and never poll searches. Use adom-mouser for vendor-specific detail.--Record the exact manufacturer MPN, Mouser part number, query time, stock, quantity, packaging and confirmed fulfillment status in the BOM. Document an alternate distributor when Mouser cannot meet a qualified requirement; do not weaken electrical or assembly constraints to keep the preferred vendor. Manufacturer datasheets and original STEP provenance remain separate from purchasing source. Stock/prices are snapshots, and nearby fulfillment is not a guaranteed reservation or delivery time.
bin/adom-parts-search⋯ 1 unchanged line ⋯
install.shpackage.json+41−2@@ -1,6 +1,6 @@ { "slug": "adom-parts-search",- "version": "2.0.4",+ "version": "2.0.13", "type": "app", "description": "One search box across Mouser, DigiKey and JLCPCB. Parallel queries, side-by-side product photos, and a Mouser-preferred recommendation that reasons around stock and lead time. Dock Bar ready: serve, health, settings, Say it.", "dependencies": {@@ -38,5 +38,44 @@ "SKILL.md", "BUILD-SKILL.md", "CHANGELOG.md"+ ],+ "changelog": "Module 2.4.0: the panel gutter check now measures against the containing block",+ "discovery_triggers": [+ "parts search",+ "find part",+ "source component",+ "source part",+ "compare distributors",+ "compare vendors",+ "Mouser or DigiKey",+ "BOM sourcing",+ "price this part",+ "where can I get",+ "check stock",+ "parts availability",+ "fastest delivery",+ "cheapest part",+ "component search",+ "part lookup",+ "price breaks"+ ],+ "discovery_pitch": "Search Mouser, DigiKey and JLCPCB in parallel with product photos; Mouser-preferred best-source pick. Say 'with parts search' to your AI.",+ "sample_prompts": [+ {+ "label": "source an STM32F103RBT6",+ "prompt": "source an STM32F103RBT6"+ },+ {+ "label": "where can I get an ESP32-S3-WROOM cheape",+ "prompt": "where can I get an ESP32-S3-WROOM cheapest and fastest"+ },+ {+ "label": "compare Mouser, DigiKey and JLCPCB for a",+ "prompt": "compare Mouser, DigiKey and JLCPCB for an LM555"+ },+ {+ "label": "price this BOM across distributors",+ "prompt": "price this BOM across distributors"+ } ]-}+}
page.json+49−8@@ -4,7 +4,7 @@ "slug": "adom-parts-search", "title": "Parts Search", "brief": "One search box across Mouser, DigiKey and JLCPCB: parallel queries, side-by-side product photos, and a Mouser-preferred recommendation that reasons around stock and lead time.",- "version": "2.0.4",+ "version": "2.0.13", "install": { "binary_name": "adom-parts-search", "install_dir": "",@@ -36,10 +36,22 @@ "path": "screenshots/hero.png" }, "sample_prompts": [- "source an STM32F103RBT6",- "where can I get an ESP32-S3-WROOM cheapest and fastest",- "compare Mouser, DigiKey and JLCPCB for an LM555",- "price this BOM across distributors"+ {+ "label": "source an STM32F103RBT6",+ "prompt": "source an STM32F103RBT6"+ },+ {+ "label": "where can I get an ESP32-S3-WROOM cheape",+ "prompt": "where can I get an ESP32-S3-WROOM cheapest and fastest"+ },+ {+ "label": "compare Mouser, DigiKey and JLCPCB for a",+ "prompt": "compare Mouser, DigiKey and JLCPCB for an LM555"+ },+ {+ "label": "price this BOM across distributors",+ "prompt": "price this BOM across distributors"+ } ], "discovery_triggers": [ "parts search",@@ -54,12 +66,41 @@ "where can I get", "check stock", "parts availability",- "fastest delivery"+ "fastest delivery",+ "cheapest part",+ "component search",+ "part lookup",+ "price breaks" ],- "discovery_pitch": "Search Mouser + DigiKey + JLCPCB in parallel from one interface, with product photos and a Mouser-preferred best-source pick.",+ "discovery_pitch": "Search Mouser, DigiKey and JLCPCB in parallel with product photos; Mouser-preferred best-source pick. Say 'with parts search' to your AI.", "metadata": { "platform": "linux" }, "category": "tools",- "org": "adom"+ "org": "adom",+ "description": "One search box across Mouser, DigiKey and JLCPCB. Parallel queries, side-by-side product photos, and a Mouser-preferred recommendation that reasons around stock and lead time. Dock Bar ready: serve, health, settings, Say it.",+ "dependencies": {+ "adom/adom-mouser": "*",+ "adom/adom-digikey": "*",+ "adom/adom-jlcpcb": "*"+ },+ "needs_sudo": false,+ "scripts": {+ "install": "./install.sh",+ "uninstall": "./uninstall.sh"+ },+ "files": [+ "bin/**",+ "skills/**",+ "docs/icon.svg",+ "dockbar.json",+ "install.sh",+ "uninstall.sh",+ "package.json",+ "README.md",+ "SKILL.md",+ "BUILD-SKILL.md",+ "CHANGELOG.md"+ ],+ "changelog": "Module 2.4.0: the panel gutter check now measures against the containing block" }
uninstall.sh