Hybirdss/Hycli

Hycli – 모든 웹사이트를 AI 에이전트를 위한 타입 지정 CLI로 변환

개요

• 본인이 소유하거나 로그인한 웹사이트를 검사하여 **타입이 지정된 명령줄 인터페이스(CLI)**와 MCP(Multi-Channel Protocol) 서버를 자동으로 생성하는 네이티브 데스크톱 도구(단일 바이너리)입니다. 이를 통해 AI 어시스턴트가 해당 사이트의 읽기 및 쓰기 기능을 사용할 수 있게 합니다.
• 생성된 CLI를 사용하면 터미널에서 직접 검색, 초안 작성, 편집, 삭제와 같은 작업을 수행할 수 있으며, MCP 서버를 통해 코딩 에이전트(Claude, Cursor, Codex 등)가 JSON 메시지를 통해 동일한 작업을 호출할 수 있습니다.

작동 원리

1. 준비 – hycli prepare <url> --intent "…" 명령은 사이트의 문서, OpenAPI/GraphQL 사양, 정적 JS 번들 및 실제 브라우저 세션에서 캡처된 실시간 네트워크 트래픽을 분석하는 세 개의 내부 "AI 워커"를 실행합니다. 이들은 사용 가능한 엔드포인트와 요청/응답 스키마를 추론하여 타입이 지정된 명령을 설명하는 SiteSpec을 생성합니다.
2. 제로 뮤테이션 안전성 – 준비 과정 중에는 어떠한 쓰기 요청도 전송되지 않습니다. 쓰기 작업은 발견되지만 비활성화된 상태(writes: false)로 유지됩니다. AI가 처음으로 쓰기 작업을 수행하려고 할 때, Hycli는 사이트당 한 번씩 쓰기 권한을 활성화할지 사용자에게 확인합니다(hycli writes <site> allow).
3. 로컬 볼트 – 브라우저 쿠키, 토큰 및 기타 보안 정보는 암호화된 로컬 볼트(OS 키링)로 가져오며 LLM 프롬프트에는 절대 노출되지 않습니다. 명령이 실행되면 Hycli가 로컬에서 보안 정보를 주입하고 로그에서 이를 제거합니다.
4. 실행 – 명령은 직접 실행(hycli <site> search-posts --query "…")하거나 MCP 서버(hycli mcp)를 통해 실행할 수 있습니다. 읽기 작업은 즉시 실행되지만, 쓰기 작업은 사용자가 권한을 부여한 후에만 실행됩니다.
5. 복원력 – 요청이 봇 차단(예: Cloudflare)에 걸리면 Hycli는 스텔스 Chromium 엔진이나 가져온 세션을 사용하는 페이지 내 fetch로 전환하며, 차단을 피하기 위해 트래픽 속도를 제한합니다.

주요 기능

• 타입 지정 CLI: 모든 엔드포인트는 필수 매개변수와 JSON/YAML 스키마를 보여주는 자동 생성 --help가 포함된 하위 명령이 됩니다.
• 다국어 UI: 대시보드와 생성된 문서는 20개 언어로 제공됩니다.
• 크로스 플랫폼: Windows, macOS, Linux용 네이티브 설치 프로그램 제공(최종 사용자를 위한 Rust/Node 런타임 불필요).
• AI 우선 통합: 코딩 에이전트가 호출할 수 있는 MCP 서버를 제공하며, Claude, Cursor, Codex와 같은 에이전트를 위한 간단한 JSON 연결 레시피를 제공합니다.
• 안전 제어: 명시적인 일회성 쓰기 활성화, 자동 재시도 없음, 엄격한 오리진 바운드 쿠키, 준비(쓰기 없음)와 실행의 명확한 분리.
• 로컬 대시보드: http://127.0.0.1:4318에서 발견된 작업과 결과를 확인하고 계정 및 AI 연결을 관리할 수 있습니다.

일반적인 워크플로우 (30초 퀵스타트)

# 1. 사이트 발견 및 수행할 작업 정의
hycli prepare https://example.com --intent "Search posts, save drafts, publish"

# 2. 생성된 명령 검사
hycli describe example.com

# 3. 읽기 작업 즉시 실행
hycli example.com search-posts --query "release notes"

# 4. 생성/편집이 필요할 때 쓰기 권한을 한 번 활성화
hycli writes example.com allow
hycli example.com create-draft --title "Hello" --body "From Hycli"

AI 연결 예시

{
  "mcpServers": {
    "hycli": { "command": "hycli", "args": ["mcp"] }
  }
}

이후 AI 에이전트는 MCP 서버에 hycli_prepare, hycli_run 등을 요청할 수 있습니다.

보안 및 개인정보 보호

• 보안 정보는 로컬 암호화 볼트에 저장되며, LLM에는 기호 식별자만 전송됩니다.
• 모델에 대한 자격 증명 유출이 없으며, 자동 재시도가 없고 엄격한 속도 제한이 적용됩니다.
• 컴패니언 확장을 통한 브라우저 세션 가져오기 옵션이 있으며, 쿠키는 대상 도메인으로만 범위가 지정됩니다.

사용 대상

• 사용자 지정 API 래퍼를 작성하지 않고 기존 SaaS 도구(Notion, GitHub, Slack 등)와 상호 작용해야 하는 자율 에이전트를 구축하는 개발자.
• 웹 UI만 제공하는 사이트에서 개인 워크플로우를 스크립트화하려는 파워 유저.
• 안전한 LLM 기반 웹 자동화를 연구하는 연구자.

시작하기

• v0.1.0 릴리스 페이지에서 적절한 설치 프로그램을 다운로드하세요.
• hycli open을 실행하여 대시보드를 시작하고, LLM 공급자를 연결하고, 브라우저 세션을 가져온 뒤 사이트 준비를 시작하세요.

라이선스 – Apache-2.0, 승인된 사이트에서만 사용해야 한다는 명확한 면책 조항 포함.