MCPcopy Index your code
hub / github.com/browserwing/browserwing

github.com/browserwing/browserwing @v1.1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.1.0 ↗ · + Follow
1,701 symbols 4,510 edges 129 files 963 documented · 57%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

BrowserWing

English · 简体中文 · 日本語 · Español · Português

browserwing.com

特長

  • ブラウザ管理:起動・制御・セッション永続化(Cookie など)
  • スクリプト録画:クリック、入力、ナビゲーションを記録し、可視的に編集
  • MCP 連携:スクリプトを Model Context Protocol コマンドに変換
  • LLM 対応:OpenAI、Claude、DeepSeek などによる抽出・自動化

必要要件

  • Google Chrome または Chromium がインストールされ、実行可能であること。

クイックスタート

方法 A — リリース版をダウンロード(推奨)

  • Releases から OS 向けのバイナリをダウンロードします。
  • 実行後に http://localhost:8080 を開きます。
# Linux/macOS
chmod +x ./browserwing
./browserwing --port 8080

# Windows (PowerShell)
./browserwing.exe --port 8080

⚠️ macOS ユーザーへ:
実行時に "killed" エラーが発生した場合は、以下のコマンドで修正してください:

xattr -d com.apple.quarantine $(which browserwing)

詳細は macOS インストール修正ガイド をご覧ください。

方法 B — ソースからビルド

# 依存をインストール(Go と pnpm が必要)
make install

# 統合バイナリ(フロントエンドを埋め込み)
make build-embedded
./build/browserwing --port 8080

# すべてのターゲットをビルドしてパッケージ化
make build-all
make package

なぜ BrowserWing なのか

  • 活発なエコシステムと豊富なスクリプトで作業を迅速化
  • トークン効率が良く、高速に動作
  • 再生可能なスクリプトで複雑な Web 作業を自動化
  • MCP により録画アクションを LLM ワークフローへ橋渡し
  • セッションや設定を維持して安定した動作を実現
  • データ抽出、RPA、テスト、エージェントブラウジングに最適

アーキテクチャ

flowchart LR
  User((あなた))
  Frontend[React + Vite]
  Backend[Go API]
  Browser[Recorder / Player / Manager]
  MCP[MCP Server]
  LLMs[OpenAI, Claude, DeepSeek など]

  User --> Frontend
  Frontend --> Backend
  Backend --> Browser
  Backend --> MCP
  MCP --> LLMs

使い方

  1. ブラウザ管理:インスタンス起動、プロファイル設定、Cookie 処理
  2. スクリプト録画:手順を記録して再生・編集
  3. MCP へ変換:スクリプトを MCP ツール/コマンドとして公開
  4. LLM から呼び出し:MCP 経由でブラウザ自動化を編成

コントリビューション

  • Issue と PR を歓迎します。再現手順や動機を明確に記載してください。
  • 機能提案はディスカッションで、ユースケースと期待結果を共有してください。

コミュニティ

Discord: https://discord.gg/BkqcApRj twitter: https://x.com/chg80333

謝辞

  • ブラウザ自動化、エージェントワークフロー、MCP にインスパイアされています。

ライセンス

  • MIT ライセンス。LICENSE を参照してください。

免責事項

  • 違法目的やサイト規約違反に使用しないでください。
  • 個人の学習および適法な自動化用途に限ります。

Extension points exported contracts — how you extend this code

ToolWithSchema (Interface)
ToolWithSchema 定义带有 InputSchema 方法的工具接口 [7 implementers]
backend/agent/tools/init.go
ScriptPlayer (Interface)
ScriptPlayer 脚本播放器接口 [5 implementers]
backend/scheduler/executor.go
DBInterface (Interface)
Recorder 浏览器操作录制器 DBInterface 定义需要的数据库接口 [2 implementers]
backend/services/browser/recorder.go
IMCPServer (Interface)
IMCPServer MCP 服务器接口 [1 implementers]
backend/mcp/interface.go
MCPHTTPHandler (Interface)
使用类型断言访问 MCP 服务器的 ServeHTTP 方法 [1 implementers]
backend/api/handlers.go
ScriptStore (Interface)
(no doc) [3 implementers]
backend/builtin/scripts.go
Logger (Interface)
(no doc) [2 implementers]
backend/pkg/logger/logger.go
Scheduler (Interface)
(no doc) [1 implementers]
backend/main.go

Core symbols most depended-on inside this repo

Info
called by 576
backend/pkg/logger/logger.go
Error
called by 256
backend/pkg/logger/logger.go
Warn
called by 254
backend/pkg/logger/logger.go
showMessage
called by 117
frontend/src/pages/PromptManage.tsx
Description
called by 43
backend/agent/agent.go
Update
called by 41
backend/sdk/script.go
GetActivePage
called by 40
backend/services/browser/player.go
handleAddAction
called by 39
frontend/src/pages/ScriptManager.tsx

Shape

Method 747
Function 712
Struct 145
Interface 89
TypeAlias 8

Languages

Go73%
TypeScript27%

Modules by API surface

backend/api/handlers.go165 symbols
backend/storage/bolt.go87 symbols
frontend/src/pages/ScriptManager.tsx67 symbols
backend/services/browser/scripts/recorder.js66 symbols
frontend/src/api/client.ts65 symbols
backend/services/browser/player.go61 symbols
backend/services/browser/manager.go54 symbols
backend/executor/operations.go54 symbols
backend/agent/agent.go53 symbols
backend/builtin/scripts.go42 symbols
backend/executor/executor.go39 symbols
backend/scheduler/executor.go35 symbols

For agents

$ claude mcp add browserwing \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact