Find TouchDesigner nodes
find_td_nodesRead-only
Search TouchDesigner node hierarchies by name, path, operator type, or family, with depth and time limits, returning only paths and search metadata without loading the full topology.
Instructions
Read-only: compact bridge-side node search by name/path glob, exact or partial operator type, family and bounded depth. Returns {count, truncated, matches/paths, search_metadata} without transferring topology; older bridges fall back only to structured list/topology reads. Prefer this over get_td_nodes when looking through a sub-tree; use get_td_topology only when you need wiring.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Case-insensitive operator-type substring (e.g. 'TOP', 'noise'). | |
| limit | No | Max matches to return. | |
| family | No | Optional exact TouchDesigner operator family. | |
| pattern | No | Case-insensitive name/path filter with '*' wildcards (e.g. 'text*', '*noise*'). | |
| max_depth | No | Maximum descendant depth; 1 means direct children. Overrides recursive=true. | |
| name_glob | No | Additional name-only '*' glob. | |
| path_glob | No | Additional absolute-path '*' glob. | |
| path_only | No | Return only matching paths. | |
| recursive | No | Search the whole sub-network (true) or only direct children (false). | |
| type_match | No | Whether `type` is a substring or an exact operator type. | partial |
| parent_path | No | Where to search from. | /project1 |
| time_limit_ms | No | Hard bridge-side search budget in milliseconds. | |
| node_scan_limit | No | Hard cap on nodes inspected inside TouchDesigner. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Total nodes matched before `limit` truncation. | |
| paths | No | path_only mode: the matched node paths and nothing else. | |
| source | Yes | ||
| matches | No | Default mode: each matched node as {path, name, type, family}. | |
| warnings | No | ||
| recursive | Yes | Whether descendants were searched, echoing the request. | |
| truncated | Yes | True if more nodes matched than `limit` returned. | |
| parent_path | Yes | The network root the search ran under. | |
| search_metadata | No | Current-bridge scan completeness and budget evidence; absent on an older-bridge fallback. |