원문 캡처 · github.com
원문 캡처 · github.com

NTXM Browser mini는 HTTP 요청으로 Chromium 브라우저를 제어하는 데스크톱 앱이다. 제작팀은 에이전트, 품질 보증(QA), 자동화 작업에서 브라우저를 다루려는 사람을 대상으로 공개했다. Windows와 Apple Silicon 기반 macOS에서 쓸 수 있다.

이게 뭔데?

브라우저와 제어용 서버를 한 앱에 넣은 도구다. 리모컨을 떠올리면 쉽다. 앱에 내장된 REST API(HTTP로 기능을 호출하는 인터페이스)에 요청을 보내 창과 탭을 열고, 페이지를 이동하거나 HTML을 읽을 수 있다.

무엇을 할 수 있나?

일반 데스크톱 브라우저처럼 웹을 탐색할 수 있으며, 창과 탭을 ID로 만들고 활성화하거나 닫을 수 있다. 현재 URL과 페이지 HTML을 가져오는 기능도 제공한다. 제어 페이지는 ntxm://control 또는 http://127.0.0.1:9090/control에서 열리고, 실행 중에는 http://127.0.0.1:9090/에서 앱 내 문서를 볼 수 있다.

기본 주소는 http://127.0.0.1:9090이다. ?window=와 ?tab=으로 대상을 지정할 수 있으며, 생략하면 활성 창과 탭을 대상으로 한다.

방식경로기능
GET/health상태 및 제품 버전
GET/windows창 목록
POST/window/new새 창 (?url= 또는 본문 사용)
POST/window/focus창 활성화
POST/window/close창 닫기 및 소속 탭 모두 닫기
GET/tabs탭 목록
POST/tab/new새 탭
POST/tab/activate탭 활성화
POST/tab/close탭 닫기
POST/navigate페이지 이동
POST/back · /forward · /reload기록 이동 및 새로고침
GET/url현재 URL
GET/content페이지 HTML
GET · POST/tunnel · /tunnel/start · /tunnel/stopCloudflare 터널 제어

설치하고 어떻게 시작하나?

최신 공개 버전은 v0.1.2다. Windows x64용 설치 파일은 NTXM_Browser_Mini_Setup_0.1.2.exe이며, NSIS 설치 프로그램에서 무인 설치 옵션으로 /S를 쓸 수 있다. Apple Silicon용 macOS 패키지는 릴리스에서 .app 또는 zip으로 제공되며 arm64 CEF 빌드다. 양쪽 모두 같은 제품과 REST API 주소를 사용한다. 최신 릴리스

설치 후 앱을 실행하면 제어 페이지가 자동으로 열린다. 아래 명령으로 상태와 창·탭 목록을 확인하고, 새 탭을 열거나 활성 탭을 이동시킬 수 있다.

bash
# Health
curl.exe http://127.0.0.1:9090/health

# List windows & tabs
curl.exe http://127.0.0.1:9090/windows
curl.exe http://127.0.0.1:9090/tabs

# Open a tab
curl.exe -X POST "http://127.0.0.1:9090/tab/new?url=https://example.com"

# Navigate the active tab
curl.exe -X POST "http://127.0.0.1:9090/navigate?window=1" -d "https://news.ycombinator.com"

# Read URL / HTML
curl.exe "http://127.0.0.1:9090/url?window=1"
curl.exe "http://127.0.0.1:9090/content?window=1"

Python의 requests 라이브러리에서도 같은 API를 호출할 수 있다.

python
import requests

BASE = "http://127.0.0.1:9090"

print(requests.get(f"{BASE}/health").json())

r = requests.post(f"{BASE}/tab/new", params={"url": "https://example.com"})
print(r.json()) # {"ok": true, "new_window_id": 1, "new_tab": ...}

html = requests.get(f"{BASE}/content", params={"window": 1}).text
print(html[:200])

빠른 시작 안내와 API 문서에서 자세한 내용을 확인할 수 있다.

원격으로 쓰려면 무엇을 확인해야 하나?

제어 페이지나 settings.json에서 Cloudflare quick 또는 named 터널을 켤 수 있다. 공개 URL을 사용하면 다른 기기에서도 같은 엔드포인트를 호출할 수 있다. 다만 API를 외부에 노출하기 전에 인증을 켜야 한다. 원격 터널에는 선택 사항으로 cloudflared가 필요하며, 안내된 실행 파일은 cloudflared 또는 cloudflared-darwin-arm64다. cloudflared 설치 안내

지원 대상은 Windows 10·11 x64 또는 Apple Silicon arm64 기반 macOS다. 배포 패키지에는 Chromium 및 CEF 실행 파일이 포함된다. 이 저장소는 제품 소스 코드가 아니라 바이너리와 문서만 배포하며, 제품은 독점 소프트웨어다. 제작팀은 서면 허가 없이 역설계·디컴파일·재포장·재배포하지 말라고 명시했다. 제공된 정보는 가격과 인증 기능의 설정 방법, 지원되는 macOS 버전을 밝히지 않는다.