브라우저 손

browser-hand

브라우저를 열어 누르고, 입력하고, 읽는다

커뮤니티
원격
TypeScript
도구 14
브라우저 자동화

변경 기록

제공: 한솔(개인, 가상)
전송: HTTP + stdio
인증: OAuth(원격)
라이선스: Apache-2.0
최신 버전: v0.9.3 2026-09-23
주간 방문: 36,800
순위: #2 1계단 오름
server.json: 있음

개요

엔드포인트https://browser-hand.example/mcp

8월부터 원격(HTTP)으로도 붙어, 설치 없이 주소 하나로 진짜 브라우저 창을 다룹니다.

원격은 로그인 창에서 권한을 고르고, 로컬은 따로 띄운 빈 브라우저 프로필만 만집니다.

설치

클라이언트를 고르면 설정이 바뀝니다

터미널 — 도구 목록 요청

curl -X POST https://browser-hand.example/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"method":"tools/list"}'

등대 데스크 — config.json

{
  "mcpServers": {
    "browser-hand": {
      "url": "https://browser-hand.example/mcp",
      "auth": "oauth"
    }
  }
}

터미널

dot mcp add --transport http browser-hand https://browser-hand.example/mcp
# 처음 부르면 로그인 창이 열린다
dot mcp list

원격 인증 — 3단계

1
클라이언트에 주소를 넣고 처음 부르면 로그인 창이 뜹니다.
2
허용할 권한을 고릅니다 — 탭 읽기 · 입력 · 파일 저장. 고르지 않은 도구는 목록에 뜨지 않습니다.
3
받은 토큰은 클라이언트가 보관합니다. 90일이 지나면 다시 묻습니다.

로그인된 창을 넘기지 마세요

로컬로 쓸 때 평소 쓰는 브라우저 프로필을 넘기면 에이전트가 그 계정으로 무엇이든 누를 수 있습니다. 빈 프로필을 새로 만들어 주소만 허락하세요.

제공 도구 14

도구	하는 일	인자	권한
open	새 탭에서 주소를 연다	url	쓰기
click	요소를 누른다	selector	쓰기
type	입력 칸에 글을 넣는다	selector, text	쓰기
scroll	쪽을 위아래로 민다	direction, amount	읽기
read_page	쪽의 글과 링크를 읽기 좋게 돌려준다	mode?	읽기
screenshot	보이는 화면이나 쪽 전체를 찍는다	full?	읽기
wait_for	요소가 나타날 때까지 기다린다	selector, ms?	읽기
select	목록 상자에서 값을 고른다	selector, value	쓰기
back	앞 쪽으로 돌아간다	—	쓰기
tabs	열린 탭 목록을 돌려준다	—	읽기
clear_cookies	쿠키를 지운다	domain?	쓰기
save_pdf	지금 쪽을 PDF 로 저장한다	path	읽기
hover	요소 위에 커서를 올린다	selector	쓰기
press_key	키보드 키를 누른다	key	쓰기

리소스 · 프롬프트

이름	종류	내용
tab://열린 탭	리소스	열린 탭의 주소와 제목
양식 채우기 점검	프롬프트	값을 넣기 전에 칸 목록을 먼저 확인하게 한다

쓰인 사례

아직 이 서버를 쓴 사례가 없습니다

브라우저 손으로 일을 줄인 팀이라면 첫 사례가 되어 주세요.

사례 보내기

변경 기록

v0.9.32026-09-23고침긴 쪽에서 read_page 가 끊기던 문제를 고쳤다
v0.9.02026-08-12추가원격(HTTP) 전송과 OAuth 로그인을 더했다
v0.5.02026-07-08호환 깨짐도구 이름을 정리했다 — goto → open, get_text → read_page