Loading latest release...

Let AI browse the web for you

A browser window opens so you can handle captchas and logins while the AI does everything else.

Quick Install

Copy and paste into your terminal

Terminal

              curl -fsSL https://github.com/afalcongonzalez/surfmate.io/releases/latest/download/surfmate.io-darwin-arm64 -o /usr/local/bin/surfmate.io && chmod +x /usr/local/bin/surfmate.io
            

Setup

Choose your AI assistant

Add to Claude config

Open Claude → Settings → Developer → Edit Config and paste:

claude_desktop_config.json

                    {
  "mcpServers": {
    "surfmate": {
      "command": "surfmate.io"
    }
  }
}
                  

Restart Claude and try it

"Open the browser and go to news.ycombinator.com"

"Open a browser and search Wikipedia for AI"

Install ngrok

ngrok creates a public URL for your local server so ChatGPT can reach it.

macOS (Homebrew)

brew install ngrok

Or download from ngrok.com/download for other platforms.

Then sign up at ngrok.com (free) and run:

Terminal

ngrok config add-authtoken YOUR_AUTH_TOKEN

Start surfmate and ngrok

Open two terminal windows:

Terminal 1 - Start surfmate

surfmate.io -http -port 8080

Terminal 2 - Start ngrok

ngrok http 8080

ngrok will show a URL like https://abc123.ngrok.io — copy this.

Add to ChatGPT

Go to ChatGPT → Create a GPT → Configure → Add actions → Import from URL:

                    Paste your ngrok URL + /openapi.yaml
                  
                    https://abc123.ngrok.io/openapi.yaml

Replace abc123.ngrok.io with your actual ngrok URL. Save and start chatting!

Keep both terminals running while using ChatGPT. The browser opens on your computer so you can handle captchas.

Why Surfmate?

👁

You stay in control

A real browser window opens on your screen. See everything the AI does.

🔐

Handle logins yourself

AI waits for you at login pages. Sign in, then AI continues.

🤖

Beat captchas together

AI can't solve captchas, but you can. AI pauses and lets you handle it.

⚡

No dependencies

Uses Chrome, Edge, or Brave already on your computer.

Found a bug or have a feature request? Open an issue on GitHub