스프쌤
AI 에이전트

Hycli, 웹사이트를 역공학해 결정론적 CLI와 MCP로 바꾸는 오픈소스

✍ 야금야금⏱ 14분 소요2026-11-01👁
← 목록으로 돌아가기

클릭 한 번에 수천 토큰을 태우며 스크린샷을 분석하던 AI 브라우저 자동화, 왜 매번 캡차에 걸리고 세션이 끊겼을까요?

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: Hycli를 활용한 웹사이트 역공학 CLI 및 MCP 서버 구축

✦ KR 핵심 요약: Hycli는 브라우저 번들과 네트워크 패킷을 분석해 임의의 웹사이트를 결정론적 CLI와 MCP 도구로 변환하는 오픈소스 프로젝트입니다. 무거운 비전 브라우저의 토큰 낭비와 캡차 차단을 우회하며, 로컬 브라우저 세션을 연동하면서도 LLM에는 쿠키를 전달하지 않는 보안 구조를 제공합니다.

🌐 Global Takeaway: Hycli reverse-engineers frontend bundles and live network traffic to transform web interactions into typed CLI commands and MCP tools. By shifting from heavy visual browser agents to deterministic local binaries, it cuts token costs drastically while preventing credential leakage to LLMs.

아래 도표는 기존 비전 브라우저 에이전트와 Hycli의 작동 메커니즘 및 자원 소모 방식을 비교합니다.

기존 AI 브라우저 vs Hycli 결정론적 CLI
기존 Playwright 기반 AI
  • 매 동작마다 스크린샷 및 거대 DOM 전송
  • 회당 수천~수만 토큰 소비로 비용 급증
  • UI 변동 시 클릭 좌표 실패 및 캡차 차단
  • LLM 프롬프트에 민감 세션 쿠키 노출 위험
VS
Hycli 리버스 엔지니어링
  • 프론트엔드 번들 및 네트워크 트래픽 역공학
  • 타입이 정의된 CLI 명령어 및 MCP 도구화
  • 명령어 1회 실행으로 토큰 소비 극소화
  • 로컬 브라우저 세션 직접 사용, 쿠키 노출 제로
스크린샷 반복 전송 방식과 1회 리버싱 후 결정론적 호출 방식의 구조적 차이
Hycli 리버스 엔지니어링 4단계 파이프라인
1. 의도 수신사용자 작업 목표(Intent)와 URL 입력
→
2. 삼중 분석API 문서, JS 번들, 실시간 네트워크 트래픽 조사
→
3. 쓰기 격리 검증준비 단계에서 변형(Mutation) 원천 차단 및 읽기 검증
→
4. 도구 배포타입 명시 CLI 바이너리 및 로컬 MCP 도구 생성
웹사이트 분석부터 쓰기 격리 검증을 거쳐 최종 MCP 서버를 발행하는 순서

1. AI 브라우저 에이전트의 구조적 한계와 비용 위기

최근 1~2년간 LLM(대형 언어 모델)을 기반으로 한 웹 브라우저 에이전트는 자동화의 핵심 트렌드로 떠올랐습니다. Playwright나 Puppeteer 위에 멀티모달 모델을 결합하여, 사람이 웹 서핑을 하듯 페이지를 열고 스크린샷을 찍은 뒤 버튼 위치를 시각적으로 추론해 클릭하는 방식이 대표적입니다. 하지만 실무 자동화 파이프라인에서 이러한 비전 기반 브라우징은 심각한 기술적 병목에 직면해 있습니다.

가장 치명적인 문제는 천문학적인 토큰 소비입니다. 웹페이지의 레이아웃이 바뀔 때마다 고해상도 이미지와 수천 줄에 달하는 DOM 트리를 프롬프트에 주입해야 합니다. 단순한 로그인 후 검색 결과 페이지 하나를 조회하는 작업조차도 수만 토큰을 소모하며, 작업이 여러 단계로 이어지면 단 한 번의 작업 흐름에 수백 원에서 수천 원에 달하는 API 비용이 발생합니다. 또한 지연 시간(Latency)이 길어져 실시간 시스템 연동에는 사실상 사용이 불가능했습니다.

