/browserwing

name: browserwing
description: Browser automation platform with 78 built-in scripts and full CLI. Turn any website into structured data with one command. Use when the user needs to scrape websites, extract data, automate browsers, run built-in scripts (Hacker News, GitHub trending, Bilibili, Zhihu, stock data, etc.), navigate pages, fill forms, take screenshots, or control Chrome programmatically. Triggers include "scrape", "extract data", "browser automation", "web data", "trending", "hot topics", "stock data", "run script", "open website", "fill form", "screenshot", "headless browser".

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 <url>` | Open a URL | | snapshot | `exec snapshot` | Get accessibility tree with @e refs | | click | `exec click <@ref>` | Click element | | type | `exec type <@ref> <text>` | Type into input | | extract | `exec extract <selector> [--fields=text,href] [--multiple]` | Extract data | | wait | `exec wait <@ref> [--state=visible] [--timeout=10]` | Wait for element | | press-key | `exec press-key <Enter\|Tab\|Escape>` | Press key | | screenshot | `exec screenshot [--output=file.png]` | Take screenshot | | eval | `exec eval '<js>'` | Run JavaScript | | fill-form | `exec fill-form --field=name:value [--submit]` | Fill form fields | | tabs | `exec tabs <list\|new\|switch\|close>` | Manage tabs | | select | `exec select <@ref> <value>` | Select dropdown | | hover | `exec hover <@ref>` | 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 <id>
browserwing script create my-script.json
browserwing script delete <id>
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 <session-id>
browserwing explore save <session-id>

# 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