find
Search stored layer names and text in a saved Figma .fig file to locate matches and return IDs, paths, sizes, and text previews.
Instructions
Search stored layer names and text (case-insensitive). Returns ids, paths, local sizes and text previews. Does not expand instance children; use inspect on the instance. Copy inside instance overrides, text or boolean properties or swapped components is found by search, not find.
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": {
"file": "<file>",
"query": "<query>"
},
"name": "find"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | the saved .fig: a local path (absolute recommended), or gs://bucket/object using gcloud; remote sources are unavailable with --root | |
| node | No | search this stored subtree; default the document; use inspect for instance sublayers | 0:0 |
| type | No | Figma node type, e.g. FRAME or TEXT | |
| limit | No | 1-200 results, default 20; truncated signals more matches | |
| query | Yes | literal substring in a layer name or text |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root | Yes | ||
| results | Yes | ||
| freshness | No | only on no results in a mapped copy known to be stale: the freshness design report plus hint | |
| truncated | Yes |