더욱이 불안정성 문제는 비즈니스 적용을 가로막는 결정적 결함입니다. 웹사이트의 사소한 CSS 변경이나 팝업 배너, 반응형 뷰포트 차이로 인해 LLM의 클릭 좌표 연산이 실패하기 일쑤였습니다. 여기에 Cloudflare, Akamai 같은 봇 감지 솔루션과 캡차(CAPTCHA) 시스템이 헤드리스 브라우저의 지문(Fingerprint)을 포착해 접근을 차단하면서 무인 자동화 파이프라인은 신뢰성을 잃었습니다.

1-1. 기존 비전 에이전트와 결정론적 접근의 비교

이러한 문제를 극복하기 위해 등장한 개념이 바로 '웹사이트 역공학을 통한 결정론적(Deterministic) 인터페이스 추출'입니다. 브라우저 화면을 눈으로 보고 클릭하는 대신, 프론트엔드가 백엔드 서버와 주고받는 실제 API 패킷과 내부 스크립트를 역추적하여 명령어 도구(CLI)로 박제하는 방식입니다.

비교 항목 기존 멀티모달 브라우저 에이전트 Hycli 결정론적 CLI/MCP 변환
작동 원리 렌더링된 화면 스크린샷 캡처 및 좌표 추론 프론트엔드 JS 번들 및 네트워크 패킷 분석
토큰 소모량 매 액션마다 수천~수만 토큰 지속 소비 도구 생성 후 실행 시 0~수십 토큰(명령어 호출만 발생)
실행 속도 화면 렌더링 및 LLM 추론 대기로 느림 (수 초~수십 초) 바이너리 레벨의 네이티브 HTTP 호출로 즉각 완료
보안 메커니즘 브라우저 DOM/세션이 LLM 컨텍스트에 노출될 위험 세션 쿠키 로컬 격리, LLM 전송 제로(Zero Cookie Leak)
환경 의존성 브라우저 창 렌더링 및 해상도 필수 헤드리스 터미널 및 백그라운드 데몬 구동 가능

"결정론적 CLI를 한 번 만들어서 쓰는 구조는 기존 Playwright 스타일의 AI 브라우저보다 압도적으로 토큰 효율이 높습니다. 명령어만 실행하면 끝나며, 로그인 세션은 로컬에서 유지하되 AI에게는 쿠키를 전달하지 않습니다."


2. Hycli란 무엇인가: 웹을 CLI와 MCP 도구로 변환하는 도구

Hycli는 오픈소스(Apache-2.0)로 공개된 Rust 기반의 차세대 자동화 도구입니다. 복잡한 웹 서비스의 사용자 인터랙션을 분석하여, 개발자 터미널에서 즉시 실행할 수 있는 바이너리 명령어(CLI)와 Claude Code, Codex 등 최신 AI 에이전트가 호출할 수 있는 Model Context Protocol(MCP) 도구 세트로 변환해 줍니다.

Hycli 보안 및 실행 아키텍처
AI 에이전트 인터페이스 계층Claude Code, Codex 등이 호출하는 순수 JSON-RPC 기반 MCP 도구 규격
로컬 샌드박스 및 세션 프록시쿠키·토큰의 LLM 전달을 막고 로컬 브라우저 인증 상태만 헤더에 대입
결정론적 Rust 실행 엔진역공학된 엔드포인트로 직접 HTTP/네트워크 요청을 수행하는 코어 바이너리
민감 인증 정보와 AI 에이전트 인터페이스를 물리적으로 분리하는 3계층 구조

Hycli의 핵심 차별점은 정적인 스크래핑 라이브러리에 머무르지 않고, AI 워커(AI Workers)를 내장해 웹 애플리케이션의 리버스 엔지니어링 과정을 자동화했다는 점입니다. 사용자가 브라우저에서 수행하던 블로그 초안 작성, 사내 포털 조회, 세무 사이트 데이터 수집 등의 반복 작업을 완전히 규격화된 프로그래밍 인터페이스로 승격시킵니다.

