🤖 Browser4

---

English | 简体中文 | 中国镜像

Table of Contents

• 🤖 Browser4
  • 🌟 Introduction
    • ✨ Key Capabilities
  • Quick Start
  • 🧭 Tool Selection Guide
    • How to Interact with a Page
    • How to Extract Data
    • How to Process at Scale
    • How to Turn HTML into Spreadsheets — Zero Tokens
  • 📦 Installation
  • 💡 CLI Guide for Humans
    • Quick start
    • Mental model
    • Global options
    • Key concepts before the command list
    • Complete command reference
    • Timeout environment variables
    • State persistence
  • 🚀 Build from Source
  • Architecture
  • 📦 Modules Overview
  • 🧪 Test Fixture Server (MockSite)
  • 🤝 Support & Community
  • 📜 Documentation
  • 🔧 Proxy Configuration
  • License

🌟 Introduction

💖 Browser4 — an AI-native browser engine for autonomous agents, intelligent extraction, and large-scale web automation. 💖

✨ Key Capabilities

• 🤖 Agent Browser — Enable AI agents to browse, interact, and automate real-world websites.
• 🧠 ML-Powered Extraction — Learn page structures and extract structured data without LLM token costs.
• ⚡ High-Performance Runtime — Coroutine-safe architecture supporting 100k–200k complex page visits per machine per day.
• 🧬 Hybrid Intelligence — Combine LLM, ML, X-SQL, and selectors for robust extraction and experience reuse.
• 📦 Enterprise-Scale Automation — Swarm crawling, CDP-native control, batch jobs, stateful sessions, plugins, extensions, and more.

Quick Start

Paste the following instruction to your favorite AI agent like claude, codex, workbuddy or openclaw and run it:

Read https://browser4.io/SKILL.md and install browser4-cli (if not installed) for browser automation to perform the following task:

1. Open the browser in headed mode (`open --headed`) so the window is visible — this is a human-facing demo
2. go to amazon.com
3. search for pens to draw on whiteboards
4. compare the first 4 ones
5. write the result to a markdown file

DeepSeek Harness integration

https://github.com/platonai/dsh-browser4

dsh plugin --profile web add dsh-browser4                  # npm registry
dsh plugin --profile web add github:platonai/dsh-browser4  # GitHub

🧭 Tool Selection Guide

Choosing the right tool for your task:

How to Interact with a Page

Use snapshot -i --boxes to see clickable/typeable elements with refs like e15, then click <ref>, fill <ref> "<text>", type/press, select, hover/drag/scroll, and wait to drive the page. All interaction commands accept CSS selectors too. Chain multiple steps efficiently with batch.

Typical interactive flow:

…