Find TouchDesigner nodes
find_td_nodesRead-only
Search a TouchDesigner network for nodes matching a name pattern or operator type, with recursive subtree search by default.
Instructions
Read-only: search a network for nodes by name pattern and/or operator type, recursively by default. Returns {count, truncated, matches/paths}. Prefer this over get_td_nodes when you are looking for specific nodes anywhere in a sub-tree (get_td_nodes only lists one COMP's direct children); use get_td_topology when you also need the wiring between them.
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. | |
| pattern | No | Case-insensitive name/path filter with '*' wildcards (e.g. 'text*', '*noise*'). | |
| path_only | No | Return only matching paths. | |
| recursive | No | Search the whole sub-network (true) or only direct children (false). | |
| parent_path | No | Where to search from. | /project1 |
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. | |
| matches | No | Default mode: each matched node as {path, name, type}. | |
| 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. |