안티 봇 보호 기능을 우회하여 AI 클라이언트가 웹사이트를 잠금 해제, 렌더링, 크롤링 및 스크린샷할 수 있도록 지원합니다.
다른 이름 browsersolver/browsersolver-mcp, browsersolver-mcp, @browsersolver/mcp
- 스타
- 0
- Tools
- 8
- 다운로드, 30일
- 307
- 최신 버전
- 0.1.0
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
BrowserSolver MCP란?
BrowserSolver은(는) MCP server입니다. 안티 봇 보호 기능을 우회하여 AI 클라이언트가 웹사이트를 잠금 해제, 렌더링, 크롤링 및 스크린샷할 수 있도록 지원합니다. 8개 도구를 제공합니다. 예: stats, usage, website_antibot.
프로젝트 README에서 생성된 요약
BrowserSolver MCP server 정보
BrowserSolver는 Claude, Cursor, Windsurf와 같은 AI 클라이언트가 안티 봇 보호 기능을 우회하여 웹 콘텐츠에 접근할 수 있도록 지원합니다. 이 MCP server는 로컬 또는 원격 환경을 BrowserSolver API에 연결하여, 일반적으로 자동화된 접근을 차단하는 웹사이트와 모델이 상호작용할 수 있게 합니다. 웹에서 크롤링, 렌더링 및 시각적 데이터를 캡처하기 위한 전문 도구 모음을 제공합니다.
개발자는 npx를 통한 stdio 방식으로 이 서버를 로컬에 배포하거나 Streamable HTTP를 사용하여 원격으로 호스팅할 수 있습니다. 연결을 설정하려면 환경 변수 또는 HTTP header를 통해 제공되는 BrowserSolver API key가 필요합니다. 이 서버는 까다로운 쇼핑몰 사이트를 위한 website_webunlocker, PNG 또는 PDF와 같은 시각적 자산을 생성하는 website_screenshot, CMS 또는 보안 프레임워크를 식별하는 website_technology 등 다양한 기능을 제공합니다. 또한 크레딧 잔액을 모니터링하는 usage 및 인프라 상태를 확인하는 stats와 같은 관리 도구도 포함되어 있습니다.
활용 사례
- 1웹사이트 봇 보호 우회URL을 보호하는 특정 보안 업체를 식별하여 적절한 페칭 티어를 선택합니다.
- 2웹사이트 시각 자료 캡처공개된 웹 주소를 JPEG 또는 PDF와 같은 시각적 파일 형식으로 변환합니다.
- 3웹 기술 스택 분석특정 웹사이트에서 사용하는 프레임워크, 분석 도구 및 CDN을 파악합니다.
- 4API 계정 상태 모니터링현재 크레딧 잔액과 실시간 사용 통계를 확인합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
BrowserSolver MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 BrowserSolver MCP 설치
$ claude mcp add --env 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' browsersolver-mcp -- npx -y @browsersolver/mcpCursor에 BrowserSolver MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"browsersolver-mcp": {
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}VS Code에 BrowserSolver MCP 설치
.vscode/mcp.json
{
"servers": {
"browsersolver-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}VS Code CLI에 BrowserSolver MCP 설치
$ code --add-mcp '{"name":"browsersolver-mcp","type":"stdio","command":"npx","args":["-y","@browsersolver/mcp"],"env":{"BROWSERSOLVER_API_KEY":"<YOUR_BROWSERSOLVER_API_KEY>"}}'Claude Desktop에 BrowserSolver MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"browsersolver-mcp": {
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}Codex에 BrowserSolver MCP 설치
$ codex mcp add browsersolver-mcp --env 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' -- npx -y @browsersolver/mcpCodex config.toml에 BrowserSolver MCP 설치
~/.codex/config.toml
[mcp_servers.browsersolver-mcp] command = "npx" args = ["-y", "@browsersolver/mcp"] [mcp_servers.browsersolver-mcp.env] BROWSERSOLVER_API_KEY = "<YOUR_BROWSERSOLVER_API_KEY>"
Gemini CLI에 BrowserSolver MCP 설치
$ gemini mcp add -s user -e 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' browsersolver-mcp npx -- -y @browsersolver/mcpGemini settings.json에 BrowserSolver MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"browsersolver-mcp": {
"command": "npx",
"args": [
"-y",
"@browsersolver/mcp"
],
"env": {
"BROWSERSOLVER_API_KEY": "<YOUR_BROWSERSOLVER_API_KEY>"
}
}
}
}BrowserSolver MCP 도구 8
README에서 감지됨statsusagewebsite_antibotwebsite_crawlerwebsite_renderingwebsite_screenshotwebsite_technologywebsite_webunlocker
| stats | — | |
| usage | — | |
| website_antibot | — | |
| website_crawler | — | |
| website_rendering | — | |
| website_screenshot | — | |
| website_technology | — | |
| website_webunlocker | — |
구성
BROWSERSOLVER_API_KEY필수비밀BrowserSolver API key.
| 이름 | 설명 | 유형 |
|---|---|---|
| BROWSERSOLVER_API_KEY | BrowserSolver API key. | 필수비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기BrowserSolver MCP Server
Official Model Context Protocol server for the BrowserSolver web unlocker API.
Unlock, render, crawl and screenshot any website — anti-bot bypass and technology detection through one API.
It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).
Requirements
Hosted server (recommended)
BrowserSolver runs this server for you at https://mcp.browsersolver.com/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.
claude mcp add --transport http browsersolver https://mcp.browsersolver.com/ --header "x-api-key: YOUR_API_KEY"
{
"mcpServers": {
"browsersolver": {
"url": "https://mcp.browsersolver.com/",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}
The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.
Run it locally
Claude Code
claude mcp add browsersolver --env BROWSERSOLVER_API_KEY=YOUR_API_KEY -- npx -y @browsersolver/mcp
Claude Desktop, Cursor, Windsurf and other clients
Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):
{
"mcpServers": {
"browsersolver": {
"command": "npx",
"args": ["-y", "@browsersolver/mcp"],
"env": {
"BROWSERSOLVER_API_KEY": "YOUR_API_KEY"
}
}
}
}
VS Code
{
"servers": {
"browsersolver": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@browsersolver/mcp"],
"env": {
"BROWSERSOLVER_API_KEY": "${input:browsersolver-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "browsersolver-api-key",
"description": "BrowserSolver API key",
"password": true
}
]
}
Claude Desktop extension
Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.
Docker
docker build -t browsersolver-mcp .
docker run -i --rm -e BROWSERSOLVER_API_KEY=YOUR_API_KEY browsersolver-mcp
Tools
| Tool | Description |
|---|---|
stats |
Infrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it. |
usage |
Retrieve real-time usage statistics and credit balance for your BrowserSolver account. |
website_antibot |
Single-pass scan that names the bot-protection vendor in front of a URL so you can choose the right BrowserSolver fetch tier next. |
website_crawler |
Fast HTTP pull of public HTML with no browser session. Ideal when the first response already contains the content you need. |
website_rendering |
Run a managed browser session against a public URL and collect the HTML after client-side scripts finish. Prefer Crawler for static markup; escalate to WebUnlocker on approved hosts when challenges p… |
website_screenshot |
Turn any public URL into a PNG, JPEG, WebP, or PDF asset rendered by BrowserSolver. No local Chromium fleet to operate. |
website_technology |
Map CMS, frameworks, analytics, CDN, and security tooling exposed by a public URL. Choose simple lists or expert metadata with confidence scores. |
website_webunlocker |
BrowserSolver's highest HTML fetch tier for retail and marketplace hosts on your account whitelist. Solves persistent bot challenges that still block Rendering. |
Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.
Streamable HTTP
npx @browsersolver/mcp --http --port 3000
The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.
createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):
import { createHttpHandler } from "@browsersolver/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };
Security
- The API key is read from
BROWSERSOLVER_API_KEY(stdio) or the request headers (HTTP) and removed from error messages. - Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
- See SECURITY.md to report a vulnerability.
Development
npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js
Built on the SDK
The server uses the official Node.js SDK (@browsersolver/sdk).
All BrowserSolver SDKs
| SDK | Package | Install |
|---|---|---|
| Node.js | @browsersolver/sdk |
npm install @browsersolver/sdk |
| Python | browsersolver |
pip install browsersolver |
| Go | browsersolver-go |
go get github.com/browsersolver/browsersolver-go |
| .NET | BrowserSolver |
dotnet add package BrowserSolver |
| Ruby | browsersolver |
gem install browsersolver |
| PHP | browsersolver/sdk |
composer require browsersolver/sdk |
| Java | browsersolver-java |
build from source, see its README |
| CLI | @browsersolver/cli |
npm install -g @browsersolver/cli |
| MCP server | @browsersolver/mcp |
npx -y @browsersolver/mcp |
License
MIT — see LICENSE.
BrowserSolver MCP 질문
BrowserSolver MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'BROWSERSOLVER_API_KEY=<YOUR_BROWSERSOLVER_API_KEY>' browsersolver-mcp -- npx -y @browsersolver/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
BrowserSolver MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
BrowserSolver MCP는 어떤 도구를 제공하나요?
8개 도구를 제공합니다. 예: stats, usage, website_antibot, website_crawler, website_rendering.
BrowserSolver로 무엇을 할 수 있나요?
안티 봇 보호 기능을 우회하고 웹 기술을 감지하는 것을 포함하여 모든 웹사이트를 잠금 해제, 렌더링, 크롤링 및 스크린샷할 수 있습니다.
서버를 어떻게 실행하나요?
Streamable HTTP를 통해 호스팅 버전을 사용하거나 npx를 사용하여 stdio 방식으로 로컬에서 실행할 수 있습니다.
도구 사용 시 비용이 발생하나요?
네, API와 상호작용하는 모든 도구 호출은 크레딧을 소모합니다.