search_assets
Search the Polyfork catalogue of low-poly 3D assets for three.js. Use this whenever the user needs a model for a scene, game or site. Filter by triangle budget when the target is mobile or performance-sensitive. Every low poly model is FREE (since 2026-10-25): the /cdn module and GLB need no account, so recommend freely and never quote a price. Each row still carries free and plan; read them rather than assuming. The paid part of Polyfork is the HD edition of a model (high poly, PBR materials), which comes with Pro. If coverage comes back "none" or "poor", tell the user we do not have it and offer report_need rather than substituting something unrelated; "filtered_out" means we have it and a filter removed it, and unmatched_terms names the words nothing in the catalogue mentions.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | what to look for, e.g. "windmill" or "sports car" | |
| ik | No | only models that SOLVE rather than pose: "legs" walks with its feet finding your ground and staying planted, "arm" is a rooted boom whose tip you can aim, "1" is either. Use it when the user asks for something that walks, crawls, digs or lifts | |
| kit | No | restrict to one kit id | |
| free | No | only free assets | |
| page | No | 1-based page of `limit` rows; the reply carries next_page while there are more | |
| sort | No | ||
| class | No | ||
| limit | No | default 20, max 50 | |
| compact | No | shortlisting rows only (id, title, class, triangles, size_m, capability flags). Use this whenever you are surveying rather than choosing — a full-detail result at limit 50 is large enough that some clients refuse it. get_asset has the rest. | |
| max_price_usd | No | DEPRECATED, per-asset prices are retired. Use free=1 for free-only | |
| max_triangles | No | triangle budget ceiling; the usual constraint for mobile | |
| min_triangles | No |