playwright-bowser
Headless browser automation using Playwright CLI. Use when you need headless browsing, parallel browser sessions, UI testing, screenshots, web scraping, or browser automation that can run in the background. Keywords - playwright, headless, browser, test, screenshot, scrape, parallel.
- License 许可
- MIT
- 最近更新
- 2026-10-31
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- playwright-bowser
- description
- Headless browser automation using Playwright CLI. Use when you need headless browsing, parallel browser sessions, UI testing, screenshots, web scraping, or browser automation that can run in the background. Keywords - playwright, headless, browser, test, screenshot, scrape, parallel.
- allowed-tools
- Bash
03 SKILL.md 正文
Playwright Bowser
Purpose
Automate browsers using playwright-cli — a token-efficient CLI for Playwright. Runs headless by default, supports parallel sessions via named sessions (-s=), and doesn't load tool schemas into context.
Key Details
- Headless by default — pass
--headedtoopento see the browser - Parallel sessions — use
-s=<name>to run multiple independent browser instances - Persistent profiles — cookies and storage state preserved between calls
- Token-efficient — CLI-based, no accessibility trees or tool schemas in context
- Vision mode (opt-in) — set
PLAYWRIGHT_MCP_CAPS=visionto receive screenshots as image responses in context instead of just saving to disk
Sessions
Always use a named session. Derive a short, descriptive kebab-case name from the user's prompt. This gives each task a persistent browser profile (cookies, localStorage, history) that accumulates across calls.
# Derive session name from prompt context:
# "test the volon dashboard" → -s=volon-dashboard
# "UI test the tasks page" → -s=volon-tasks
playwright-cli -s=volon-dashboard open http://localhost:5173 --persistent
playwright-cli -s=volon-dashboard snapshot
playwright-cli -s=volon-dashboard click e12
Managing sessions:
playwright-cli list # list all sessions
playwright-cli close-all # close all sessions
playwright-cli -s=<name> close # close specific session
playwright-cli -s=<name> delete-data # wipe session profile
Quick Reference
Core: open [url], goto <url>, click <ref>, fill <ref> <text>, type <text>, snapshot, screenshot [ref], close
Navigate: go-back, go-forward, reload
Keyboard: press <key>, keydown <key>, keyup <key>
Mouse: mousemove <x> <y>, mousedown, mouseup, mousewheel <dx> <dy>
Tabs: tab-list, tab-new [url], tab-close [index], tab-select <index>
Save: screenshot [ref], pdf, screenshot --filename=f
Storage: state-save, state-load, cookie-*, localstorage-*, sessionstorage-*
Network: route <pattern>, route-list, unroute, network
DevTools: console, run-code <code>, tracing-start/stop, video-start/stop
Sessions: -s=<name> <cmd>, list, close-all, kill-all
Config: open --headed, open --browser=chrome, resize <w> <h>
Workflow
- Derive a session name from the user's prompt and open with
--persistentto preserve cookies/state. Always set the viewport via env var at launch:
PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<session-name> open <url> --persistent
# or headed:
PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<session-name> open <url> --persistent --headed
# or with vision (screenshots returned as image responses in context):
PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 PLAYWRIGHT_MCP_CAPS=vision playwright-cli -s=<session-name> open <url> --persistent
- Get element references via snapshot:
playwright-cli snapshot
- Interact using refs from snapshot:
playwright-cli click <ref>
playwright-cli fill <ref> "text"
playwright-cli type "text"
playwright-cli press Enter
- Capture results:
playwright-cli screenshot
playwright-cli screenshot --filename=output.png
- Always close the session when done.
playwright-cli -s=<session-name> close
Fragments Engine GUI Defaults
- Volon GUI dev server:
http://localhost:1420 - Volon API server:
http://localhost:8085 - Mentat GUI dev server: check Cerberus for current port
- Screenshots output:
./screenshots/bowser-qa/
Full Help
Run playwright-cli --help or playwright-cli --help <command> for detailed command usage.
04 同仓库更多 Skills
Sample Skill
A sample skill fixture exercising scripts/, references/, assets/, and declared parameters/dependencies.
Malformed Skill
A malformed skill fixture whose scripts entry does not exist on disk.
malformed-frontmatter
Missing the required name field.
Resolver Parent
A skill declaring both a required, resolver-bound parameter and a nested dependency on resolver-child.
Resolver Child
A minimal nested skill, installed independently so the resolver dependency-address test can resolve a real dependency against it.
Compose Multilevel Root
Root skill for a 3-level composition chain crossing both inline and fork.