search_transcript
Search a video’s subtitles for a phrase and return matches with timestamps and speakers. Use it to answer what’s said or find the moment to jump to.
Instructions
Search the currently playing file's subtitles for a phrase and return every match with its timestamp and speaker (if known). Works with loaded subtitle files, sidecar .srt/.vtt/.ass/.ssa files, embedded text tracks, and subtitles you generated with generate_subtitles. Use this to answer questions about what is said in a video, or to find the moment to jump to. Case-insensitive substring match, not regex.
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": {
"query": "<query>"
},
"name": "search_transcript"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | Optional path to a video or subtitle file; defaults to the playing file | |
| limit | No | Maximum matches to return (default 20, max 200) | |
| query | Yes | Phrase to look for | |
| speaker | No | Optional speaker filter (case-insensitive substring match) |