Find files under folders
nas_file_findSearch multiple NAS shared folders and return files or folders matching name, type, size, time, and depth filters in one request.
Instructions
Walk one or more folders and return entries matching the filters. kind selects plain files, folders, or a media category (image, video, audio, archive, doc, font, app). Sizes take a unit suffix such as 10K or 4M. since and until are Unix seconds and need time_field to say which timestamp they apply to. Roots must be shared folders or folders inside them; a volume root is reported as an invalid root. All roots are searched in one request, so matches are in the top-level entries[] of the result, and that key is absent when nothing matched. For finding files by name across a large area, nas_search_files is faster.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"roots": "<roots>"
},
"name": "nas_file_find"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Only plain files, only folders, or only one media category. | |
| name | No | File name pattern with * and ?, for example *.jpg. | |
| limit | No | Maximum number of results; 0 means no limit. | |
| roots | Yes | Folders to search in. Absolute NAS paths (1 to 20). | |
| since | No | Only entries at or after this time. Unix time in seconds. | |
| until | No | Only entries at or before this time. Unix time in seconds. | |
| max_size | No | Largest file size to include. Bytes, or a number with K, M or G, for example 10K or 4M. | |
| min_size | No | Smallest file size to include. Bytes, or a number with K, M or G, for example 10K or 4M. | |
| max_depth | No | How many folder levels to descend; omit for no limit. | |
| time_field | No | Timestamp that since/until apply to: creation, modification, access or deletion time. | |
| timeout_seconds | No | Time limit in seconds (default 120, max 1800). Raise it for large folders or files; a result cut off by the limit is incomplete. |