이 프로젝트는 Rust 언어로 작성되어 극단적인 실행 속도와 메모리 안전성을 확보했습니다. 단일 실행 바이너리 형태로 제공되며, 윈도우(Windows), 맥OS(macOS), 리눅스(Linux) 환경을 모두 지원합니다. 또한 로컬 대시보드를 내장하여 엔지니어가 생성된 명령어의 입출력 스키마를 시각적으로 확인하고 권한을 통제할 수 있도록 지원합니다.

2-1. 3중 AI 워커(Three AI Workers)의 정밀 분석 아키텍처

Hycli가 특정 웹사이트를 분석할 때 단일 프롬프트에 의존하지 않고, 세 가지 특화된 분석 파이프라인을 병렬로 가동합니다.

  • 공식 및 비공식 API 문서 검사기: 대상 사이트의 OpenAPI(Swagger) 명세, 네트워크 경로, 서비스 워커 정의를 탐색해 엔드포인트 명세를 파악합니다.
  • 프론트엔드 번들 역공학 엔진: 웹팩(Webpack), 바이트(Vite) 등으로 압축·난독화된 자바스크립트 번들을 디컴파일하여 클라이언트 측 RPC 호출 및 데이터 유효성 검사 로직을 추출합니다.
  • 실시간 네트워크 트래픽 인터셉터: 실제 브라우징 중에 오가는 헤더, 쿠키, 세션 토큰의 생명주기와 페이로드 규격을 추적해 유효한 요청 형식을 복원합니다.

3. 작동 원리와 쓰기 격리 메커니즘

일반적인 웹 매크로 도구들이 가진 위험성은 자동화 설정 도중 계정의 상태를 오염시키거나 의도치 않은 데이터를 삭제·수정할 수 있다는 점입니다. Hycli는 이 문제를 방지하기 위해 '쓰기 격리(Zero Live Mutations)' 아키텍처를 도입했습니다.

도구를 생성하는 준비(Prepare) 단계에서 Hycli는 웹사이트에 대한 상태 변경 요청(POST, PUT, DELETE 등)을 네트워크 레벨에서 완벽히 격리합니다. 분석 엔진은 오직 읽기(GET) 요청만을 실시간 검증에 사용하며, 쓰기 동작은 페이로드의 타입 검증과 인터페이스 스키마 생성까지만 수행합니다.

# 대상 웹사이트 주소와 수행할 작업을 자연어로 지정하여 분석 시작
hycli prepare https://your-website.example --intent "Search posts, save drafts, and publish articles"

위 명령을 실행하면 Hycli는 지정된 URL로 브라우저 컴패니언(Browser-companion)을 활성화하여 사용자의 작업 흐름을 모니터링합니다. 이때 생성되는 CLI 명령어는 철저하게 정적 타입 시스템을 따릅니다. 파라미터의 타입(문자열, 숫자, 불리언 등)이 컴파일 타임에 검증되므로, AI 에이전트가 엉뚱한 값을 인자로 넘겨 시스템 오류를 유발하는 사고를 방지합니다.

이렇게 생성된 명령어는 독립적인 MCP(Model Context Protocol) 엔드포인트로 노출됩니다. LLM은 웹사이트의 복잡한 HTML 구조나 스크린샷 이미지를 전혀 볼 필요 없이, search_posts(query: string)이나 save_draft(title: string, body: string)과 같은 명확한 함수 시그니처만을 전달받아 호출하게 됩니다.


4. 보안과 안티봇 우회: 제로 쿠키 유출 아키텍처

AI 에이전트에게 웹 브라우징을 맡길 때 발생하는 가장 중대한 보안 위협은 '자격 증명 유출(Credential Leakage)'입니다. 브라우저의 전체 세션을 LLM 프롬프트에 노출할 경우, 악의적인 프롬프트 인젝션 공격에 의해 사용자의 로그인 세션 쿠키나 리프레시 토큰이 외부 공격자 서버로 탈취될 수 있습니다.

