Skip to content
Back to search

browserwing

BrowserWing turns your browser actions into MCP commands Or Claude Skill, allowing AI agents to control browsers efficiently and reliably. Say goodbye to slow, token-heavy LLM interactions — let agents call commands directly for faster automation. Perfect for AI-driven tasks, browser automation, and boosting productivity.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/browserwing--browserwing/badge.svg)](/listings/browserwing--browserwing)

HTML

<a href="/listings/browserwing--browserwing"><img src="/api/listings/browserwing--browserwing/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Let Your AI Agent Install It For You

Simply send the following message to your AI agent (OpenClaw, Cursor, Claude Code, etc.):

> **"Help me install BrowserWing following https://raw.githubusercontent.com/browserwing/browserwing/main/INSTALL.md"**

The agent will read the guide and handle the installation, configuration, Chrome setup, and Skill integration automatically.

---

Option A — Install via Package Manager (recommended)

**Using npm:**

npm install -g browserwing
browserwing --port 8080

**Using pnpm:**

pnpm add -g browserwing
browserwing --port 8080

The npm package automatically tests GitHub and Gitee mirrors during installation and selects the fastest one.

**⚠️ macOS Users:** If you encounter a "killed" error when running, fix it with:

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

See the [macOS Installation Fix Guide](docs/MACOS_INSTALLATION_FIX.md) for details.

**Using Homebrew (macOS/Linux):**

# Coming soon
brew install browserwing

Option B — One-Line Install Script

**Linux / macOS:**

curl -fsSL https://raw.githubusercontent.com/browserwing/browserwing/main/install.sh | bash

**Windows (PowerShell):**

iwr -useb https://raw.githubusercontent.com/browserwing/browserwing/main/install.ps1 | iex

The script automatically: - Detects your OS/architecture - Tests GitHub and Gitee mirrors, selects the fastest one - Downloads and extracts the binary - Adds to PATH

**Then start BrowserWing:**

browserwing --port 8080
# Open http://localhost:8080 in your browser

**Note for users in China:** The installation script automatically uses Gitee mirror if GitHub is slow.

Option C — Manual Download

