search_references
Find design references in the saved corpus by filtering host, owner, or tags or using a free-text query against the taxonomy. Returns score, matched fields, and credit.
Instructions
Find patterns previously kept with capture_reference — call it before rebuilding something already grabbed, or to recall 'that hero from Linear'. host, owner, and tags filters compose with AND; the free-text query expands recognized pattern intent through Raven's controlled vocabulary, then matches case-insensitively against note, app, tags, bound taxonomy ids, and selector. Every result carries a score and a 'why' naming the matched fields and any alias that connected the query to the record. Ordering is deterministic. Returns stored JSON records. Every result carries a display object holding the credit line, the source URL, and image_path — the PNG on disk for records captured with html, so results can be shown as pictures rather than style maps (the tool returns the path, never the bytes). Browsing does not hand back the other site's markup. A result reports html_available and html_truncated but omits the html itself; pass include_html:true to receive it, which is a deliberate step because that markup is the site's own authored expression rather than a measurement of it. Everything needed to LOOK at a pattern and to translate it onto this project's tokens — the picture, the selector, the rect, the computed styles — is in the default result. Show the credit whenever you show the pattern: this corpus holds other people's design work, Raven does not own it, and a third-party result also carries a notice saying so. Use these as references to build your own implementation, not as work to republish. Corrupt records are named in skipped[] instead of failing the call. It does not rank against live code and does not fetch the source site.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Only references grabbed from this host, e.g. 'linear.app' | |
| tags | No | Only references carrying ALL of these tags | |
| owner | No | Only the user's own product, or only third-party sites | |
| query | No | Free text expanded through the pattern taxonomy and matched against note, app, tags, bound taxonomy ids, and selector; omit to list everything passing the filters | |
| include_html | No | Return each record's captured markup verbatim. Off by default: browsing a corpus of other people's work should not hand back their markup as a side effect of looking at it. Ask for it when you are actually reading the structure. |