aawchips
v0.1.1
Published
A tiny CLI for accessing real electronic component data from your terminal.
Readme
AAWChips CLI
Component data for hardware agents.
AAWChips helps scripts, AI agents, and hardware workflows find real purchasable electronic parts with stock, pricing, specs, datasheets, and buy links.
Request a free API key at aawchips.aawlab.com.
Quickstart
npm install -g aawchips
export AAWCHIPS_API_KEY=...
aawchips search "10k 1% 0603 resistor"Commands
Search for components by specs or natural language:
aawchips search "100nF 0402 capacitor"
aawchips search "3.3V LDO 500mA" --limit 3Look up a specific part by component ID or MPN:
aawchips part C17414
aawchips part 0805W8F1002T5ESave your API key locally:
aawchips config set-key ...JSON Output
Use --json when calling from scripts or agents.
aawchips search "USB-C connector" --limit 3 --json
aawchips part C17414 --jsonExample response shape:
{
"query": "100nF 0402 capacitor",
"count": 3,
"results": [
{
"lcsc": "C152814",
"mpn": "0402B104K500CT",
"manufacturer": "Walsin Tech Corp",
"category": "Capacitors",
"package": "0402",
"stock": 741431,
"price_tiers": [
{ "min_qty": 1, "unit_price_usd": 0.0077 }
],
"normalized": {
"capacitance_f": 1e-7,
"voltage_v": 50,
"tolerance_fraction": 0.1
},
"datasheet": "https://...",
"links": [
{ "source": "LCSC", "verified": true, "url": "https://..." },
{ "source": "DigiKey", "verified": false, "url": "https://..." }
]
}
]
}API Key
The CLI reads your key from AAWCHIPS_API_KEY first. If that is not set, it reads the local config file at ~/.config/aawchips/config.json.
export AAWCHIPS_API_KEY=...or:
aawchips config set-key ...HTTP Equivalent
curl -G "https://api.aawchips.aawlab.com/search" \
-H "X-API-Key: $AAWCHIPS_API_KEY" \
--data-urlencode "q=100nF 0402 capacitor" \
-d "limit=3"Environment
AAWCHIPS_API_KEY: API key. Takes priority over local config.AAWCHIPS_API_URL: API base URL. Defaults tohttps://api.aawchips.aawlab.com.
