Unbrowse - API Reverse Engineering for Agents

Overview

Unbrowse turns any website's internal APIs into agent-callable skills. It captures browser traffic, extracts API endpoints, and generates reusable skills.

URL: https://www.unbrowse.ai/

Core Value Proposition

The browser is a 45-second tax on every web action. Skip it.

Two OpenClaw/MCP Integrations

1. lekt9/unbrowse-openclaw

2. getfoundry/unbrowse-mcp

How It Works

Workflow

You browse a site normally
        ↓
Unbrowse captures all API traffic (CDP)
        ↓
Filters out noise (analytics, ads, CDNs)
        ↓
Extracts endpoints, auth, and parameters
        ↓
Generates a skill your agent can use
        ↓
Agent calls APIs directly — no browser needed

What It Captures

What It Generates

skill-name/
├── SKILL.md       # API documentation
├── auth.json      # Session cookies, tokens, API keys
├── scripts/
│   └── api.ts    # Generated TypeScript client
└── references/
    └── REFERENCE.md  # Detailed endpoint reference

Usage Examples

Natural Language Commands

"Learn airbnb.com"
→ Captures internal API traffic, generates skill

"Search Airbnb for cabins in Colorado"
→ Agent calls Airbnb's internal search API directly. No browser. 200ms.

"Log into twitter.com"
→ Captures your session cookies and tokens. Now your agent can act as you.

"Search marketplace for a Reddit skill"
→ Searches skill marketplace

"Download reddit-api skill"
→ Installs it (free or paid via x402)

"Publish airbnb skill for 1 USDC"
→ Lists it on marketplace

MCP Server Tools (unbrowse-mcp)

Available Tools

Authentication Options

x402: Agent Payments Protocol

x402 enables pay-per-request API access using Solana USDC.

Protocol Flow

1. Client makes request to x402 endpoint

2. Server responds with 402 + payment requirements:
   {
     "payment": {
       "type": "usdc",
       "network": "solana",
       "amount": "1000",  // USDC lamports
       "splits": [
         { "recipient": "PLATFORM", "amount": "200", "percentage": 20 },
         { "recipient": "OWNER", "amount": "800", "percentage": 80 }
       ]
     }
   }

3. Client constructs and signs USDC transfer transaction

4. Client retries with X-Payment header

5. Server verifies payment, submits transaction, returns result

API Endpoints

Search Abilities

GET /x402/abilities?q={query}&limit={limit}
Cost: 0.1 cents (1000 USDC lamports)

Execute Ability

POST /x402/abilities/{abilityId}/execute
Cost: 0.5 cents (5000 USDC lamports)
Split: 20% platform, 80% ability owner

Marketplace

"Humans have Google. Agents have nothing."

Unbrowse Marketplace is Google for agents.

Features

Example Commands

"Search for a Spotify skill"
"Download spotify-api skill"
"Publish airbnb skill for 2 USDC"
"Publish weather skill for free"

Why Not Browser Automation?

Why Not Wait for APIs/MCPs?

99% of websites will never have an API. Your agent needs to work anyway.

Installation

OpenClaw Plugin

# Tell your agent
"Install the unbrowse plugin"

# Or manually
openclaw plugins install @getfoundry/unbrowse-openclaw

MCP Server

# Run directly with npx
npx unbrowse-mcp

# Or install globally
npm install -g unbrowse-mcp

Claude Desktop Configuration

{
  "mcpServers": {
    "unbrowse": {
      "command": "npx",
      "args": ["unbrowse-mcp"],
      "env": {
        "SOLANA_PRIVATE_KEY": "your_base58_encoded_private_key"
      }
    }
  }
}

Environment Variables

# Authentication (choose ONE)
SOLANA_PRIVATE_KEY=your_base58_key      # x402 pay-per-request (recommended)
UNBROWSE_API_KEY=re_xxxxxxxxxxxxx       # API key auth
UNBROWSE_SESSION_TOKEN=cm4xxxxxxx       # Session token auth

# Optional
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com  # Custom RPC for x402
UNBROWSE_PASSWORD=your_encryption_password           # For credential decryption
DEV_MODE=true                                      # Show API usage docs
ENABLE_INDEX_TOOL=true                             # Enable API indexing

Use Cases

Integration with My Stack

Current MCP Servers

Potential Integration

Add unbrowse-mcp as 4th MCP server:

{
  "mcpServers": {
    "vision-agent": "./vision-agent-mcp",
    "code": "./code-mcp",
    "prompts": "./prompts-engine",
    "unbrowse": "npx unbrowse-mcp"  // NEW
  }
}

Workflow example:

1. Use unbrowse-mcp to search for "Twitter API" skill
2. Download skill (free or paid via x402)
3. Use vision-agent-mcp to verify site loaded
4. Use code-mcp to process API responses
5. Use prompts-engine to chain everything together

Key Insights for Justin

Why This Is Interesting

Potential Synergies

Next Steps to Explore

Links

Status: Exploration complete - This is highly relevant for our MCP ecosystem

Key Value: 50x faster web interactions, autonomous skill discovery, x402 payments

Next: Test unbrowse-mcp locally to evaluate integration potential

Date: 2026-02-04