# BrowserSolver

The BrowserSolver MCP server for Claude Code gives an agent tools to fetch and inspect public websites. It can render pages, capture screenshots, identify bot protection, and detect site technologies.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: browsersolver
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/browsersolver/browsersolver-mcp
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/browsersolver

## What it does

BrowserSolver exposes tools for fetching public-page HTML, rendering pages, and saving screenshots as PNG, JPEG, WebP, or PDF. Other tools identify bot protection and site technologies, or return account usage and credit balance. API calls consume credits.

A local setup requires Node.js 20 or newer and a BrowserSolver API key. The local process reads the key from `BROWSERSOLVER_API_KEY`; HTTP clients send it in a request header. `website_webunlocker` is limited to retail and marketplace hosts on the account whitelist. Images appear inline, while other files are returned as embedded resources up to 4 MB.

The package can run locally through `npx`, or clients can connect to the hosted server. Local HTTP mode binds to `127.0.0.1` by default; TLS is needed before exposing it publicly.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.browsersolver.com/`
- Environment variables: `BROWSERSOLVER_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -e BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> -- npx -y @browsersolver/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http browsersolver https://mcp.browsersolver.com/
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add browsersolver --url https://mcp.browsersolver.com/
```

2. **Platform CLI**
```bash
codex mcp add browsersolver --env BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> -- npx -y @browsersolver/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "browsersolver": {
            "url": "https://mcp.browsersolver.com/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "browsersolver": {
            "command": "npx",
            "args": [
                "-y",
                "@browsersolver/mcp"
            ],
            "env": {
                "BROWSERSOLVER_API_KEY": "<BROWSERSOLVER_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "browsersolver": {
            "type": "http",
            "url": "https://mcp.browsersolver.com/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "browsersolver": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@browsersolver/mcp"
            ],
            "env": {
                "BROWSERSOLVER_API_KEY": "<BROWSERSOLVER_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http browsersolver https://mcp.browsersolver.com/
```

2. **Platform CLI**
```bash
gemini mcp add -e BROWSERSOLVER_API_KEY=<BROWSERSOLVER_API_KEY> browsersolver npx -y @browsersolver/mcp
```
Replace <…> with your own values

## When to use it
- fetch HTML from a public page
- save a webpage as a PDF screenshot
- identify a site's bot-protection vendor
- detect a site's CMS and frameworks
- check BrowserSolver credit usage

## Example prompts
- Fetch the HTML from this public page and summarize its contents.
- Capture this page as a PDF.
- Identify the technologies and bot protection used by this site.

## Similar
- [Google Lens](https://affpapa.org/en/nevibecode/mcp/google-lens.md) — MCP server · 387 installs
- [reefapi](https://affpapa.org/en/nevibecode/mcp/reefapi.md) — MCP server · 379 installs
- [ShopGraph](https://affpapa.org/en/nevibecode/mcp/shopgraph.md) — MCP server · 327 installs
- [Web Validator by DigestSEO](https://affpapa.org/en/nevibecode/mcp/digestseo-web-validator-by-digestseo.md) — MCP server · 317 installs
- [Bowmark: Live Web Data & Browser Actions](https://affpapa.org/en/nevibecode/mcp/bowmark-live-web-data-browser-actions.md) — MCP server · 302 installs
- [Bright Data](https://affpapa.org/en/nevibecode/mcp/bright-data.md) — MCP server · 300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
