Browserwing

BrowserWing

Browser automation platform with 78 built-in scripts, CLI for AI agents, and full browser control API. Turn any website into structured JSON with one command.

Install

npm install -g browserwing

Then start the server:

browserwing --port 8080

Chrome must be installed on the host machine.

Verify Installation

browserwing doctor

Quick Start — Run Built-in Scripts

BrowserWing ships with 78 ready-to-use scripts across 10 categories. No configuration needed.

# Get Hacker News top stories
browserwing run hackernews-top

# Get GitHub trending repos
browserwing run github-trending

# Get Bilibili hot videos
browserwing run bilibili-hot

# Search with parameters
browserwing run jd-search --keyword="mechanical keyboard"

# Output as table or CSV
browserwing run douban-movie-hot --format=table
browserwing run sinafinance-rank --format=csv > stocks.csv

Discover Scripts

# List all scripts
browserwing ls

# List only built-in scripts
browserwing ls --builtin

# Search by keyword
browserwing ls --search=stock

# Filter by category
browserwing ls --category=finance

# JSON output for programmatic use
browserwing ls --format=json

Built-in Script Categories

| Category | Examples | |----------|---------| | Tech | hackernews-top, github-trending, producthunt-hot, devto-top, stackoverflow-hot | | Finance | sinafinance-rank, eastmoney-hot, xueqiu-hot, binance-gainers, yahoo-finance-quote | | News | 36kr-hot, toutiao-hot, bbc-news, bloomberg-rss, reuters-search | | Social | weibo-hot, zhihu-hot, xiaohongshu-hot, reddit-popular, twitter-trending | | Entertainment | bilibili-hot, douban-movie-hot, douyin-hot, imdb-trending, youtube-trending | | Shopping | jd-search, taobao-search, amazon-bestsellers, xianyu-hot, smzdm-hot | | Academic | arxiv-new, google-scholar-search, baidu-scholar-search, cnki-search | | Jobs | boss-recommend, linkedin-jobs | | Reading | douban-book-hot, weread-ranking, substack-feed, lesswrong-curated | | Government | gov-policy, gov-law |

Direct Browser Control

Control Chrome directly from the CLI — navigate, click, type, extract, screenshot, and more.

Workflow: Navigate → Snapshot → Interact → Extract

# 1. Navigate to a page
browserwing exec navigate https://example.com

# 2. Get page structure with element RefIDs
browserwing exec snapshot

# Output shows elements like:
#   @e1 - Search (textbox)
#   @e2 - Login (button)
#   @e3 - Sign Up (link)

# 3. Interact using RefIDs
browserwing exec type @e1 "search query"
browserwing exec press-key Enter
browserwing exec click @e2

# 4. Extract data
browserwing exec extract ".result-item" --fields=text,href --multiple

# 5. Take screenshot
browserwing exec screenshot --output=page.png

# 6. Execute JavaScript
browserwing exec eval 'document.title'

All exec Actions

| Action | Usage | Description | |--------|-------|-------------| | navigate | exec navigate | Open a URL | | snapshot | exec snapshot | Get accessibility tree with @e refs | | click | exec click | Click element | | type | exec type | Type into input | | extract | exec extract [--fields=text,href] [--multiple] | Extract data | | wait | exec wait [--state=visible] [--timeout=10] | Wait for element | | press-key | exec press-key | Press key | | screenshot | exec screenshot [--output=file.png] | Take screenshot | | eval | exec eval '' | Run JavaScript | | fill-form | exec fill-form --field=name:value [--submit] | Fill form fields | | tabs | exec tabs | Manage tabs | | select | exec select | Select dropdown | | hover | exec hover | Hover element | | scroll | exec scroll | Scroll to bottom | | back/forward | exec back, exec forward | Navigation history | | page-info | exec page-info | Get URL and title |

Admin Operations

Manage LLM configs, browser instances, cookies, scripts, and AI exploration — all from the CLI.

# LLM Configuration
browserwing config list
browserwing config add --name=gpt --provider=openai --api-key=sk-xxx --model=gpt-4o
browserwing config test gpt

# Browser Instances
browserwing browser list
browserwing browser start
browserwing browser stop

# Cookie Management
browserwing cookie list
browserwing cookie save
browserwing cookie import cookies.json

# Script Management
browserwing script get 
browserwing script create my-script.json
browserwing script delete 
browserwing script export --output=SKILL.md
browserwing script summary

# AI Exploration (auto-generate scripts)
browserwing explore start --url=https://example.com --task="find top products"
browserwing explore script 
browserwing explore save 

# System
browserwing health
browserwing doctor
browserwing mcp status

Output Formats

All commands support --format=json|table|csv:

browserwing run zhihu-hot --format=json    # default, for piping
browserwing run zhihu-hot --format=table   # human-readable
browserwing run zhihu-hot --format=csv     # spreadsheet-friendly

Agent Integration Pattern

Typical AI agent workflow:

# Step 1: Discover available scripts
browserwing ls --format=json

# Step 2: Find relevant script
browserwing ls --search=stock --format=json

# Step 3: Execute and get structured data
browserwing run sinafinance-rank

# Step 4: Pipe to other tools
browserwing run hackernews-top | jq '.[0:5]'

For direct browser control:

# Step 1: Open page
browserwing exec navigate https://example.com

# Step 2: Understand page structure
browserwing exec snapshot

# Step 3: Interact
browserwing exec click @e3
browserwing exec type @e5 "query"

# Step 4: Extract results
browserwing exec extract ".item" --fields=text,href --multiple --format=json

CLI Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 1 | General error | | 2 | Cannot connect to server | | 3 | Script not found | | 4 | Script execution failed | | 64 | Bad arguments |

Environment Variables

| Variable | Description | |----------|-------------| | BROWSERWING_URL | Server URL (default: auto-detect from config.toml) | | BROWSERWING_JSON_ERRORS | Set to 1 for JSON error output on stderr |

Links

• GitHub: https://github.com/browserwing/browserwing
• npm: https://www.npmjs.com/package/browserwing
• Gitee: https://gitee.com/browserwing/browserwing

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: browserwing
• Source: browserwing/browserwing
• License: MIT
• Homepage: https://www.browserwing.com

Install and usage instructions live in the source repository linked above.