웹 자동화 솔루션 특성 매트릭스
토큰 효율성 (낮음 → 높음)
비효율적 탐색형
  • 순수 비전 기반 에이전트
  • 화면 녹화 방식 매크로
차세대 최적화 (Hycli)
  • Hycli 역공학 CLI
  • 타입 명시 로컬 MCP 서버
취약한 스크립트형
  • DOM 선택자 하드코딩 크롤러
  • 단순 웹 매크로
전통적 공식 연동
  • 공식 REST API SDK
  • OAuth 통합 솔루션
실행 안정성 (낮음 → 높음)
토큰 효율성과 실행 안정성에 따른 주요 웹 자동화 접근 방식의 포지셔닝

Hycli는 Web2 보안 실무 기법을 적용하여 이 문제를 해결했습니다. 핵심은 '로컬 프록시 격리 모델'입니다. 실제 웹 서버와 통신할 때 필요한 인증 쿠키, CSRF 토큰, 헤더 암호화 키는 사용자 PC 내부의 Hycli 로컬 데몬에만 저장됩니다. 외부 클라우드의 LLM(Anthropic, OpenAI 등)에게는 오직 정제된 데이터의 스키마와 실행 결과 텍스트만 전달됩니다.

또한 안티봇 및 캡차 대응 방식에서도 본질적인 차이를 보입니다. 일반적인 헤드리스 브라우저가 사용하는 자동화 플래그(navigator.webdriver)는 안티봇 시스템에 즉시 적발됩니다. 반면 Hycli는 사용자가 일상적으로 사용하는 실제 브라우저 프로필의 세션 상태를 브라우저 컴패니언을 통해 안전하게 미러링합니다. 즉, 사이트 입장에서는 사용자가 정상적으로 로그인하여 사용하는 브라우저의 요청과 완전히 동일한 TLS 지문 및 세션 헤더로 인식하므로 불필요한 캡차 유발을 회피할 수 있습니다.


5. 실전 활용: CLI 생성부터 MCP 에이전트 연결까지

Hycli로 추출된 결과물은 단순한 스크립트 모음이 아니라, 완전한 로컬 도구 생태계를 형성합니다. 개발자는 터미널 환경에서 직접 셸 스크립트에 파이프라인으로 엮을 수 있고, 최신 AI 코딩 에이전트에 MCP 서버로 등록하여 복잡한 에이전트 워크플로를 구축할 수도 있습니다.

5-1. Claude Code 및 AI 에이전트와의 연동

생성된 도구는 Anthropic의 Claude Code나 Codex 같은 에이전트의 설정 파일에 로컬 MCP 서버로 간단히 등록할 수 있습니다. 이를 통해 에이전트는 웹 브라우저를 띄우지 않고도 터미널 백그라운드에서 강력한 도구 실행 능력을 확보합니다.

다음은 Claude Code 또는 지원 에이전트의 MCP 설정에 Hycli를 등록하는 표준 구성 예시입니다.

{
  "mcpServers": {
    "hycli-workspace": {
      "command": "hycli",
      "args": ["serve", "--site", "your-website.example"]
    }
  }
}

이 설정이 완료되면 AI 에이전트는 다음과 같은 다단계 작업을 브라우저 렌더링 없이 한 번의 세션 내에서 초당 수십 건 수준으로 완수할 수 있습니다.

  1. 블로그 서비스의 임시 저장 목록을 CLI로 즉시 조회
  2. 로컬 마크다운 문서의 본문을 기반으로 새 글 초안을 원격 API로 등록
  3. 생성된 게시글의 고유 ID와 접근 URL을 사용자에게 즉시 반환

웹 대시보드를 열어 직접 조작하는 것보다, 이처럼 AI 에이전트에게 깃허브 저장소 구조와 Hycli CLI 명령어를 결합해 제공했을 때 작업 완결성과 응답 속도가 월등히 향상됩니다.


