Plasmate - Browser Engine for Agents

---

name: plasmate

description: Browse the web via Plasmate, a fast headless browser engine for agents. Compiles HTML into a Semantic Object Model (SOM) - 50x faster than Chrome, 10x fewer tokens. Supports AWP (Agent Web Protocol) and CDP compatibility.

homepage: https://plasmate.app

metadata:

{

"openclaw":

{

"emoji": "⚡",

"source": "https://github.com/plasmate-labs/plasmate",

"license": "Apache-2.0",

"privacy": "https://plasmate.app/privacy",

"requires": { "bins": ["plasmate"] },

"install":

[

{

"id": "cargo",

"kind": "shell",

"command": "cargo install plasmate",

"bins": ["plasmate"],

"label": "Install Plasmate (cargo, builds from source)",

},

{

"id": "shell",

"kind": "shell",

"command": "curl -fsSL https://plasmate.app/install.sh | sh",

"bins": ["plasmate"],

"label": "Install Plasmate (pre-built binary)",

},

],

},

}

---

# Plasmate - Browser Engine for Agents

Plasmate compiles HTML into a Semantic Object Model (SOM). 50x faster than Chrome, 10x fewer tokens.

Install

# Build from source (recommended)
cargo install plasmate

# Or use the install script
curl -fsSL https://plasmate.app/install.sh | sh

Protocols

Default to AWP. Use CDP only when existing Puppeteer/Playwright code needs reuse.

Quick Start

Fetch (one-shot, no server)

plasmate fetch <url>

Returns SOM JSON: regions, interactive elements with stable IDs, extracted content.

Server Mode

# AWP (recommended)
plasmate serve --protocol awp --port 9222

# CDP (Puppeteer compatible)
plasmate serve --protocol cdp --port 9222

AWP Usage (Python)

Run `scripts/awp-browse.py` for AWP interactions:

# Navigate and get SOM snapshot
python3 scripts/awp-browse.py navigate "https://example.com"

# Click an interactive element by ref ID
python3 scripts/awp-browse.py click "https://example.com" --ref "e12"

# Type into a field
python3 scripts/awp-browse.py type "https://example.com" --ref "e5" --text "search query"

# Extract structured data (JSON-LD, OpenGraph, tables)
python3 scripts/awp-browse.py extract "https://example.com"

# Scroll
python3 scripts/awp-browse.py scroll "https://example.com" --direction down

CDP Usage (Puppeteer)

When CDP is needed, connect Puppeteer to the running server:

const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://127.0.0.1:9222'
});
const page = await browser.newPage();
await page.goto('https://example.com');
const content = await page.content();

SOM Output Structure

SOM is a structured JSON representation, NOT raw HTML. Key sections:

Use ref IDs from `interactive` elements for click/type actions.

Performance

| Metric | Plasmate | Chrome |

|--------|----------|--------|

| Per page | 4-5 ms | 252 ms |

| Memory (100 pages) | ~30 MB | ~20 GB |

| Output size | SOM (10-800x smaller) | Raw HTML |

When to Use Plasmate vs Browser Tool