Get scene
get_sceneRead one scene of the screenplay. Returns the scene label, episodeIndex (0 when the scene comes before the script's first EPISODE), heading, placeId (linked place entity, if any) and its elements in order: the SCENE_HEADING itself, then every element up to (not including) the next SCENE_HEADING or structure element (EPISODE, ACT, SEQUENCE, STORY_BEAT). Each element has elementId, type, content, and characterId / placeId when linked to an entity (see list_entities). A CHARACTER element's content is the name plus any cue extension ("MARA (O.S.)"); the extension is also returned on its own as extension. With includeShots (default true) it also returns the scene's storyboard shots in the same shape as list_shots. Get sceneId from get_project_outline or search_script.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sceneId | Yes | Scene id (the SCENE_HEADING element id from get_project_outline). | |
| projectId | Yes | ScreenWeaver project id (from list_projects). | |
| includeShots | No | Include the scene's storyboard shots (default true). |