browser-use
/browser-use
Otwiera, sprawdza i testuje prawdziwą stronę www od początku do końca, bez łączenia z przeglądarką użytkownika.
- Autor
- mdiri-ai ↗
- Repozytorium
- SoduWork ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 4
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 4 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/browser-session.mjs, scripts/browser.mjs, tests/browser-use.test.mjs, tests/persistent-browser.test.mjs
Co robi i kiedy
Otwiera, sprawdza i testuje prawdziwą stronę www od początku do końca, bez łączenia z przeglądarką użytkownika.
Oryginalny opis (EN)
Use when a real web page must be opened, inspected, interacted with, or validated end to end without connecting to the user's existing browser.
Jak działa
- 硬规则
- 快速参考
- 验证与交付
- 自动发布专用浏览器
Podgląd SKILL.md
---
name: browser-use
description: Use when a real web page must be opened, inspected, interacted with, or validated end to end without connecting to the user's existing browser.
---
# Browser Use
用项目脚本通过 Chrome DevTools Protocol 驱动**自己启动的隔离浏览器**。零依赖,只用 Node 22+ 内置 `WebSocket`;普通会话拥有独立端口、临时用户目录、标记页和 20 分钟空闲看门狗;明确授权的发布任务可选择持久专用会话。
## 硬规则
1. 不连接系统里已有的日常 Chrome/Edge。普通会话使用随机端口、独立临时 profile;明确授权的发布/运营任务可用 --persistent,默认专用端口 9337(SODUWORK_PUBLISH_BROWSER_PORT 可配置,0 自动分配)。两种模式都核对归属标记;端口占用时拒绝接管或关闭其他浏览器。
2. 普通工作流复用同一个 --session,不同任务使用不同 ID,结束后 close。用户明确要求记住登录态的发布任务使用 --persistent 和用户/空间隔离的稳定 ID,跨任务复用;窗口保留,不运行临时会话清理。显式 close --persistent 仅关闭本会话,不删除 profile;并发启动有锁。
3. 导航只接受 `http`、`https`、`file` 和 `about:blank`,拒绝带账号密码的 URL;导航失败、CDP 断开、元素不存在或不可编辑都会返回非零退出码。
4. 不替用户登录或保存凭据,除非当前请求明确授权;不把凭据写入参数、日志、截图。不要点删除、下单、发布等不可逆按钮,除非请求正文明确要求。
## 快速参考
```bash
S=skills/browser-use/scripts/browser.mjs
node $S shot https://example.com out.png --session task-123
node $S text current --session task-123
node $S errors current --session task-123
node $S do current '[{"click":"#open"},{"wait":300},{"shot":"after.png"},{"text":true}]' --session task-123
node $S status --session task-123
node $S close --session task-123
```
`do` 支持 `goto`、`click`、`fill`、`upload`(输入框、文本域和 contenteditable)、`wait`、`eval`、`shot`、`text`,一次最多 50 步;单步等待最多 30 秒、总等待最多 2 分钟。动作在连接浏览器前先校验,避免无效 JSON 启动会话。点击会自动滚动到可见区域并拒绝隐藏、禁用元素;截图会自动创建父目录。
## 验证与交付
先用 `text` 或 `shot`确认页面和目标,再执行点击/填写;关键动作前后各留一张截图。用 `errors` 检查控制台,用 `status`确认会话仍在运行,完成后关闭会话。把页面文字、截图路径和实际结果交回,不要只说“已操作”。
## 自动发布专用浏览器
仅用户明确要求实际发布、保存登录态或复用该发布会话采集时启用;普通浏览保持临时隔离。使用可见窗口供用户登录/验证码,不能绕过人工验证。profile 位于当前操作系统用户的 SoduWork/publishing-browser 目录,不能复制到工程、日志或插件包。
```bash
node "$S" tabs current --persistent --session publishing-<user-workspace-hash>
node "$S" open-tab https://example.com/publish --persistent --session publishing-<user-workspace-hash>
node "$S" text current --tab <targetId> --persistent --session publishing-<user-workspace-hash>
node "$S" do current '[{"upload":{"sel":"input[type=file]","files":["C:/absolute/document.pdf"]}}]' --tab <targetId> --persistent --session publishing-<user-workspace-hash>
```
先 tabs 检查已有页,每个选定网站复用一个标签页;open-tab 返回 targetId,后续 --tab 只接受此受管浏览器内的标签页。upload 只接受 1..30 个已存在的本地绝对文件路径;先读取实际页面定位输入框,不猜选择器。普通 close 不影响持久会话;需要关闭时加 --persistent,登录态仍保留。测试可加 --headless;业务发布默认可见,等待人工时不能关闭。环境变量 SODUWORK_PUBLISH_BROWSER_ROOT 仅供隔离测试或管理员设定专用数据目录,不能指向日常浏览器 profile。
Pliki w paczce (5)
- SKILL.md 4 KB
- scripts/browser-session.mjs 15 KB
- scripts/browser.mjs 15 KB
- tests/browser-use.test.mjs 2 KB
- tests/persistent-browser.test.mjs 4 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · mdiri-ai/SoduWork | 100 | MIT |
| jxxghp/moviepilot | 100 | GPL-3.0 |
| letta-ai/letta-code | 100 | Apache-2.0 |
| xuzhougeng/wisp-science | 100 | AGPL-3.0 |
| raccoon-office/box-agent | 100 | MIT |
| cacity/videohub | 100 | MIT |
| 3x-haust/ondra | 100 | MIT |
| TerminalSkills/skills | 100 | Apache-2.0 |
| akillness/jeo-skills | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki fe16310dcccd (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100agent-browser
Steruje prawdziwą przeglądarką z poziomu CLI, gdy trzeba przetestować coś w rzeczywistym środowisku przeglądarki. - 86browser-automation
Pomaga pisać kod sterujący prawdziwą przeglądarką przez Playwright lub CDP. - 100browser
Steruje prawdziwą przeglądarką użytkownika z wiersza poleceń: otwiera strony, w których jest zalogowany, klika, wpisuje, robi zrzuty i pokazuje wyniki. - 95playwright-test
Tworzy testy E2E w Playwright dla stron Next.js, obejmujące pełne ścieżki użytkownika od początku do końca. - 100browser
Steruje prawdziwą przeglądarką z powłoki: otwiera strony, czyta, klika, wypełnia formularze, loguje się i pobiera pliki, także we własnym Chrome użytkownika. - 100playwright-generate-test
Generuje testy Playwright w TypeScript na podstawie scenariusza lub historyjki użytkownika, korzystając z Playwright MCP do interakcji z prawdziwą przeglądarką.