browser

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Browser Automation

浏览器自动化

Minimal Chrome DevTools Protocol (CDP) helpers for browser automation without MCP server setup.

无需搭建MCP服务器，基于Chrome DevTools Protocol（CDP）的轻量浏览器自动化工具集。

Setup

设置

Install dependencies before first use:

bash

npm install --prefix ~/.claude/skills/browser/browser ws

首次使用前安装依赖：

bash

npm install --prefix ~/.claude/skills/browser/browser ws

Scripts

脚本

All scripts connect to Chrome on

localhost:9222

所有脚本均连接到

localhost:9222

上的Chrome。

start.js - Launch Chrome

start.js - 启动Chrome

bash

scripts/start.js              # Fresh profile
scripts/start.js --profile    # Use persistent profile (keeps cookies/auth)

bash

scripts/start.js              # 全新配置文件
scripts/start.js --profile    # 使用持久化配置文件（保留Cookie/认证信息）

nav.js - Navigate

nav.js - 页面导航

bash

scripts/nav.js https://example.com        # Navigate current tab
scripts/nav.js https://example.com --new  # Open in new tab

bash

scripts/nav.js https://example.com        # 导航当前标签页
scripts/nav.js https://example.com --new  # 在新标签页打开

eval.js - Execute JavaScript

eval.js - 执行JavaScript

bash

scripts/eval.js 'document.title'
scripts/eval.js '(() => { const x = 1; return x + 1; })()'

Use single expressions or IIFE for multiple statements.

bash

scripts/eval.js 'document.title'
scripts/eval.js '(() => { const x = 1; return x + 1; })()'

支持单个表达式或立即执行函数表达式（IIFE）以处理多条语句。

screenshot.js - Capture Screenshot

screenshot.js - 捕获截图

bash

scripts/screenshot.js

Returns

{ path, filename }

of saved PNG in temp directory.

bash

scripts/screenshot.js

返回临时目录中保存的PNG文件的

{ path, filename }

信息。

pick.js - Visual Element Picker

pick.js - 可视化元素选择器

bash

scripts/pick.js "Click the submit button"

Returns element metadata: tag, id, classes, text, href, selector, rect.

bash

scripts/pick.js "Click the submit button"

返回元素元数据：标签、ID、类名、文本、链接、选择器、矩形区域。

Workflow

工作流程

Launch Chrome:
```
scripts/start.js --profile
```
for authenticated sessions
Navigate:
```
scripts/nav.js <url>
```

Inspect:

scripts/eval.js 'document.querySelector(...)'

Capture:
```
scripts/screenshot.js
```
or
```
scripts/pick.js
```
Return gathered data

启动Chrome：若需已认证会话，使用
```
scripts/start.js --profile
```
页面导航：
```
scripts/nav.js <url>
```

元素检查：

scripts/eval.js 'document.querySelector(...)'

内容捕获：使用
```
scripts/screenshot.js
```
或
```
scripts/pick.js
```
返回收集到的数据

Key Points

关键要点

All operations run locally - credentials never leave the machine
Use
```
--profile
```
flag to preserve cookies and auth tokens
Scripts return structured JSON for agent consumption

所有操作均在本地运行 - 凭据绝不会离开本地机器
使用
```
--profile
```
参数可保留Cookie和认证令牌
脚本返回结构化JSON供Agent使用