browser-control skillA
browser-control is agent-read markdown (skill) from zwl467135974/lumina: 用 Playwright 浏览器工具完成打开网页、读取内容、表单交互与截图留证；适用于网页信息采集、Web 界面验证、在线文档读取等需要真实浏览器环境的任务.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 浏览器控制（Playwright）
通过 MCP 接入的官方 `@playwright/mcp` 工具面驱动真实浏览器。工具命名规则为
`mcp__{server}__{tool}`，下文以 server 名 `playwright` 为例（实际前缀以当前
环境的 MCP 配置为准）。
## 核心工作流：快照 → 定位 → 操作 → 留证
1. **打开页面**：`mcp__playwright__browser_navigate(url)`。等待加载完成后
先取结构化快照，不要急于截图。
2. **读取结构**：`mcp__playwright__browser_snapshot`。返回页面的可访问性
树，每个可交互元素带 `ref` 编号——这是后续操作的定位依据。
3. **定位操作**：`browser_click(element, ref)`、`browser_type(element, ref, text)`、
`browser_fill_form(fields)`、`browser_select_option(element, ref, values)`、
`browser_press_key(key)`。**必须使用快照中的 ref 定位，不要凭记忆猜
CSS 选择器**；页面变化后重新取快照再操作。
4. **视觉留证**：`browser_take_screenshot` 仅在需要视觉证据（布局、颜色、
渲染问题）时使用；结构化信息一律以快照为准，省 token 且更精确。
## 页面状态与多标签
- 弹出对话框（alert/confirm/prompt）：先 `browser_handle_dialog(accept)`，
不要让对话框阻塞后续操作。
- 新窗口/弹出页：操作后用 `browser_tabs(action: "list")` 观察全部标签页，
`browser_tabs(action: "select", index: n)` 切换。
- 等待动态内容：`browser_wait_for(text=..., time=...)`，不要连续无脑重试。
## 排障顺序
页面不符合预期时按序排查：
1. 重新 `browser_snapshot` 确认当前真实状态（可能已被重定向）；
2. `browser_console_messages(level: "error")` 看前端报错；
3. `browser_network_requests` 确认关键请求是否成功（4xx/5xx/超时）；
4. 仍无头绪再截图人工判读。
## 纪律
- **快照优先**：能用快照解决的绝不用截图，能用文本绝不用视觉。
…Read the whole file at its exact version.
How to install
mdr add zwl467135974/lumina/browser-control@git:20260922.d41dfb0mdr add zwl467135974/lumina/browser-control@sha256:56cd6b07949a60bcPin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_mjifbixhhahvlu4o)
1 badge views in 30 days
Versions
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2970 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
zwl467135974/lumina · 75 stars · license Apache-2.0 · pushed 2026-09-22 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_mjifbixhhahvlu4o GET https://markdownregistry.com/api/v1/resolve?ref=zwl467135974/lumina/browser-control GET https://markdownregistry.com/api/v1/blob/56cd6b07949a60bc51a7e87cb11f436ff3eb89d1603554b2c179eed511492e4e
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
More from zwl467135974/lumina
Every file in zwl467135974/lumina