<p align="center">
<img src="https://raw.githubusercontent.com/Hacker-Valley-Media/Interceptor/HEAD/docs/assets/interceptor-logo-square.png" alt="Interceptor logo" width="140">
</p>
<h1 align="center">Interceptor</h1>
<p align="center">
<strong class="text-xl">에이전트에게 브라우저, Mac, 그리고 iPhone을 제공하세요.</strong>
</p>
<p align="center">
AI 에이전트를 위한 브라우저 자동화, 컴퓨터 사용, 및 iPhone 자동화.
</p>
<p align="center">
Claude Code, Codex, Cursor, Gemini CLI, Claude Desktop, OpenClaw, OpenCode, 그리고 셸 명령을 실행할 수 있는 모든 에이전트와 함께 작동합니다.
</p>
<p align="center">
<a href="#get-started"><strong class="text-xl">시작하기</strong></a> ·
<a href="#how-it-compares">비교 방법</a> ·
<a href="#browser-automation">브라우저</a> ·
<a href="#macos-automation">macOS</a> ·
<a href="#windows">Windows</a> ·
<a href="#linux">Linux</a> ·
<a href="#iphone-and-ios-automation">iPhone</a> ·
<a href="#record-and-reuse-workflows">기록 및 재사용 워크플로우</a> ·
<a href="#documentation">문서</a> ·
<a href="https://github.com/Hacker-Valley-Media/Interceptor/discussions">토론</a>
</p>
<p align="center">
<a href="https://github.com/Hacker-Valley-Media/Interceptor/releases/latest"><img src="https://img.shields.io/github/v/release/Hacker-Valley-Media/Interceptor?label=release" alt="Latest release"></a>
<a href="https://chromewebstore.google.com/detail/interceptor/gomcpnagjjlhehnkoobkjgnkbleiooed"><img src="https://img.shields.io/badge/Chrome%20Web%20Store-Add%20to%20Chrome-4285F4?logo=googlechrome&logoColor=white" alt="Chrome Web Store"></a>
<a href="https://github.com/Hacker-Valley-Media/Interceptor/releases"><img src="https://img.shields.io/github/downloads/Hacker-Valley-Media/Interceptor/total?label=downloads" alt="Total downloads"></a>
<a href="https://github.com/Hacker-Valley-Media/Interceptor"><img src="https://img.shields.io/github/stars/Hacker-Valley-Media/Interceptor?style=flat&label=stars" alt="GitHub stars"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-Elastic%202.0-blue" alt="Elastic License 2.0"></a>
</p>
Interceptor는 GitHub 통계를 읽고, Numbers 시트를 채우며, 화면 오버레이를 구축합니다.
30초 분량의 편집된 데모입니다. 터미널은 실제 Interceptor 출력에서 가져온 것입니다.
Interceptor는 AI 에이전트 또는 스크립트를 사용자가 로그인한 브라우저, macOS, Windows 및 Linux의 네이티브 앱(native apps), 그리고 실제 iPhone에 연결합니다. 이는 구조화된 UI 읽기 및 액션과 페이지 트래픽, 리치 에디터, 앱 내부(app internals), 장치 상태(device state) 접근을 결합합니다. 에이전트는 특정 액션 이후에 무슨 일이 일어났는지 검사하고 그 증거를 다음 단계에 사용할 수 있습니다.
| Interceptor로 구축할 수 있는 작업 | 사용 가능한 도구 |
|---|
| 기존 브라우저 세션에서의 리서치 | 페이지 텍스트, 테이블, 링크, 브라우저 검색, 다중 컨텍스트(multiple contexts), 그리고 소스 원장 기반의 리서치 워크플로우. |
| ... | |
셸 명령을 실행할 수 있는 모든 에이전트에서 사용하거나, 내장된 Model Context Protocol (MCP) 서버를 통해 사용할 수 있습니다. Interceptor는 모델 API 키가 필요하지 않습니다. 선택한 에이전트나 모델은 자체 구독 또는 API 비용이 발생할 수 있습니다.
Interceptor가 추가하는 기능
많은 도구들이 이제 에이전트(agent)가 로그인된 Chrome을 사용하도록 허용하며, 여러 도구들은 Mac에서 백그라운드로 작동합니다. Interceptor는 이 두 가지를 모두 수행하며, How it compares에 있는 도구들이 제공하지 않는 기능을 추가합니다:
- 하나의 CLI에서 Safari와 Chromium 지원. 사용자가 이미 사용하는 프로필에서 Chrome, Brave, Edge, 그리고 Safari 페이지를 동일한 명령어로 처리합니다.
- 사용자의 실제 iPhone 지원. 시뮬레이터가 아닌 물리적 iPhone의 앱을 USB, Wi-Fi 또는 Tailscale을 통해 집 밖에서도, 심지어 셀룰러 환경에서도 구동합니다.
- 디버거 없이 페이지 트래픽 읽기. 표준 페이지 API를 통해 fetch, XHR, SSE, WebSocket, Beacon, 그리고 BroadcastChannel 트래픽을 읽습니다. 브라우저에 디버깅 배너가 표시되지 않으며 원격 디버깅 스위치가 필요 없습니다.
- 스크린샷이 아닌 실제 편집기 지원. Google Docs, Slides, Sheets, 그리고 Canva의 시니 그래프(scene graph)를 통해 내용을 읽고 수정하며, 해당 파일들을 저장할 수 있습니다.
- 비밀번호 노출 없이 관리 작업 수행. 웹 로그인,
sudo, macOS 관리자 프롬프트 또는 iPhone 암호로 Vault 비밀 정보를 이름으로 전달합니다. 모델은 절대 실제 값을 볼 수 없습니다.
- 브라우저, Mac, Windows, Linux, 그리고 iPhone 전반에 걸친 단일 도구. 모든 에이전트와 모든 모델에서 작동합니다. 작업은 백그라운드에서 실행되므로 사용자가 컴퓨터를 계속 사용할 수 있습니다. Behavior and exceptions.
시작하기 (Get started)
단일 명령어로 설치 (Install with one command)
macOS (Apple silicon) 및 Linux:
curl -fsSL https://raw.githubusercontent.com/Hacker-Valley-Media/Interceptor/main/scripts/get-interceptor.sh | bash
Windows (PowerShell):
irm https://raw.githubusercontent.com/Hacker-Valley-Media/Interceptor/main/scripts/get-interceptor.ps1 | iex
두 가지 질문을 합니다. 모든 것을 얻으려면 Enter를 누르세요:
- 전체(Full) 모드 또는 브라우저 전용(Browser only)? 전체 모드(기본값)는 사용자의 웹 브라우저, 데스크톱 앱, 그리고 Mac의 iPhone을 포함합니다. 브라우저 전용은 웹 페이지에 한정됩니다.
- MCP 서버 등록? 예(Yes)가 기본값입니다. 이 기능은 아직 서버를 갖추지 못한 AI 앱들(Claude Code, Codex, Cursor, Gemini CLI, Claude Desktop)을 나열하고 모든 도구를 활성화합니다.
이 기능은 updates.hackervalley.media에서 최신 릴리스를 다운로드하고, SHA-256 및 Hacker Valley Media 서명을 확인한 후 설치하며, 별도의 설치 마법사(Installer wizard)가 없습니다. 검사에 실패하면 아무것도 설치되지 않습니다. 이는 컴퓨터의 모든 AI 에이전트에 Interceptor의 기능을 추가합니다. Mac에서는 비밀번호를 한 번 요청합니다. 언제든지 다시 실행하여 업데이트할 수 있으며, 이 경우 사용자의 에디션을 유지하고 기존 MCP 설정을 그대로 둡니다.
옵션은 bash -s -- 뒤에 추가됩니다. 예를 들어, curl -fsSL … | bash -s -- --browser --no-mcp와 같습니다:
| 옵션 | 설명 |
|---|
--full, --browser | 요청받는 대신 에디션을 선택합니다. 전체 모드가 기본값입니다. |
| ... | |
Windows에서는 동일한 매개변수를 전달합니다: & ([scriptblock]::Create((irm <url>))) -Browser -NoMcp.
"모든 도구 활성화(Every tool on)"라는 것은 에이전트가 기본적으로 비활성화된 작업들, 예를 들어 앱 종료, 파일 쓰기, 페이지 내 스크립트 실행 등을 수행할 수 있음을 의미합니다 (INTERCEPTOR_MCP_ALLOW=all,raw). 에이전트는 여전히 이러한 모든 호출을 확인(confirmed)으로 표시합니다. 읽기와 클릭만 할 경우, 나중에 interceptor mcp install을 실행하십시오.
마지막 단계는 브라우저 확장 프로그램입니다. Mac에서는 Interceptor 창이 자동으로 열리면서 사용자를 안내합니다. Windows에서는 Chrome 웹 스토어 페이지가 열립니다.
AI 에이전트가 이 작업을 수행하도록 원하십니까? 동일한 명령을 실행하도록 요청하십시오. 답변할 터미널이 없으면, 이는 기본값(Full 모드 및 모든 도구가 활성화된 MCP 서버)을 따릅니다. Mac의 경우, 사용자가 비밀번호를 입력할 수 있도록 Installer에서 검증된 패키지를 자동으로 엽니다.
각 단계를 직접 실행하는 것을 선호하십니까? Mac의 경우, Apple 자체 도구를 사용한 동일한 설치 과정이 있습니다:
curl -fLo /tmp/Interceptor.pkg https://updates.hackervalley.media/latest/Interceptor-Full.pkg
spctl -a -vv -t install /tmp/Interceptor.pkg && sudo installer -pkg /tmp/Interceptor.pkg -target /
interceptor skills adopt
spctl은 Apple의 게이트키퍼(Gatekeeper) 검사입니다. 이 명령어는 Notarized Developer ID와 HACKER VALLEY MEDIA, LLC (TPWBZD35WW)를 출력하며, 패키지가 서명되고 노타라이즈되지 않은 경우 installer가 실행되지 않습니다. Browser 에디션의 경우 Interceptor-Browser.pkg를 사용하십시오. 모든 도구에 MCP 서버를 등록하려면 interceptor mcp install --allow all,raw를 추가로 실행해야 합니다.
설치 프로그램 다운로드
아래의 각 링크는 항상 최신 릴리스 버전을 제공합니다. 웹 작업을 위해서는 Browser부터 시작하고, 네이티브 앱 및 iPhone 사용을 위해서는 Full 버전을 사용하십시오. 모든 버전은 Releases에서 확인할 수 있으며, 각 파일의 SHA-256 값은 SHA256SUMS-ALL에 나열되어 있습니다. macOS 패키지는 Apple silicon을 위해 빌드되었습니다. Intel Mac의 경우 소스에서 직접 빌드해야 합니다 (자세한 내용은 Development and contributions 참조).
The macOS 릴리스 바이너리는 Apple silicon을 대상으로 합니다. Windows와 Linux의 경우 Full 패키지는 interceptor desktop을 통해 네이티브 앱 제어를 추가합니다. 해당 컴퓨터에서 어떤 기능이 작동하는지 확인하려면 interceptor desktop capabilities를 실행하십시오. iPhone 설정은 Mac이 필요합니다.
macOS 설치
- Browser 또는 Full .pkg를 설치하십시오. 첫 설치 시 Interceptor 창이 열리며, 확장 프로그램이 이미 브라우저에 있는지 확인합니다. 만약 없다면, Chrome Web Store에서 언패키지(unpacked extension) 형태로 추가하는 방법이나 Safari 사용자를 위한 단계별 안내와 함께 과정을 진행합니다. 언제든지
interceptor diagnose extension --welcome 명령을 사용하여 다시 열 수 있습니다.
- 창이 이미 작업을 완료하지 않았다면, Chrome 또는 Brave에서 Interceptor 확장 프로그램을 설치하십시오. 로컬 런타임과 브라우저 확장 프로그램 모두가 필요합니다.
- Safari의 경우, Safari .pkg도 설치하고,
/Applications/InterceptorSafari.app을 한 번 열어주십시오. 그런 다음 **Safari → 설정(Settings) → 확장 프로그램(Extensions)**에서 Interceptor 및 웹사이트 접근 권한을 활성화해야 합니다. Safari는 사용자의 승인이 필요합니다.
- Full 패키지를 사용하는 경우, 작업에 필요한 권한을
interceptor-bridge에 부여하십시오. 안내를 위해 interceptor macos trust --walkthrough를 실행하십시오. 접근성(Accessibility)은 네이티브 UI 제어를 활성화하며, 화면(screen), 마이크(microphone), 앱 자동화(app-automation) 접근 권한은 각각의 기능을 위해 필요합니다.
언패키지 Chrome/Brave 확장 프로그램의 경우, 브라우저의 확장 프로그램 페이지에서 개발자 모드(Developer Mode)를 활성화하고 /Library/Application Support/Interceptor/extension/을 로드하십시오. 프로필당 복사본을 하나만 유지해야 합니다. 스토어 설치와 언패키지 설치는 동일한 확장 프로그램 ID를 공유하며, 스토어 업데이트는 검토 후 도착합니다.
Windows 및 Linux
Windows에서는 설치기를 사용하여 PC(x64 또는 ARM64)용으로 실행하고, 브라우저 확장 프로그램을 설치한 다음 새 터미널을 여십시오. Chrome, Brave, Edge는 Chrome Web Store 목록을 사용할 수 있으며, Edge의 경우 다른 스토어에서 확장 프로그램 허용이 필요합니다. Windows 가이드에는 언패키지 확장 프로그램, 무인 설치(silent installation), 업데이트 및 제거에 대한 내용도 포함되어 있습니다.
Linux에서 사용하려면, 기기(x64 또는 ARM64)에 맞는 아카이브를 추출한 후 해당 디렉토리에서 다음 명령을 실행하십시오:
bash scripts/install.sh --browser-only --brave
./dist/interceptor open "https://example.com"
설치 프로그램의 확장 기능 로딩 지침을 따르십시오. 아카이브에는 컴파일된 바이너리가 포함되어 있으므로 이 릴리스 경로는 별도의 Bun 설치가 필요하지 않습니다.
Linux에서 네이티브 앱 제어(native app control)를 하려면, 원-커맨드 설치 기능이 서명된 체크섬 목록을 확인해 줍니다. 수동으로 진행하려면, SHA256SUMS, SHA256SUMS.cms, verify-release-manifest.sh 및 linux-release-apple-root.pem을 다운로드하고, bash verify-release-manifest.sh <폴더>를 실행하십시오 (이 명령어는 목록에 있는 모든 아카이브를 확인하므로 네 개의 Linux 아카이브를 모두 해당 폴더에 넣어야 합니다). 그런 다음 그래픽 세션에서 bash scripts/install.sh --full을 실행합니다. Windows에서는 브라우저용 대신 전체(Full) 설치 프로그램을 실행하십시오. 데스크톱 가이드에는 각 OS가 지원하는 기능과 OCR, 얼굴 감지 및 개인 데이터 기능을 활성화할 수 있는 선택적 Linux 패키지가 나열되어 있습니다.
첫 번째 브라우저 작업
확장 프로그램이 활성화되고 브라우저가 열린 상태에서:
interceptor open "https://example.com" --group first-task
interceptor read --group first-task
interceptor group close first-task
open은 필요할 때 데몬(daemon)을 시작하고, 백그라운드에서 관리되는 탭을 열며, 페이지의 트리와 텍스트를 반환합니다. Example Domain이 표시되어야 합니다. read는 이를 다시 검사하며, group close는 해당 작업의 탭들을 정리합니다.
여러 브라우저 컨텍스트가 연결된 경우, interceptor contexts를 실행하고 브라우저 명령어에 --context <id>를 추가하세요. Safari의 ID는 safari입니다. interceptor status는 로컬 상태를 보고하지만, 데몬을 스스로 시작하지는 않습니다.
에이전트 연결하기
