# Browserwing

> 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", "e…

- **Type:** Skill
- **Install:** `agentstack add skill-browserwing-browserwing-browserwing`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [browserwing](https://agentstack.voostack.com/s/browserwing)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [browserwing](https://github.com/browserwing)
- **Source:** https://github.com/browserwing/browserwing/tree/main/skills/browserwing
- **Website:** https://www.browserwing.com

## Install

```sh
agentstack add skill-browserwing-browserwing-browserwing
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
npm install -g browserwing
```

Then start the server:

```bash
browserwing --port 8080
```

Chrome must be installed on the host machine.

### Verify Installation

```bash
browserwing doctor
```

## Quick Start — Run Built-in Scripts

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

```bash
# 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

```bash
# 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

```bash
# 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.

```bash
# 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`:

```bash
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:

```bash
# 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:

```bash
# 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](https://github.com/browserwing)
- **Source:** [browserwing/browserwing](https://github.com/browserwing/browserwing)
- **License:** MIT
- **Homepage:** https://www.browserwing.com

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-browserwing-browserwing-browserwing
- Seller: https://agentstack.voostack.com/s/browserwing
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.