6. 사용 시 주의사항과 라이선스 경계

Hycli는 혁신적인 도구이지만 실무에 도입하기 전 반드시 고려해야 할 기술적·법적 제약 사항이 존재합니다. 모든 웹사이트가 영구적으로 역공학된 인터페이스를 유지하지는 않기 때문입니다.

  • 프론트엔드 빌드 변경에 따른 인터페이스 파편화: 대상 웹사이트가 프론트엔드 번들을 대대적으로 업데이트하거나 내부 비공개 엔드포인트 URL을 변경할 경우, 기존에 생성된 Hycli 명령어의 호출이 실패할 수 있습니다. 이 경우 hycli prepare 명령을 통해 분석 명세를 재동기화해야 합니다.
  • 서비스 이용약관(ToS) 준수: 웹사이트에 따라 비공식 API 호출이나 자동화된 도구 접근을 명시적으로 금지하는 경우가 있습니다. 특히 쓰기(Write) 작업의 경우 어뷰징 감지 시스템에 의해 계정 제재가 발생할 수 있으므로, 자동화 대상 서비스의 약관과 허용 범위를 사전에 면밀히 검토해야 합니다.
  • 민감 상태 변경 권한의 화이트리스트 관리: 기본적으로 Hycli는 쓰기 작업을 엄격히 분리하지만, 실제 운영 환경에서 결제, 회원 탈퇴, 대량 삭제와 같은 고위험 액션이 AI 에이전트에 의해 무단 실행되지 않도록 로컬 대시보드에서 화이트리스트 기반 승인 정책을 수립해야 합니다.

결론적으로 Hycli는 토큰 낭비와 렌더링 지연으로 한계에 부딪힌 웹 AI 에이전트 시장에서, '결정론적 역공학'이라는 가장 엔지니어링다운 해답을 제시한 도구입니다. 무거운 브라우저 대신 군더더기 없는 타입 인터페이스를 확보함으로써, 웹 자동화의 비용 구조를 근본적으로 혁신하고 있습니다.

자주 묻는 질문

Q. Hycli는 기존 Playwright나 Selenium과 어떻게 다른가요?
A. 기존 브라우저 자동화 도구는 매번 실제 렌더링 화면을 띄우고 DOM 요소를 탐색하거나 스크린샷을 찍어 LLM에 전송합니다. 반면 Hycli는 웹사이트의 프론트엔드 JS와 네트워크 트래픽을 미리 역공학하여 정적 타입이 정의된 CLI와 MCP 도구를 생성합니다. 런타임에는 브라우저 화면 없이 경량 명령어로 직접 통신하므로 토큰 소비가 거의 없고 실행 속도가 매우 빠릅니다.

Q. 로그인 세션 쿠키가 LLM 서버로 유출될 위험은 없나요?
A. 없습니다. Hycli는 '제로 쿠키 유출(Zero Cookie Leaks)' 아키텍처를 따릅니다. 사용자의 실제 브라우저 세션 정보와 쿠키는 사용자 PC의 로컬 데몬 내부에서만 안전하게 보관 및 헤더 주입에 사용되며, 외부 LLM 모델 프롬프트에는 순수한 데이터 스키마와 실행 텍스트 결과만 전달됩니다.

Q. 웹사이트가 업데이트되어 내부 API가 바뀌면 어떻게 되나요?
A. 웹사이트의 프론트엔드 번들이나 API 엔드포인트 규격이 변경되면 기존에 생성된 CLI 명령어가 오류를 반환할 수 있습니다. 이 경우 `hycli prepare` 명령어를 다시 실행하여 변경된 네트워크 스펙과 번들을 재분석하고 도구 규격을 갱신해 주어야 합니다.

원본

https://github.com/Hybirdss/Hycli

https://www.threads.com/@siya_dl/post/DepCbqNGnX-

https://x.com/D_Sekhar_14/status/2119571422163149092

함께 보면 좋은 글

댓글 0개