Download the prebuilt binary for your OS from [Releases](https://github.com/browserwing/browserwing/releases):

# Linux/macOS
chmod +x ./browserwing
./browserwing --port 8080

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

Option D — Build from Source

# Install deps (Go + pnpm required)
make install

# Build integrated binary (frontend embedded)
make build-embedded
./build/browserwing --port 8080

# Or build all targets and packages
make build-all
make package

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 425 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img width="600" alt="BrowserWing" src="https://raw.githubusercontent.com/browserwing/browserwing/main/docs/assets/banner.svg">
  3. </p>
  4. <p align="center">
  5. <img alt="Go" src="https://img.shields.io/badge/Go-1.21%2B-00ADD8?logo=go&logoColor=white" />
  6. <img alt="React" src="https://img.shields.io/badge/React-18-61DAFB?logo=react&logoColor=white" />
  7. <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=white" />
  8. <img alt="Vite" src="https://img.shields.io/badge/Vite-5-646CFF?logo=vite&logoColor=white" />
  9. <img alt="pnpm" src="https://img.shields.io/badge/pnpm-9-F69220?logo=pnpm&logoColor=white" />
  10. <img alt="MCP" src="https://img.shields.io/badge/MCP-Model%20Context%20Protocol-7B61FF" />
  11. <img alt="npm" src="https://img.shields.io/npm/v/browserwing?color=CB3837&logo=npm" />
  12. <img alt="License" src="https://img.shields.io/github/license/browserwing/browserwing" />
  13. <img alt="Scripts" src="https://img.shields.io/badge/Built--in%20Scripts-78-brightgreen" />
  14. </p>
  15. <p align="center">
  16. English · <a href="./README.zh-CN.md">简体中文</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.es.md">Español</a> · <a href="./README.pt.md">Português</a>
  17. </p>
  18. <p align="center"><a href="https://browserwing.com">browserwing.com</a></p>
  19. > **Turn any website into structured data with one command.** Browser automation platform with 78 built-in scripts, CLI for AI agents, MCP & Skills protocol support, and a visual recorder.
  20. https://github.com/user-attachments/assets/e5377892-4b88-433a-8620-43b38a2fb28f
  21. ```bash
  22. # Install and try it in 30 seconds
  23. npm install -g browserwing && browserwing --port 8080
  24. # Get data from any supported site
  25. browserwing run github-trending
  26. browserwing run bilibili-hot
  27. browserwing run hackernews-top | jq '.[0:5]'
  28. ```
  29. ## ❤️ Sponsor
  30. > Want to appear here? Contact: chg80333@gmail.com | WeChat: mongorz
  31. <details open>
  32. <summary>Sponsors</summary>
  33. [![Swiftproxy](assets/sponsors/swiftproxy-en.png)](https://www.swiftproxy.net/?ref=browserwing)
  34. [Swiftproxy](https://www.swiftproxy.net/?ref=browserwing) provides 90M+ clean residential and static residential proxies for AI agents, browser automation, web scraping, and multi-account workflows. With global IP coverage and stable sessions, Swiftproxy helps developers build reliable automation environments and reduce IP-related restrictions. Dynamic proxy traffic never expires until used, with free testing available. BrowserWing users can get **10% off with code `PROXY90`**.
  35. ---
  36. </details>
  37. ## Highlights
  38. **Native Browser Automation Platform with AI Integration**
  39. - **Complete Browser Control**: 26+ HTTP API endpoints for full-featured browser automation
  40. - **Built-in AI Agent**: Direct conversational interface for browser automation tasks
  41. - **Universal AI Tool Integration**: Native MCP & Skills protocol support - compatible with any AI tool that supports these standards
  42. - **Visual Script Recording**: Record browser actions, edit visually, and replay with precision
  43. - **Flexible Export Options**: Convert recorded scripts to MCP commands or Skills files for AI tool integration
  44. - **Intelligent Data Extraction**: LLM-powered semantic extraction supporting OpenAI, Claude, DeepSeek, and more
  45. - **Session Management**: Robust cookie and storage handling for stable, authenticated browsing sessions
  46. ## Requirements
  47. - Google Chrome or Chromium installed and accessible in your environment.
  48. ## Screenshots
  49. <img width="600" alt="BrowserWing Homepage" src="https://raw.githubusercontent.com/browserwing/browserwing/main/docs/assets/screenshot_homepage.png">
  50. ### Turn Scripts Into Claude Skill
  51. You can now combine any scripts into a SKILL.md.
  52. <img width="600" alt="BrowserWing Skill" src="https://raw.githubusercontent.com/browserwing/browserwing/main/docs/assets/screenshot_skill.png">
  53. ## Quick Start
  54. ### Let Your AI Agent Install It For You
  55. Simply send the following message to your AI agent (OpenClaw, Cursor, Claude Code, etc.):
  56. > **"Help me install BrowserWing following https://raw.githubusercontent.com/browserwing/browserwing/main/INSTALL.md"**
  57. The agent will read the guide and handle the installation, configuration, Chrome setup, and Skill integration automatically.
  58. ---
  59. ### Option A — Install via Package Manager (recommended)
  60. **Using npm:**
  61. ```bash
  62. npm install -g browserwing
  63. browserwing --port 8080
  64. ```
  65. **Using pnpm:**
  66. ```bash
  67. pnpm add -g browserwing
  68. browserwing --port 8080
  69. ```
  70. The npm package automatically tests GitHub and Gitee mirrors during installation and selects the fastest one.
  71. **⚠️ macOS Users:**
  72. If you encounter a "killed" error when running, fix it with:
  73. ```bash
  74. xattr -d com.apple.quarantine $(which browserwing)
  75. ```
  76. See the [macOS Installation Fix Guide](docs/MACOS_INSTALLATION_FIX.md) for details.
  77. **Using Homebrew (macOS/Linux):**
  78. ```bash
  79. # Coming soon
  80. brew install browserwing
  81. ```
  82. ### Option B — One-Line Install Script
  83. **Linux / macOS:**
  84. ```bash
  85. curl -fsSL https://raw.githubusercontent.com/browserwing/browserwing/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 123 on GitHub
  86. ```
  87. **Windows (PowerShell):**
  88. ```powershell
  89. iwr -useb https://raw.githubusercontent.com/browserwing/browserwing/main/install.ps1 | iex
  90. ```
  91. The script automatically:
  92. - Detects your OS/architecture
  93. - Tests GitHub and Gitee mirrors, selects the fastest one
  94. - Downloads and extracts the binary
  95. - Adds to PATH
  96. **Then start BrowserWing:**
  97. ```bash
  98. browserwing --port 8080
  99. # Open http://localhost:8080 in your browser
  100. ```
  101. **Note for users in China:** The installation script automatically uses Gitee mirror if GitHub is slow.
  102. ### Option C — Manual Download
  103. Download the prebuilt binary for your OS from [Releases](https://github.com/browserwing/browserwing/releases):
  104. ```bash
  105. # Linux/macOS
  106. chmod +x ./browserwing
  107. ./browserwing --port 8080
  108. # Windows (PowerShell)
  109. ./browserwing.exe --port 8080
  110. ```
  111. ### Option D — Build from Source
  112. ```bash
  113. # Install deps (Go + pnpm required)
  114. make install
  115. # Build integrated binary (frontend embedded)
  116. make build-embedded
  117. ./build/browserwing --port 8080
  118. # Or build all targets and packages
  119. make build-all
  120. make package
  121. ```
  122. ## Quick Integration with AI Tools
  123. **Three Ways to Use BrowserWing:**
  124. ### 1. MCP Server Integration
  125. Configure BrowserWing as an MCP server in any MCP-compatible AI tool:
  126. ```json
  127. {
  128. "mcpServers": {
  129. "browserwing": {
  130. "type": "http",
  131. "url": "http://localhost:8080/api/v1/mcp/message"
  132. }
  133. }
  134. }
  135. ```
  136. Paste this configuration into your AI tool's MCP settings to enable browser automation capabilities.
  137. ### 2. Skills File Integration
  138. Download and import the Skills file into any AI tool that supports the Skills protocol:
  139. 1. Start BrowserWing
  140. 2. Download [SKILL.md](https://raw.githubusercontent.com/browserwing/browserwing/refs/heads/main/SKILL.md) from the repository
  141. 3. Import into your AI tool's Skills settings
  142. 4. Start automating with natural language commands
  143. **Example:**
  144. ```
  145. "Navigate to example.com, search for 'AI tools', and extract the top 5 results"
  146. ```
  147. ### 3. CLI Mode (Agent-Friendly)
  148. BrowserWing includes a CLI designed for AI agents and shell pipelines. Run scripts and get structured data directly from the terminal — no browser window needed (headless by default).
  149. ```bash
  150. # List all available scripts
  151. browserwing ls --format=json
  152. # Run a script and get JSON output
  153. browserwing run bilibili-hot
  154. browserwing run github-trending
  155. browserwing run hackernews-top
  156. # Pass parameters to scripts
  157. browserwing run jd-search --keyword="机械键盘"
  158. # Pipe to other tools
  159. browserwing run sinafinance-rank --format=csv > stocks.csv
  160. browserwing run hackernews-top | jq '.[0:5]'
  161. # Show browser window for debugging
  162. browserwing run zhihu-hot --no-headless
  163. ```
  164. **78 built-in scripts** across 10 categories (Bilibili, GitHub, Reddit, Hacker News, YouTube, Steam, BBC, Bloomberg, Reuters, Google Scholar, Binance, Amazon, Weibo, Zhihu, CNKI, Yahoo Finance, etc.) — ready to use out of the box.
  165. **AI Agent Workflow:**
  166. 1. `browserwing ls --format=json` — discover available scripts and their parameters
  167. 2. `browserwing run <name> --key=value` — execute and get structured JSON data
  168. 3. Parse the output for further processing
  169. ### 4. Direct AI Agent Interface
  170. Use BrowserWing's built-in AI Agent for immediate browser automation:
  171. 1. Open BrowserWing web interface at `http://localhost:8080`
  172. 2. Navigate to "AI Agent" section
  173. 3. Configure your LLM (OpenAI, Claude, DeepSeek, etc.)
  174. 4. Start conversational browser automation
  175. **Export Custom Scripts:**
  176. ```bash
  177. # Export your recorded scripts as Skills or MCP commands
  178. curl -X POST 'http://localhost:8080/api/v1/scripts/export/skill' \
  179. -H 'Content-Type: application/json' \
  180. -d '{"script_ids": []}' \
  181. -o MY_CUSTOM_SCRIPTS.md
  182. ```
  183. ## Why BrowserWing
  184. **Professional Browser Automation with AI Integration**
  185. - **Universal Protocol Support**: Native MCP & Skills implementation works with any compatible AI tool
  186. - **Complete Automation API**: 26+ HTTP endpoints providing comprehensive browser control capabilities
  187. - **Flexible Integration Options**: Use as MCP server, Skills file, or standalone AI Agent
  188. - **Visual Workflow Builder**: Record, edit, and replay browser actions without writing code
  189. - **Token-Efficient Design**: Optimized for LLM usage with fast performance and minimal token consumption
  190. - **Production-Ready**: Stable session management, cookie handling, and error recovery
  191. - **Extensible Architecture**: Convert recorded scripts to reusable MCP commands or Skills files
  192. - **Multi-LLM Support**: Works with OpenAI, Anthropic, DeepSeek, and other providers
  193. - **Enterprise Use Cases**: Data extraction, RPA, testing, monitoring, and agent-driven automation
  194. ## Usage Guide
  195. ### Getting Started in Three Steps
  196. 1. **Choose Integration Method**
  197. - Copy MCP server configuration for AI tool integration
  198. - Download Skills file for Skills-compatible AI tools
  199. - Or use built-in AI Agent for immediate access
  200. 2. **Configure Your AI Tool**
  201. - Import MCP configuration or Skills file into your preferred AI tool
  202. - Configure LLM settings (API keys, model selection)
  203. - Verify connection to BrowserWing
  204. 3. **Start Automating**
  205. - Control browser through natural language commands
  206. - Record custom scripts for repeated tasks
  207. - Export scripts as MCP commands or Skills for reuse
  208. ### Advanced Workflows
  209. **For Browser Automation:**
  210. - Launch and manage multiple browser instances
  211. - Configure profiles, proxies, and browser settings
  212. - Handle cookies and authentication sessions
  213. - Execute complex interaction sequences
  214. **For Script Recording:**
  215. - Capture clicks, inputs, navigation, and waits
  216. - Edit actions visually in the script editor
  217. - Test and debug with step-by-step replay
  218. - Add variables and conditional logic
  219. **For AI Integration:**
  220. - Convert scripts to MCP commands or Skills files
  221. - Integrate with multiple LLM providers
  222. - Use semantic extraction for data parsing
  223. - Build agent-driven automation workflows
  224. ### Using CloakBrowser for Advanced Stealth
  225. BrowserWing supports [CloakBrowser](https://github.com/CloakHQ/CloakBrowser) — a stealth Chromium binary with source-level fingerprint patches that passes all major bot detection tests.
  226. **Why CloakBrowser?**
  227. - 49-57 C++ source-level patches (canvas, WebGL, audio, fonts, GPU, WebRTC, etc.)
  228. - Passes Cloudflare Turnstile, FingerprintJS, BrowserScan, reCAPTCHA v3
  229. - Works as a drop-in replacement for standard Chromium
  230. **Setup:**
  231. 1. Install CloakBrowser:
  232. ```bash
  233. pip install cloakbrowser
  234. python -c "from cloakbrowser import ensure_binary; ensure_binary()"
  235. ```
  236. 2. Launch CloakBrowser's `cloakserve` CDP server:
  237. ```bash
  238. python /path/to/cloakbrowser/bin/cloakserve --port=9222 --headless=false
  239. ```
  240. 3. Configure BrowserWing to use CloakBrowser's CDP endpoint. Add to your `config.toml`:
  241. ```toml
  242. [browser]
  243. ControlURL = "http://localhost:9222"
  244. ```
  245. Or set the `BROWSER_CONTROL_URL` environment variable:
  246. ```bash
  247. export BROWSER_CONTROL_URL="http://localhost:9222"
  248. browserwing --port 8080
  249. ```
  250. 4. **Important:** CloakBrowser handles fingerprint spoofing at the binary level, so BrowserWing's JS-level stealth mode will conflict with CloakBrowser's C++ patches. When using CloakBrowser, set `use_stealth = false` in your browser config or the `USE_STEALTH` environment variable to disable BrowserWing's JS stealth injection.
  251. **How it works:**
  252. - `cloakserve` is a CDP multiplexer that spawns one Chrome process per fingerprint seed
  253. - Each Chrome process has compiled-in fingerprint patches (no JS injection needed)
  254. - BrowserWing connects to `cloakserve` via HTTP, resolves the WebSocket URL automatically, and controls the browser via standard CDP
  255. - Cookie persistence and session management work the same as with regular Chrome
  256. **Key benefits:**
  257. - Stronger bot detection evasion than JS-level stealth injection
  258. - Consistent fingerprints across sessions (seed-based)
  259. - Native SOCKS5 proxy and geoip-based timezone/locale detection built-in
  260. - Works with Playwright, Puppeteer, LangChain, browser-use, and BrowserWing
  261. ### HTTP API Reference
  262. BrowserWing exposes 26+ RESTful endpoints for programmatic browser control:
  263. **Navigation & Control**
  264. - Navigate to URLs, go back/forward, refresh pages
  265. - Manage browser windows and tabs
  266. - Handle page loading and timeouts
  267. **Element Interaction**
  268. - Click, type, select, and hover actions
  269. - File uploads and form submissions
  270. - Keyboard shortcuts and key presses
  271. **Data Extraction**
  272. - Extract text, HTML, and attributes
  273. - Semantic content analysis with LLM
  274. - Screenshot capture (full page or element)
  275. **Advanced Operations**
  276. - Execute custom JavaScript
  277. - Manage cookies and local storage
  278. - Batch operations for efficiency
  279. - Wait conditions and element visibility
  280. **Complete Documentation**: See `docs/EXECUTOR_HTTP_API.md` for detailed endpoint specifications
  281. ### CLI Exit Codes
  282. For AI agent integration, the CLI uses structured exit codes:
  283. | Code | Meaning |
  284. |------|---------|
  285. | 0 | Success |
  286. | 1 | General error |
  287. | 2 | Server connection error |
  288. | 3 | Script not found |
  289. | 4 | Script execution failed |
  290. | 64 | Bad arguments |
  291. Set `BROWSERWING_JSON_ERRORS=1` for machine-readable JSON error output on stderr.
  292. ## Star History
  293. [![Star History Chart](https://api.star-history.com/svg?repos=browserwing/browserwing&type=Date)](https://star-history.com/#browserwing/browserwing&Date)
  294. ## Contributing
  295. - Issues and PRs are welcome. Please include clear steps to reproduce or a concise rationale.
  296. - For feature ideas, open a discussion with use cases and expected outcomes.
  297. ## Community
  298. Discord: [https://discord.gg/BkqcApRj](https://discord.gg/BkqcApRj)
  299. twitter: [https://x.com/chg80333](https://x.com/chg80333)
  300. ## Acknowledgements
  301. - Inspired by modern browser automation, agentic workflows, and MCP.
  302. ## License
  303. - MIT License. See `LICENSE`.
  304. ## Disclaimer
  305. - Do not use for illegal purposes or to violate site terms.
  306. - Intended for personal learning and legitimate automation only.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.