企业官网建设流程全解析

如何安装BrowserAct：一句话让Agent自动配置+手动安装完整指南（Win/macOS/Linux全平台支持）

【免费下载链接】skillsBrowser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session operation, isolated multi-account browsing.项目地址: https://gitcode.com/gh_mirrors/skills31/skills

BrowserAct 安装其实非常简单：它是一款为 AI Agent 打造的浏览器自动化 CLI 工具，能帮你突破反爬拦截、多任务并行执行、多账号隔离浏览。无论你是 Windows、macOS 还是 Linux 用户，都可以用两种方式完成BrowserAct 安装——直接告诉 AI Agent 一句话让它自动配置，或者手动执行一条命令。下面这篇BrowserAct 安装指南带你 5 分钟跑通全流程。

一、安装前了解：BrowserAct 是什么？

BrowserAct 是一个面向 AI Agent 的浏览器自动化命令行工具（CLI），核心能力包括：

• 🕵️突破反爬拦截——隐身指纹伪装、TLS 轮换、代理切换，三层防护体系
• 🤝卡住时交给人类——remote-assist生成实时链接，任何设备接管，完成后 Agent 无缝继续
• 🚀并行多任务——每个浏览器独立 Cookie、指纹、代理，互不干扰
• 🔑多账号隔离——登录状态复用、固定身份并行，不被标记为机器人

官方兼容性说明见 docs/installation.md：

二、最快安装方法：一句话让 Agent 自动配置（推荐）

如果你正在使用 Claude Code、Cursor、Codex、Gemini CLI 等支持 Skills 的 AI Agent，这是最省心的BrowserAct 安装方式。

直接把下面这句话发给你的 Agent：

安装 browser-act。Skill 源码位于本仓库的browser-act目录，安装完成后请验证是否可用。

Agent 会自动完成三件事：

1. 安装browser-act-cli（基于uv工具链）
2. 配置并加载 BrowserAct Skill（browser-act/SKILL.md）
3. 运行验证，确认一切正常

三、BrowserAct 手动安装完整步骤

不想依赖 Agent？手动安装同样只有两步。

1. 一键安装 CLI

前提：电脑已安装 Python 3.12+ 和uv包管理器。

uv tool install browser-act-cli --python 3.12

2. 验证安装是否成功

browser-act --version

能正常输出版本号，说明BrowserAct 安装已完成。

3. 可选：配置 API Key 解锁进阶功能

Chrome 和 chrome-direct 浏览器无需登录即可使用。如果你还想用这些功能，需要配置 API Key：

• 🛡️stealth 隐身浏览器——指纹伪装的无痕浏览
• ⚡stealth-extract——一条命令提取受保护页面内容
• 🌐动态代理——按地区分配的托管 IP 轮换
• 🧩solve-captcha——自动处理验证码

browser-act auth login # 打开注册链接 → 完成注册 → 轮询获取 Key browser-act auth poll

或者已有 Key 直接设置：

browser-act auth set <your-api-key>

详细说明见 docs/installation.md。

四、安装常见问题排查

❓ 安装后提示"找不到命令"

把uv tool的目录加入 PATH：

uv tool dir # 查看输出路径，将其加入 shell 的 PATH

❓ 想升级到最新版

uv tool upgrade browser-act-cli

Skill 层会自动检测 CLI 与 Skill 内容的版本差异并引导升级，无需手动操心。

❓ 遇到疑难问题

browser-act report-log # 上传日志辅助诊断 browser-act feedback "问题描述" # 提交改进建议

五、装好后怎么跑第一个任务？

BrowserAct 安装完成后，60 秒就能出结果。最简单的体验方式是提取受保护页面（零配置）：

browser-act stealth-extract https://example.com

更完整的浏览器自动化流程（打开 → 查看状态 → 交互 → 关闭）：

browser-act --session my-task browser open <id> https://example.com browser-act --session my-task state # 查看可交互元素 browser-act --session my-task click 3 # 按索引点击

更多上手示例请看 docs/quick-start.md 和 docs/README.md。

六、BrowserAct 免费版包含哪些功能？

绝大部分功能免费：

写在最后

BrowserAct 安装到这一步就全部完成了：一句话让 Agent 自动配置，或手动执行uv tool install两步搞定，Windows / macOS / Linux 全平台支持。装好后你可以继续探索官方文档 docs/、内置方案目录 solutions/README.md，甚至用 Skill Forge 为自己生成专属的抓取 Skill（见 docs/skill-forge.md）。现在就可以去让 Agent 帮你打开第一个网页了 🚀

【免费下载链接】skillsBrowser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session operation, isolated multi-account browsing.项目地址: https://gitcode.com/gh_mirrors/skills31/skills