Search script
search_scriptRead-onlyIdempotent
Find screenplay elements whose text contains the query (case-insensitive substring), in script order. Each match has elementId, type, the containing sceneId and sceneLabel (null outside any scene, e.g. title page or episode/act headings) and a ~160-character snippet around the match. Filter with types (e.g. ["DIALOGUE", "CHARACTER"]). truncated is true when more matches exist than limit. Use get_scene with the sceneId to read the full scene.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum matches to return (1-100, default 25). | |
| query | Yes | Text to find (case-insensitive substring). | |
| types | No | Only search these element types (e.g. ["DIALOGUE"]). | |
| projectId | Yes | ScreenWeaver project id (from list_projects). |