search_timestamp
Describe what you’re looking for in plain language, and the tool returns the timestamp where that event, object, or phrase appears in the video.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
videoPath | string | ✓ | Path to the video, file:// URI, or remote URL |
query | string | ✓ | Natural language description of what to find |
provider | string | — | Override the AI provider: gemini, m3, kimi, qwen, mimo, glm |
Usage Examples
Section titled “Usage Examples”Find a gesture:
“At what timestamp does the person wave in
./clip.mp4?”
Find spoken content:
“At what point does the speaker mention pricing in
https://www.youtube.com/watch?v=abc123?”
Find a visual element:
“When does the code editor first appear in
./tutorial.mp4?”
Find a scene transition:
“At what timestamp does the presentation switch from slides to a live demo in
./webinar.mp4?”
Find a person:
“When does Alice appear on screen in
./meeting.mp4?”
Return Value
Section titled “Return Value”The tool returns the timestamp in MM:SS or HH:MM:SS format along with a brief description of the matched moment. If nothing matching is found, it returns a message indicating no match.