start_session
Start a Playwright Chromium session for automated testing or demo video creation. Optionally record WebM video with narration and reuse authentication profiles.
Instructions
Start a Playwright Chromium session (headless or windowed) and keep it open. Optional recordVideoPath enables WebM capture at 1920×1080 @ deviceScaleFactor 2 with synthetic cursor and always-on click highlight. When recording, demoMode is on (narrate defaults true): orchestrate auto-paces to TTS. Pass profileId from login or set_session_auth to reuse auth.
Example:
{
"startUrl": "https://app.example.com/dashboard",
"headed": false,
"recordVideoPath": "C:/Videos/demo-clip.webm",
"profileId": "prof_abc"
}Returns: { "sessionId": "sess_…", "headed": false, "recording": true, "demoMode": true, "startUrl": "…" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rate | No | edge-tts rate for demoMode (default +10%) | |
| voice | No | edge-tts voice for demoMode (default en-US-AndrewNeural) | |
| headed | No | Open a visible window (default false) | |
| narrate | No | When recording, auto-pace actions to TTS (default true). Set false for silent recording. | |
| startUrl | No | Optional URL to open first | |
| profileId | No | Auth profile from login | |
| recordVideoPath | No | If set, record WebM to this path; omit to skip recording | |
| storageStatePath | No | Optional path to a Playwright storageState JSON file |