Lightpanda
Lightpanda は、マシン向けにゼロから構築されたヘッドレスブラウザエンジンです。即時起動でき、Chromeと比べてメモリ使用量が1/10、実行速度が10倍速いです。
agent-browser は、Chrome を管理するのと同じ方法で Lightpanda を管理しています — プロセスを起動し、CDP で接続し、終了させる仕組みです。サムネイル作成、クリック、入力、スクリーンショットなどの下流コマンドはすべて、同じ CDP プロトコル経路を通じて動作します。
インストール
agent-browser で使用する前に、Lightpanda のバイナリをインストールしてください：
| プラットフォーム | コマンド |
|---|---|
| macOS (Apple Silicon) | curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-aarch64-macos && chmod a+x ./lightpanda |
| Linux (x86_64) | curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux && chmod a+x ./lightpanda |
バイナリを PATH にある場所に移動してください（例：/usr/local/bin/lightpanda または ~/.local/bin/lightpanda）。
詳細なオプションについては Lightpanda のインストールドキュメント をご参照ください。
使用方法
--engine フラグを使って Lightpanda を選択します：
agent-browser --engine lightpanda open example.com
agent-browser --engine lightpanda snapshot
agent-browser --engine lightpanda screenshotまたは環境変数でデフォルトとして設定します：
export AGENT_BROWSER_ENGINE=lightpanda
agent-browser open example.comあるいは agent-browser.json 設定ファイルで：
{
"engine": "lightpanda"
}カスタムバイナリパス
lightpanda バイナリが PATH にない場合、--executable-path を使用してください：
agent-browser --engine lightpanda --executable-path /path/to/lightpanda open example.comChrome との違い
Lightpanda は目的に特化したヘッドレスエンジンです。一部の Chrome 固有の機能は利用できません：
| 機能 | 状態 |
|---|---|
拡張機能 (--extension) | 非対応 |
永続プロファイル (--profile) | 非対応 |
ストレージ状態 (--state) | 非対応 |
ファイルアクセス (--allow-file-access) | 非対応 |
ヘッド付きモード (--headed) | 該当せず（ヘッドレスのみ） |
| スクリーンショット | Lightpanda の CDP 対応状況に依存 |
agent-browser は、--engine lightpanda と非対応フラグを併用しようとした場合、明確なエラーを返します。
Lightpanda を使うべき場面
Lightpanda は以下の用途に適しています：
- 速いウェブスクレイピングおよびデータ抽出
- 速度と低メモリ消費が重要な AI エージェントワークフロー
- リソース制限のある CI/CD 環境
- 高容量の並列自動化
完全なブラウザ互換性、拡張機能、または永続プロファイルが必要な場合は、Chrome を使用してください。