# AgentBrowse

Let AI agents read **public webpages** safely — with short quotes you can check.

**Product:** https://agentmediatools.com/agentbrowse

**API:** https://agentmediatools.com/tool/browser-browse

**Companion status:** `GET /api/browser/companion`

## Why this beats “agent already has the web”

| What people use today | Gap | AgentBrowse |
|----------------------|-----|-------------|
| Model built-in browse | Hard to audit; weak proof | Title, URL, short quotes |
| Raw fetch / DIY Playwright | You host it; SSRF risk | Private nets blocked; site allowlists |
| Field scrapers | Rigid columns | Research answers + evidence |
| Cloud-browser-only | Expensive for simple pages | Free daily light reads; Companion for private/hard cases |

## Companion (optional local reader)

Allowed public pages load from **your computer and your internet** when Companion is online. Companion returns structured text; it is not a remote desktop and does not use your signed-in browser tabs.

The current builds connect to `wss://agentmediatools.com/bridge/ws`. Your AMT
key is sent in the encrypted WebSocket authorization header, verified by AMT,
and mapped to your account without being stored by the AgentBrowse runtime.
Hosted and Companion reads use the same DNS-pinned reader, redirect validation,
domain allowlist, private-network blocks, byte cap, and timeout policy.

### Downloads

| Platform | URL |
|----------|-----|
| Linux x64 | [/downloads/agentbrowse/agentbrowse-companion-linux-x64](/downloads/agentbrowse/agentbrowse-companion-linux-x64) |
| Windows x64 | [/downloads/agentbrowse/agentbrowse-companion-windows-x64.exe](/downloads/agentbrowse/agentbrowse-companion-windows-x64.exe) |
| macOS Apple Silicon | [/downloads/agentbrowse/agentbrowse-companion-darwin-arm64](/downloads/agentbrowse/agentbrowse-companion-darwin-arm64) |
| macOS Intel | [/downloads/agentbrowse/agentbrowse-companion-darwin-x64](/downloads/agentbrowse/agentbrowse-companion-darwin-x64) |

### Confirm Companion is working

```bash
curl -s https://agentmediatools.com/api/browser/companion \
  -H "Authorization: Bearer YOUR_API_KEY" | jq .
# → companion_online: true
```

Also: green “Ready” in the Companion panel, and the badge on [Agent Hub](/agents#agentbrowse).

## How it works

1. Agent asks about a page.
2. **Who opens it?** Companion online → your machine. Else → server HTTP when capacity allows.
3. **Outcomes:** full extract · partial · hard failure (JS wall / bot / timeout) with a clear code.
4. Proof: title, URL, quotes. Optional `evidence: "paragraph"` for longer research excerpts.

Each text-evidence item includes `content_sha256`, a deterministic hash of its
URL, page title, and quote. Use it to compare or deduplicate evidence across
runs. It is a content integrity identifier, not a signature from the source
website.

## JS-heavy sites

| Outcome | Meaning |
|---------|---------|
| Successful HTTP read | Usable text extracted |
| Partial | Thin content (`content_quality: partial`) |
| Hard failure | `js_wall` / `blocked` / `timeout` — use **Companion** |

Mode **`auto`** (recommended): Companion if online → server HTTP → Companion on JS walls.

## Quick start

```bash
curl -X POST https://agentmediatools.com/api/browser/browse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "goal": "Summarize this page",
    "start_url": "https://example.com",
    "allowed_domains": ["example.com"],
    "mode": "auto",
    "evidence": "short"
  }'
```

`allowed_domains` is **required** (list real public domains). Private networks are always blocked.

## Pricing

| What | Free daily | After free |
|------|------------|------------|
| Page read (server or Companion) | **5/day** | **1** credit |
| `cloud_browser` (if enabled) | Usually none | **3** credits |

Response `billing.free_remaining` and header `X-AgentBrowse-Free-Remaining` when relevant.

Header `X-AgentBrowse-Companion: online|offline` on browse responses.

## Modes (MCP `browse_web` = same fields)

| Mode | Behavior |
|------|----------|
| **auto** ★ | Companion → HTTP → Companion on JS/bot walls |
| http_read | Server public HTML |
| local_browser | Always Companion |
| cloud_browser | Server Chromium (opt-in) |

## Safety (unchanged)

- SSRF: private IPs, localhost, cloud metadata blocked
- `allowed_domains` required
- Proof quotes, not vibes

## Verification

Live suite: https://agentmediatools.com/benchmark/agentbrowse

Machine-readable snapshot: https://agentmediatools.com/data/agentbrowse-benchmark.json

Re-run: `npm run test:sites -- --json ./agentbrowse-benchmark.json`
