Saffron Browser Developer Surface

High-concurrency sovereign headless browser automation. 100% wire-compatible with the Steel.dev API, engineered with zero cloud markups, live SSE screencasting, and multi-vector proxy mesh routing.

Switch from Steel.dev in 60 Seconds

Because Saffron Browser maintains a 100% Steel.dev-compatible superset API, migrating existing code requires changing exactly one parameter: the base_url.

python — main.py (Steel Client)
- from steel import Steel; client = Steel(steel_api_key="...", base_url="https://api.steel.dev")
+ from steel import Steel; client = Steel(steel_api_key="sb_live_...", base_url="https://api.saffronbrowser.com/v1")
typescript / node — scraper.ts
- const steel = new Steel({ apiKey: process.env.STEEL_KEY });
+ const steel = new Steel({ apiKey: process.env.SAFFRON_KEY, baseUrl: 'https://api.saffronbrowser.com/v1' });

Your existing code will automatically benefit from Saffron's 60% lower costs, zero-charge block guarantees, and transatlantic residential egress.

Model Context Protocol (MCP) Setup

Connect Saffron Browser directly to Claude Desktop or Cursor for agentic browsing.

Claude Desktop Configuration

Add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "saffron-browser": {
      "command": "npx",
      "args": ["-y", "@saffron/browser-mcp"],
      "env": {
        "SAFFRON_BROWSER_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

API Reference

POST /v1/scrape

One-shot stateless scrape converting target web pages into clean LLM markdown, bypassing Cloudflare and bot shields.

Request Body

{
  "url": "https://example.com/pricing",
  "format": "markdown",
  "proxy": {
    "tier": "direct" // Options: "direct", "v6spray", "tor", "residential"
  }
}

Response (200 OK)

{
  "ok": true,
  "url": "https://example.com/pricing",
  "title": "Example Pricing",
  "markdown": "# Pricing\n\n- Starter: $10\n- Enterprise: Custom\n",
  "egressIp": "195.201.16.112",
  "costCredits": 1
}
GET /v1/sessions/:id/screencast

Streams live JPEG frames over Server-Sent Events (SSE) directly from Chrome DevTools Protocol (CDP) at up to 10 FPS.