Command · Find Shorts
shorts.find
Finds the best moments of a long sequence for vertical shorts (20-90 s each): whole sentences, a hook in the first seconds, one topic, lively delivery, faces, few fillers; optionally about a topic ("query").
- v1
- Capability Read
- Tool
shorts_find
Request
{
"command": "shorts.find",
"params": {
"count": 5,
"query": "pricing"
}
}Parameters
analyzeboolean- Analyse faces and motion of media not analysed yet (slow for long media; default false: cached analyses only).
countinteger (1..20)- How many shorts (default 5).
maxDurationnumber (5.0..600.0)- Longest short in seconds (default 90).
minDurationnumber (5.0..600.0)- Shortest short in seconds (default 20).
querystring- What the shorts should be about, e.g. "the pricing discussion".
rerankboolean- Also let the user's cloud chat model rank and title the best ones from their transcript text (needs consent; never for a no-cloud project; default false).
sequenceinteger (1..)- The sequence to search (a podcast, an interview); only needed when the project has several.
targetDurationnumber (5.0..600.0)- Preferred length in seconds (default 45).
Discussion
Finds the best moments of a long sequence for vertical shorts (20-90 s each): whole sentences, a hook in the first seconds, one topic, lively delivery, faces, few fillers; optionally about a topic ("query"). Returns them best first with a score breakdown, reasons, a suggested title, the words and a start/end (seconds; ticks too) snapped to sentences and cuts, ready for shorts.create. Needs the media's transcripts. A read: it changes nothing.
Run it with wabcut-cli cmd <project> --json, from an MCP client as shorts_find, or from an extension. See Edit commands for requests, references and results.
See also
shorts.*
- shorts.create
Create Shorts. Makes one new sequence per short (from shorts.find): the range cut out of the source sequence, reframed to 9:16 (or "aspect") with editable keyframes following the speaker, captioned, with the title as a hook for its first seconds; optionally cleaned of fillers and silences and normalised to -14 LUFS.