Hyperbrowser MCP — Claude Code MCP 서버

스크래핑·구조화 추출·크롤링과 함께 범용 브라우저 에이전트(Computer Use, Browser Use 등)를 제공하는 공식 Hyperbrowser MCP 서버.

Hyperbrowser MCP는 Hyperbrowser가 공식 제공하는 MCP(Model Context Protocol) 서버로, Claude Code 같은 MCP 호환 AI 클라이언트에 클라우드 기반 헤드리스 브라우저 기능을 연결해 줍니다. 핵심은 두 갈래입니다. 첫째는 웹 데이터 수집 — 단일 페이지 스크래핑, 사이트 단위 크롤링, 그리고 자유 텍스트 HTML에서 원하는 필드만 뽑아내는 구조화 추출(data extraction)을 제공합니다. 둘째는 범용 브라우저 에이전트 — Computer Use, Browser Use 등으로 대표되는 에이전트형 자동화로, 모델이 실제 브라우저를 조작해 페이지를 탐색·클릭·입력하며 작업을 수행하도록 합니다.

이 서버가 푸는 문제는 분명합니다. LLM 단독으로는 최신 웹 콘텐츠에 접근하거나, JavaScript로 렌더링되는 동적 페이지를 읽거나, 로그인·페이지네이션이 얽힌 멀티스텝 브라우징을 수행하기 어렵습니다. Hyperbrowser MCP는 이를 관리형 원격 브라우저 인프라로 대신 처리하고, 결과를 모델이 바로 쓰기 좋은 형태(텍스트·구조화 데이터)로 돌려줍니다. 로컬에 브라우저 드라이버나 봇 우회 스택을 직접 구축·유지하지 않아도 된다는 점이 장점입니다.

이런 분들에게 적합합니다. 리서치·시장 조사·가격 모니터링처럼 여러 페이지에서 데이터를 모아 구조화해야 하는 작업, 문서가 흩어진 사이트를 크롤링해 요약·색인하려는 작업, 그리고 폼 작성·플로우 검증 같은 에이전트형 브라우저 자동화가 필요한 작업입니다. Node(npx) 환경에서 실행되며 사용에는 Hyperbrowser API 키(HYPERBROWSER_API_KEY)가 필요합니다. 제공 도구의 정확한 목록·인자·요금제는 버전에 따라 달라질 수 있으니 공식 GitHub 저장소(hyperbrowserai/mcp)와 Hyperbrowser 문서를 확인하는 것을 권장합니다.

언제 쓰나

동적(JS 렌더링) 페이지를 읽거나, 여러 페이지를 크롤링해 구조화 데이터로 추출하거나, 로그인·클릭·입력이 필요한 멀티스텝 브라우저 작업을 에이전트로 자동화할 때 적합합니다. 로컬에 브라우저 드라이버·봇 우회 스택을 직접 운영하기 부담스럽고, 관리형 원격 브라우저로 위임하고 싶을 때 유용합니다. 단순 정적 텍스트 한두 페이지만 필요하면 가벼운 검색·페치 MCP로 충분할 수 있습니다.

설치

claude mcp add hyperbrowser -e HYPERBROWSER_API_KEY=<HYPERBROWSER_API_KEY> -- npx -y hyperbrowser-mcp

Node.js 환경이 필요하며 npx로 패키지를 받아 실행합니다. 사용 전에 Hyperbrowser 계정에서 API 키(HYPERBROWSER_API_KEY)를 발급해 환경변수로 전달해야 합니다. 키 없이는 브라우저 세션이 동작하지 않습니다. 원격 클라우드 브라우저를 호출하므로 네트워크 연결이 필요하고, 크롤링·세션 사용량에 따라 요금이 발생할 수 있으니 요금제를 먼저 확인하세요. 제공 도구의 정확한 이름·인자·기본값은 버전마다 바뀔 수 있어 공식 GitHub(hyperbrowserai/mcp)와 Hyperbrowser 문서로 확인하는 것을 권장합니다.

필요 키(직접 발급, 플레이스홀더): HYPERBROWSER_API_KEY

보안 주의

HYPERBROWSER_API_KEY는 과금·세션 권한이 묶인 비밀키입니다. 유출 시 무단 사용·비용 폭증으로 이어질 수 있으니 셸 히스토리·로그·커밋에 노출하지 말고 환경변수나 시크릿 매니저로만 주입하세요. 크롤링·추출하는 페이지의 robots 정책과 이용약관, 개인정보·저작권을 준수해야 하며, 로그인 자격증명을 다루는 자동화는 신뢰 가능한 대상으로 제한하세요. 특히 외부 웹 콘텐츠를 모델 컨텍스트로 들여오는 만큼 프롬프트 인젝션 위험이 큽니다 — 페이지 본문에 숨겨진 지시가 에이전트를 조종할 수 있으므로, 가져온 내용을 신뢰 입력으로 취급하지 말고 민감 작업은 사람 승인 게이트를 두세요.

자주 묻는 질문

Hyperbrowser MCP를 쓰려면 무엇이 필요한가요?

Node.js(npx) 실행 환경과 Hyperbrowser API 키(HYPERBROWSER_API_KEY)가 필요합니다. 키는 Hyperbrowser 계정에서 발급하며 환경변수로 전달합니다. 브라우저는 원격 클라우드에서 동작하므로 네트워크 연결이 필요합니다.

스크래핑과 브라우저 에이전트는 어떻게 다른가요?

스크래핑·크롤링·구조화 추출은 페이지 콘텐츠를 읽어 데이터로 돌려주는 데 초점이 있고, Computer Use·Browser Use 같은 에이전트형 도구는 모델이 실제 브라우저를 조작해 클릭·입력 등 멀티스텝 작업을 수행하게 합니다. 정확한 도구 목록은 공식 저장소를 확인하세요.

비용이 드나요?

Hyperbrowser는 관리형 클라우드 브라우저 서비스이므로 크롤링·세션 사용량에 따라 과금될 수 있습니다. 정확한 요금제와 무료 한도는 Hyperbrowser 공식 문서에서 확인하는 것을 권장합니다.