시작하기

Guida는 WebView2 기반 Windows 브라우저 자동화 시스템입니다. Guida Complete는 일반 데스크톱 앱입니다. Guida Node는 브라우저와 워크스페이스 자동화를 위한 headed 원격 executor입니다. 둘 다 Remote Ops를 노출할 수 있으며, MCP는 로컬 AI 에이전트 통합 표면으로 남습니다.

첫날부터 모든 기능을 이해할 필요는 없습니다. 먼저 달성하려는 목적에 맞는 경로부터 읽어 보세요.

경로 선택

브라우저 작업을 직접 자동화하고 싶다

클릭, 입력, 페이지 이동, 콘텐츠 추출, 직접 작성한 스크립트 실행부터 시작하려는 경우의 경로입니다.

1. Guida 설치
2. 첫 스크립트 실행
3. 페이지를 열고 검사하는 레시피 시도
4. Tools > Developer > Generate Scripting Support Files… 에서 편집기 자동 완성, 언어 가이드, 로컬 LLM용 컨텍스트 파일 생성

AI 에이전트가 감독하에 브라우저를 조작하게 하고 싶다

Claude Code, Claude Desktop 또는 다른 MCP 클라이언트가 승인, 도메인 제어, 감사 로그와 함께 Guida를 조작하게 하려는 경우의 경로입니다.

1. MCP 통합 읽기
2. 워크스페이스를 열어 에이전트가 프로젝트 로컬 스크립트와 설정을 사용할 수 있게 하기
3. 반복 가능한 워크스페이스별 작업이 필요하면 사용자 지정 도구 추가
4. 오픈 소스와 비공개 소스에서 무엇이 로컬에 남고, 무엇이 감사 추적에 기록되며, 어떤 추출 계층이 비공개인지 확인

데이터를 추출하고 저장하고 싶다

추출, 로컬 저장, 외부 시스템으로의 전달이 첫 목적이라면 이 경로에서 시작하세요.

1. 빠른 시작으로 기본 스크립트 사이클 익히기
2. 페이지 데이터를 추출하고 저장하는 레시피 시도
3. g.store, g.queue, g.search, S3 호환 스토리지, MongoDB, PostgreSQL, Elasticsearch는 데이터와 스토리지에서 확인
4. 외부 데이터베이스나 오브젝트 스토리지가 필요하면 데이터베이스 통합 사용

큐와 워커를 사용하고 싶다

많은 URL이나 레코드를 여러 브라우저 탭에서 처리하려는 경우의 경로입니다.

1. 워크스페이스를 열어 Guida가 큐와 저장소 데이터베이스를 만들 수 있게 하기
2. URL을 큐에 넣고 처리하는 레시피 시도
3. 선언적 또는 프로그래밍 방식 워커 풀은 큐 워커에서 확인
4. 병렬 워커 실행 레시피 시도

원격 실행 노드를 사용하고 싶다

다른 컴퓨터에서 headed 브라우저 자동화, 워크스페이스 워커, 큐, Remote Ops를 실행하고 신뢰할 수 있는 사설 채널로 제어하려는 경우의 경로입니다.

1. 원격 실행이 명확히 필요한 경우에만 Guida Node를 설치합니다. 그렇지 않으면 Guida Complete를 설치합니다
2. Guida Complete와 Guida Node 중 무엇을 설치할지는 설치에서 확인합니다
3. 신뢰할 수 있는 채널의 JSON-RPC 제어 평면은 Remote Ops API에서 확인합니다
4. 클라이언트가 라이브 브라우저 탭을 스트리밍하거나 제어해야 하면 Remote View를 사용합니다

로컬 LLM 기능을 사용하고 싶다

스크립트에서 로컬 모델로 분류, 요약, 데이터 추출을 수행하려면 여기서 시작하세요.

1. LLM 설정에서 Ollama 또는 LlamaSharp 설정
2. 로컬 LLM에 묻는 레시피 시도
3. g.llm.promptLocalLlm()과 HTTP 헬퍼는 AI, HTTP 및 도구에서 확인
4. 배치 분류나 추출에서는 LLM 호출과 큐 워커를 함께 사용

보안과 인증 정보를 이해하고 싶다

민감한 워크플로, API 인증 정보, AI 지원 브라우징을 평가하는 경우의 경로입니다.

1. MCP 통합에서 허용된 도메인, 도구 승인, 감사 로그 확인
2. 인증 정보에서 DPAPI 암호화와 MCP 시작 스크립트 제한 읽기
3. 오픈 소스와 비공개 소스에서 공개 인프라와 비공개 제품 계층의 경계 이해
4. PostgreSQL, MongoDB, S3 호환 스토리지, Elasticsearch 연결 정보를 사용한다면 데이터베이스 통합 읽기

자주 하는 첫 작업

작업	시작 위치
Guida 설치	설치
Complete와 Node 선택	설치
첫 스크립트 실행	빠른 시작
워크스페이스 열기	워크스페이스
MCP 클라이언트 연결	MCP 통합
원격 노드 제어	Remote Ops API
인증 정보 안전하게 사용	인증 정보
큐 워커 실행	큐 워커
추출 데이터 저장 또는 검색	데이터와 스토리지
네트워크 트래픽 기록	레시피: 네트워크 트래픽 기록

작동 방식

스크립트는 g.* API를 사용해 브라우저 탭을 제어하고, DOM을 검사하고, 데이터를 저장하고, 큐를 처리하고, 로컬 LLM을 호출하고, 워크스페이스 서비스에 연결합니다. JavaScript와 Janet 메서드는 값을 직접 반환하고 실패하면 예외를 던집니다. Lua는 여러 반환값을 사용합니다.

await g.nav.navigateToUrl("https://example.com");
await g.dom.waitForDomStable();

const html = await g.page.getDom();
g.store.put("pages", "example", { html });

모든 것은 사용자의 컴퓨터에서 실행됩니다. 워크스페이스 데이터는 워크스페이스 폴더에 남고, 애플리케이션 상태는 Windows 사용자 프로필 안에 남습니다. Guida는 계정, 텔레메트리, 클라우드 동기화를 요구하지 않습니다.