Show HN：Vibium ― AIと人間向けのブラウザ自動化（Selenium創設者による）

Vibium
ドラマなしのブラウザ自動化。

概要

Vibium は AI エージェント向けに設計されたブラウザ自動化インフラストラクチャです。
単一バイナリで以下を処理します：

• ブラウザライフサイクル
• WebDriver BiDi プロトコル
• MCP サーバ（Claude Code など任意の MCP クライアント用）

これにより、エージェントはセットアップ不要でブラウザを操作でき、AI エージェント・テスト自動化・その他ブラウザ依存タスクに最適です。

クイックリファレンス

アーキテクチャ図

┌───────────────────────────────────────┐
│                 LLM/Agent             │
│ (Claude Code, Codex, Gemini, など)    │
└───────────────────────────────────────┘
            ▲ MCP プロトコル (stdio)
            │
            ▼
 ┌─────────────────────┐
 │   Vibium Clicker    │
 │                     │
 │  ┌───────────────┐  │
 │  │  MCP Server   │  │
 │  └───────▲───────┘  │         ┌──────────────────┐
 │          │          │         │                  │
 │  ┌───────▼───────┐  │WebSocket│  Chrome Browser   │
 │  │  BiDi Proxy   │  │◄───────►│     (BiDi)       │
 │  └───────────────┘  │  :9515  │                  │
 └─────────────────────┘         └──────────────────┘
            ▲ WebSocket BiDi :9515
            ▼
┌───────────────────────────────────────┐
│                JS/TS Client           │
│          npm install vibium           │
│                                       │
│  ┌─────────────────┐   ┌─────────────────┐
│  │ Async API       │   │    Sync API     │
│  │ await vibe.go() │   │    vibe.go()    │
│  └─────────────────┘   └─────────────────┘
└───────────────────────────────────────┘

コンポーネント

Clicker

約10 MB の単一 Go バイナリで、以下をすべて実行します：

• ブラウザ管理 – BiDi が有効な Chrome を検出／起動。
• BiDi プロキシ – コマンドをブラウザへルーティングする WebSocket サーバ。
• MCP Server – LLM エージェント用 stdio インターフェース。
• Auto‑Wait – 要素が利用可能になるまでポーリング。
• スクリーンショット – ビューポートを PNG で取得。

設計目標: バイナリは見えないようにし、JS 開発者は

npm install vibium

JS/TS Client

// オプション1: CommonJS（REPL に最適）
const { browserSync } = require('vibium');

// オプション2: 動的インポート（Node REPL with --experimental-repl-await）
const { browser } = await import('vibium');

// オプション3: 静的インポート (.mjs または .ts ファイル)
import { browser, browserSync } from 'vibium';

Sync API

const fs   = require('fs');
const { browserSync } = require('vibium');

const vibe = browserSync.launch();
vibe.go('https://example.com');

const png = vibe.screenshot();
fs.writeFileSync('screenshot.png', png);

const link = vibe.find('a');
link.click();
vibe.quit();

Async API

const fs   = await import('fs/promises');
const { browser } = await import('vibium');

const vibe = await browser.launch();
await vibe.go('https://example.com');

const png = await vibe.screenshot();
await fs.writeFile('screenshot.png', png);

const link = await vibe.find('a');
await link.click();
await vibe.quit();

エージェントとの連携

Claude Code にブラウザ制御を追加するにはワンコマンド：

claude mcp add vibium -- npx -y vibium

手動ステップは不要で、セットアップ時に Chrome が自動ダウンロードされます。

ツールコマンド

browser_launch

browser_navigate

browser_find

browser_click

browser_type

browser_screenshot

--screenshot-dir

browser_quit

人間向け

• あなたのプラットフォーム用に Clicker バイナリをインストール。

• Chrome + chromedriver をキャッシュへダウンロード：

  • Linux:

    ~/.cache/vibium/

  • macOS:

    ~/Library/Caches/vibium/

  • Windows:

    %LOCALAPPDATA%\vibium\

手動でブラウザを設定する必要はありません。

別途ブラウザ管理を行う場合はダウンロードをスキップ：

VIBIUM_SKIP_BROWSER_DOWNLOAD=1 npm install vibium

プラットフォーム対応

クイックスタート

ライブラリとして使用

import { browser } from 'vibium';

const vibe = await browser.launch();
await vibe.go('https://example.com');
const el   = await vibe.find('a');
await el.click();
await vibe.quit();

Claude Code で利用

claude mcp add

「example.com に行って最初のリンクをクリック」

と指示するだけです。

コントリビューション

セットアップとガイドラインは CONTRIBUTING.md をご覧ください。

ロードマップ

• V1 – Core loop: MCP と JS クライアントによるブラウザ制御。
• V2 – 予定機能：
  • Python & Java クライアント
  • Cortex（メモリ／ナビゲーション層）
  • Retina（録画拡張）
  • ビデオ録画
  • AI 搭載ロケータ

更新履歴

ライセンス

Apache 2.0