> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/browser-act/skills) · [上游 README](https://github.com/browser-act/skills/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
---
面向 AI 智能体（agent）构建的浏览器自动化 CLI。突破反机器人（anti-bot）拦截，卡住时可跨平台交接给人类操作，并行执行任务且互不污染，并在独立浏览器中隔离多个账号。
## 为何选择 BrowserAct
AI 智能体所需的浏览器必须能到达标准工具无法触及的页面，在智能体卡住时让人类无缝接管，避免并行任务相互污染，并且为 LLM 推理而设计——而非为人类编写的脚本。**面向智能体的浏览器必须在四件事上做到位。**
**1. 突破拦截——三层递进方案**
1. **环境层** — 隐身指纹伪装、TLS 轮换、代理切换。绝大多数拦截根本不会触发。
2. **执行层** — `solve-captcha` 自动解决 CAPTCHA；`stealth-extract` 一条命令拉取受保护页面。
3. **人工层** — `remote-assist` 生成实时 URL；用户可在任意设备接管，完成后智能体无缝继续。
**2. 三种浏览器模式——按真实场景划分**
| Mode | Scenario | Key trait |
|------|----------|-----------|
| `chrome` | 复用本地 Chrome 登录状态 | Profile 导入或 CDP attach |
| `stealth` privacy mode | 无需登录的流畅批量抓取 | 每会话全新指纹 + 代理轮换，零残留 |
| `stealth` fixed identity | 已登录账号 · 多浏览器并行 | 稳定指纹 + 稳定 IP，账号身份稳定，不会被标记为机器人 |
**3. 零干扰并发——每个智能体各走各的道**
- 跨浏览器并行 — 独立 cookie、指纹、代理。网站无法关联它们。
- 同浏览器多会话 — 共享登录状态，独立执行，任务互不阻塞。
- Privacy mode — 每会话全新指纹与空白 Profile，结束后零残留。
**4. 为智能体推理而设计——而非人类脚本**
- **紧凑文本输出** — 索引化文本格式，比 JSON 或 HTML 节省数倍 token。
- **索引化交互** — `state` 返回索引列表；`click 3` / `input 2 "..."`。无需解析 DOM。
- **语义记忆（semantic memory）** — 每个浏览器携带 `desc`，按语义与任务匹配。
- **并发安全** — 会话所有权 + 显式命名。多智能体运行永不冲突。
**安全：确认门控（confirmation gating）** — 敏感操作（创建/删除浏览器、Profile 导入、代理变更、安全与隐私开关）需要用户明确批准。先前批准不会延续。在 Skill 层强制执行，而非配置开关。
---
## 更多能力
- **更好的无头模式（headless）** — 默认无头且不打扰用户；隐身无头模式不会被检测。
- **跨平台远程交接** — 任意设备打开链接即可接管，智能体无缝继续。
---
## 安装
告诉你的 AI 智能体：
> Install browser-act. Skill source: https://github.com/browser-act/skills/tree/main/browser-act . Verify it works after installation.
[安装详情 →](docs/installation.md)
---
## 快速开始
```bash
# Extract protected page content (zero config)
browser-act stealth-extract https://example.com
# Full browser automation
browser-act --session my-task browser open https://example.com
browser-act --session my-task state # See clickable elements
browser-act --session my-task click 3 # Click by index
browser-act --session my-task input 2 "hi" # Type into a field
```
[更多示例与工作流 →](docs/quick-start.md)
智能体在每个会话开始时运行 `get-skills` — 一次调用即可获取环境状态、浏览器列表和命令：
```bash
browser-act get-skills core --skill-version 2.0.2
```
[智能体如何发现并使用 BrowserAct →](docs/skills.md)
---
## 兼容性
**OS：** Windows、macOS、Linux
**Agents：** Claude Code · Cursor · VS Code · OpenCode · OpenClaw · Codex · Gemini CLI — 适用于任何能执行 shell 命令并加载 Skills 的智能体。
---
## 免费范围
几乎一切都免费。仅两项功能需要付费：托管代理（Dynamic / Static），以及超出前 5 个的隐身浏览器。
| Feature | Free
(No Signup) | Free
(Login Only) | Paid |
|---------|:----------------:|:-----------------:|:----:|
| Browser automation, Chrome / Chrome-direct | ✓ | ✓ | ✓ |
| Stealth browser (≤ 5), stealth-extract, solve-captcha, remote-assist, privacy mode, Skill Forge | — | ✓ | ✓ |
| Stealth browser (> 5), Dynamic / Static proxy | — | — | ✓ |
---
## 文档
完整文档涵盖反拦截、浏览器模式、会话与并发、无头模式与远程交接、智能体设计、Skills 系统，以及完整命令参考。
[阅读完整文档 →](docs/README.md)
---
## BrowserAct 更多产品
### Skill Forge — 你的专属抓取工程师
需要大规模、反复从同一网站提取数据？不必手写爬虫。**Skill Forge** 探索站点一次，发现其 API 与数据模式，生成可部署的 Skill 包，之后无需重新探索即可稳定运行——无论 500 条还是 5,000 条记录，都走同一条稳定路径。
**任意网站。任意数据。一条命令即可开始：**
> Install browser-act-skill-forge. Skill source: https://github.com/browser-act/skills/tree/main/browser-act-skill-forge . Verify it works after installation.
然后告诉你的智能体你需要什么：
> *"Forge a Skill that extracts job listings from LinkedIn — title, company, salary, URL. I'll run 300 keywords later."*
[Skill Forge 文档 →](docs/skill-forge.md)
### Solutions Catalog
30+ 个由 Skill Forge 预先生成、可直接安装运行的 Skills。覆盖 Amazon、Google Maps、YouTube、Reddit、WeChat、Zhihu 等。
[浏览完整 Solutions Catalog →](solutions/README.md)
### 自行构建
上面找不到你需要的？几分钟内为**任意网站**生成自定义 Skill——无需编码。只需描述你想要的数据或要执行的操作，Skill Forge 会处理其余一切。
---
## 💖 支持本项目
BrowserAct Skills 是**免费开源**的。如果它为你节省了时间，请给我们一个 ⭐ **Star** — 这能让项目持续运转，并帮助我们发布更多 skills。
🎁 **福利：** 为仓库点 Star 后，可加入我们的 [Discord](https://discord.com/invite/UpnCKd7GaU) and post in the `#claim-500-credits` channel to receive **500 free credits**!
### 🤝 社区与支持
- 💬 [Join our Discord](https://discord.com/invite/UpnCKd7GaU)
- 📖 [Read the Docs](https://docs.browseract.com)
- 🐛 [Report an Issue](https://github.com/browser-act/skills/issues)
- 🌐 [BrowserAct Website](https://www.browseract.com/?co-from=github)
由 BrowserAct 团队用 ❤️ 构建
## Star 历史
