Vibium

浏览器自动化在 AI 代理、测试脚本和日常开发中越来越常见，但搭建环境往往繁琐：要处理浏览器版本、WebDriver 兼容性、协议细节，还要为 LLM 集成额外接口。Vibium 的目标很明确：把这一切藏在一个二进制文件里，让开发者和 AI 代理都能零配置上手。

一个二进制，解决所有问题

Vibium 的核心是一个用 Go 编写的轻量级组件，名为 Clicker（约 10MB）。它集成了以下功能：

• 浏览器生命周期管理：自动检测或启动一个启用了 BiDi（双向通信协议）的 Chrome 浏览器；
• BiDi 代理：将命令通过 WebSocket 转发给浏览器，无需手动连接 DevTools 协议；
• MCP 服务器：暴露标准输入/输出（stdio）接口，供 LLM 代理（如 Claude Code）直接调用；
• 自动等待机制：在点击或输入前，自动轮询等待目标元素出现在页面上；
• 截图支持：可捕获当前视口并返回 PNG 数据。

对 JavaScript/TypeScript 开发者来说，这一切是透明的。只需 npm install vibium，Clicker 二进制、兼容的 Chrome 和驱动程序都会自动安装到平台缓存目录：

• Linux: ~/.cache/vibium/
• macOS: ~/Library/Caches/vibium/
• Windows: %LOCALAPPDATA%\vibium\

如果已有管理好的浏览器环境，也可通过环境变量跳过下载：

VIBIUM_SKIP_BROWSER_DOWNLOAD=1 npm install vibium

开发者友好：同步与异步 API 都支持

Vibium 提供两套 JavaScript API，适配不同使用场景：

同步 API（适合脚本或 REPL）

const { browserSync } = require('vibium')
const vibe = browserSync.launch()
vibe.go('https://example.com')
const png = vibe.screenshot()
require('fs').writeFileSync('screenshot.png', png)
const link = vibe.find('a')
link.click()
vibe.quit()

异步 API（适合现代模块化项目）

const { browser } = await import('vibium')
const vibe = await browser.launch()
await vibe.go('https://example.com')
const png = await vibe.screenshot()
await (await import('fs/promises')).writeFile('screenshot.png', png)
const link = await vibe.find('a')
await link.click()
await vibe.quit()

两种方式都支持通过 CSS 选择器查找元素、点击、输入文本、导航和截图，API 设计简洁一致。

专为 AI 代理优化

Vibium 原生支持 MCP（Model Context Protocol），这意味着它可以被 Claude Code 等 LLM 代理直接调用。只需一条命令即可集成：

claude mcp add vibium -- npx -y vibium

安装后，用户只需自然语言指令，例如：

“访问 example.com 并点击第一个链接”

背后会自动调用以下工具：

整个过程无需手动配置 WebDriver、无需写胶水代码，Chrome 也会在首次使用时自动下载。

跨平台支持

Vibium 目前支持主流桌面平台：