search_objects
Search about 100k 3D objects by English visual description or exact keywords. Returns object IDs plus a numbered contact sheet to pick the right model.
Instructions
Search the Sand3D catalog (about 100k 3D objects with GLB, render and generating Python program, CC BY 4.0). Default mode compares an English text description with the renders (CLIP), so describe the look in English, e.g. 'old red farm tractor'. match_words=true does exact keyword search in names, families, attribution and program code. Returns a numbered text list with object ids and a contact sheet image with the same numbers; names repeat a lot, so pick by the image. Runs against a free single-CPU space by Sandflow: fine for dozens of objects; for bulk work use the open Hugging Face datasets Sandflow/sand3d-*.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_objects"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many results to return (1-200). | |
| query | No | English description of the object, or keywords when match_words=true. Empty lists the catalog with filters. | |
| family | No | Family key or label inside the dataset (needs dataset), e.g. 'musical instrument'. | |
| offset | No | Skip this many results (pagination). | |
| dataset | No | Limit to one dataset: objaverse, cad, articraft, simready, automate. See list_datasets. | |
| match_words | No | Exact keyword search instead of visual meaning search. | |
| contact_sheet | No | Attach a numbered contact sheet JPEG of the renders (about 100-380 KB). | |
| assembly_parts | No | Search individual parts of AutoMate assemblies. | |
| only_with_joints | No | Only articulated objects (doors, wheels, levers that move). | |
| include_without_glb | No | Also return objects that have no GLB (only USDA). |