Plumb · source
plumb_sourceSearch and fetch design assets from the open web — icons, photos, avatars, illustrations — with parallel provider queries and ranking. Use search mode for metadata or fetch to download the best match.
Instructions
Source design assets from the open web — icons, photos, avatars, illustrations — for the write direction. Queries every provider in parallel (keyless-first: Iconify, Lorem Picsum, DiceBear always work; Unsplash / Pexels / Pixabay activate when their API key is in env) and ranks the results with one scoring function, including pick-the-right-icon-pack so a design uses ONE consistent icon family. Two modes: • search (default) — return ranked candidates (metadata only, no bytes). Cheap; use to see what's available and which icon pack was locked. • fetch — resolve the best match, download its bytes to a local folder, and return the path (+ inline SVG / small data: URI). Never fails: a total miss degrades to a deterministic placeholder.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| h | No | Desired height (photos / placeholders). | |
| w | No | Desired width (photos / placeholders). | |
| kind | No | Constrain to one asset kind. | |
| mode | No | `search` (default) returns ranked candidates; `fetch` downloads the best. | |
| seed | No | Deterministic seed for avatars / placeholders. | |
| limit | No | Max candidates in search mode. Default 16. | |
| query | Yes | What to look for, e.g. 'rocket launch' or 'shopping cart'. | |
| style | No | Preferred style tags (ranking hint). | |
| aspect | No | Target width/height ratio (ranking hint). | |
| inline | No | fetch mode: also return the bytes inline (SVG markup / small data: URI). | |
| weight | No | Icon weight preference. | |
| palette | No | Brand hex colors — recolors monotone SVG icons. | |
| minWidth | No | Minimum acceptable pixel width. | |
| provider | No | Restrict to one provider id (iconify, unsplash, pexels, pixabay, dicebear, picsum, …). |