Capture motion over time
capture_motionCapture live motion from any webpage by sampling frames and numeric animation curves after load, scroll, hover, or click.
Instructions
Use this when you need to observe actual motion, especially JS-driven animation. Avoid it when declared CSS and WAAPI definitions are sufficient; use extract_animations. Sample frames, live animations, and numeric style curves after load, scroll, hover, or click. Cost: heavy. Session: uses one browser page for one URL. May write files when an output path is provided. Possible follow-ups if evidence is still missing: inspect_component, compare_replica.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Absolute http:// or https:// URL to capture motion from. | |
| samples | No | Number of frames to capture. | |
| trigger | No | What starts the motion: page load (reloads and samples immediately), scrolling, or hover/click on a selector. | load |
| selector | No | Required for hover/click; optional scroll target for the scroll trigger. | |
| outputDir | No | Absolute directory to save all frames into as motion-frame-N.jpg. | |
| timeoutMs | No | Navigation timeout in milliseconds. | |
| userAgent | No | Optional browser user-agent override. | |
| waitUntil | No | Page lifecycle event to await before extraction. | domcontentloaded |
| intervalMs | No | Target milliseconds between frames. | |
| maxAnimations | No | Cap on Web Animations API entries returned. | |
| viewportWidth | No | Browser viewport width in CSS pixels. | |
| trackSelectors | No | Extra elements whose computed transform/opacity/filter/clip-path are sampled at every frame. | |
| viewportHeight | No | Browser viewport height in CSS pixels. | |
| maxInlineFrames | No | How many frames to return inline as images. | |
| maxTrackedElements | No | Cap on elements sampled for numeric motion curves. | |
| allowPrivateNetwork | No | Allow localhost and private-network URLs. Enable only for trusted sites. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Observed motion data; frame images are returned as MCP image content. | |
| guidance | Yes |