Demo video of a website
record_demo_videoRecords a short website demo video from a page tour or step file, hides cookie banners and chat bubbles, and saves MP4, GIF, poster, and step timing data.
Instructions
Records a short demo video of a website: a tour of the pages worth showing, or the steps in a file. The page plays in a browser window on a backdrop, with a visible pointer, smooth scrolling and a zoom on each click. Cookie banners and chat bubbles are hidden, never clicked. Saves demo.mp4 (1920x1080, H.264), demo.gif, poster.png and steps.json, which says where every step starts and ends, in seconds and in frames. (easyscreenshotkit 0.1.1, on this machine.)
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": {
"url": "<url>"
},
"name": "record_demo_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | Frames a second (default 30). | |
| gif | No | Set to false to skip demo.gif. | |
| url | Yes | The website, like https://linear.app | |
| hide | No | CSS selectors of more elements to hide. | |
| lang | No | The site's version in this language, when it has one. | |
| page | No | Pages to take in the tour, like /pricing. | |
| zoom | No | How far a click zooms in, 1 to 2.5 (default 1.5). 1 means no zoom. | |
| clean | No | Set to false to keep the banners and bubbles. | |
| frame | No | Set to false for the page alone, filling the video. | |
| pages | No | Pages in the tour, the home page included (default 4). | |
| steps | No | A YAML or JSON file of steps to follow instead of a tour: visit, scroll, click, type, wait, hover, key. | |
| theme | No | The site's light or dark look (default light). | |
| out_dir | No | Folder to save into, absolute or relative to /app. Default: easyscreenshotkit-demo-{host}. | |
| background | No | Behind the window: a colour like #0f172a, two or three colours for a gradient, or a picture file. | |
| wait_seconds | No | How long to wait for the result before returning a job_id to wait on. 45 is safe for clients that stop a tool call after 60 seconds. | |
| reduced_motion | No | Ask the site for its reduced-motion version. | |
| timeout_seconds | No | Give up after this many seconds (default 900). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kit | Yes | ||
| tool | Yes | ||
| files | No | ||
| folder | No | Where the kit saved its files. | |
| job_id | Yes | ||
| passed | No | For checks: whether the check passed. | |
| status | Yes | ||
| exit_code | No | ||
| last_line | No | What the kit was doing last. | |
| expires_at | No | When the download links stop working. | |
| next_action | No | ||
| elapsed_seconds | Yes |