Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠
JavaScript ai-agentai-agentsai-toolsbrowser-aibrowser-automationbrowser-extensionchrome-aichrome-devtoolschrome-extensionchrome-extensionsfirefox-addonfirefox-addonsfirefox-extensionfirefox-extensionsgemmagemma4minimaxoffline-aioffline-llmqwen
<!doctype html>
<html lang="ko" dir="ltr" data-theme="dark">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>자주 묻는 질문 — WebBrain</title>
<meta name="description" content="설정, 모델, 결제, 안전 및 브라우저에서 WebBrain이 작동하는 방식에 대한 빠른 답변입니다.">
<link rel="canonical" href="https://webbrain.one/docs/ko/faq/">
<link rel="alternate" hreflang="en" href="https://webbrain.one/docs/faq/">
<link rel="alternate" hreflang="es" href="https://webbrain.one/docs/es/faq/">
<link rel="alternate" hreflang="fr" href="https://webbrain.one/docs/fr/faq/">
<link rel="alternate" hreflang="tr" href="https://webbrain.one/docs/tr/faq/">
<link rel="alternate" hreflang="zh" href="https://webbrain.one/docs/zh/faq/">
<link rel="alternate" hreflang="ru" href="https://webbrain.one/docs/ru/faq/">
<link rel="alternate" hreflang="uk" href="https://webbrain.one/docs/uk/faq/">
<link rel="alternate" hreflang="ar" href="https://webbrain.one/docs/ar/faq/">
<link rel="alternate" hreflang="ja" href="https://webbrain.one/docs/ja/faq/">
<link rel="alternate" hreflang="ko" href="https://webbrain.one/docs/ko/faq/">
<link rel="alternate" hreflang="id" href="https://webbrain.one/docs/id/faq/">
<link rel="alternate" hreflang="th" href="https://webbrain.one/docs/th/faq/">
<link rel="alternate" hreflang="ms" href="https://webbrain.one/docs/ms/faq/">
<link rel="alternate" hreflang="tl" href="https://webbrain.one/docs/tl/faq/">
<link rel="alternate" hreflang="he" href="https://webbrain.one/docs/he/faq/">
<link rel="alternate" hreflang="hi" href="https://webbrain.one/docs/hi/faq/">
<link rel="alternate" hreflang="pt" href="https://webbrain.one/docs/pt/faq/">
<link rel="alternate" hreflang="vi" href="https://webbrain.one/docs/vi/faq/">
<link rel="alternate" hreflang="bn" href="https://webbrain.one/docs/bn/faq/">
<link rel="alternate" hreflang="fa" href="https://webbrain.one/docs/fa/faq/">
<link rel="alternate" hreflang="nl" href="https://webbrain.one/docs/nl/faq/">
<link rel="alternate" hreflang="de" href="https://webbrain.one/docs/de/faq/">
<link rel="alternate" hreflang="x-default" href="https://webbrain.one/docs/faq/">
<meta property="og:type" content="website">
<meta property="og:title" content="자주 묻는 질문 — WebBrain">
<meta property="og:description" content="설정, 모델, 결제, 안전 및 브라우저에서 WebBrain이 작동하는 방식에 대한 빠른 답변입니다.">
<meta property="og:url" content="https://webbrain.one/docs/ko/faq/">
<meta property="og:image" content="https://webbrain.one/og-image.png">
<meta name="twitter:card" content="summary_large_image">
<link rel="icon" href="/favicon.png">
<script>try{document.documentElement.dataset.theme=localStorage.getItem('webbrain-theme')||'dark'}catch(_){}</script>
<link rel="stylesheet" href="/docs/assets/docs.css?v=20261028">
<!-- Site footer styles: start -->
<style>
.wb-footer {
--wb-footer-text: var(--text, var(--ink, #2c1810));
--wb-footer-dim: var(--text-dim, var(--muted, #6b5b47));
--wb-footer-line: var(--border, var(--line, rgba(89, 55, 25, 0.15)));
margin: 0;
padding: 0;
border-top: 1px solid var(--wb-footer-line);
background: var(--wb-footer-bg, none);
color: var(--wb-footer-dim);
font-size: 13px;
line-height: 1.5;
text-align: start;
}
.wb-footer-inner {
width: var(--wb-footer-width, min(calc(100% - 48px), 1100px));
margin: 0 auto;
padding: 26px 0 30px;
display: flex;
flex-direction: column;
gap: 18px;
}
/* Page links start on the brand's left edge; the social icons sit at
the far end of the same row. */
.wb-footer-row { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 14px 32px; }
.wb-footer-brand { display: flex; flex-direction: column; gap: 5px; }
.wb-footer-tagline { margin: 0; color: var(--wb-footer-text); font-size: 15px; font-weight: 700; line-height: 1.4; }
.wb-footer-copy { margin: 0; }
.wb-footer-copy a { color: var(--wb-footer-text); font-weight: 650; text-decoration: none; }
.wb-footer-links { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 18px; }
.wb-footer-social { display: flex; align-items: center; gap: 8px; }
.wb-footer-links a { color: var(--wb-footer-dim); font-weight: 600; text-decoration: none; }
.wb-footer a:hover { color: var(--wb-footer-text); text-decoration: none; }
.wb-footer a:focus-visible { outline: 2px solid currentColor; outline-offset: 3px; border-radius: 4px; }
.wb-footer-icon { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; margin: -4px 0; border-radius: 6px; }
.wb-footer-icon:hover { background: color-mix(in srgb, currentColor 12%, transparent); }
.wb-footer-icon svg { display: block; width: 15px; height: 15px; }
/* Only shown without JavaScript, when the language picker can't run. */
.wb-footer-languages { display: none; flex-wrap: wrap; gap: 6px 12px; width: 100%; direction: ltr; }
.wb-footer-languages span { color: var(--wb-footer-text); font-weight: 700; }
@media (max-width: 860px) {
.wb-footer-inner { width: var(--wb-footer-width, calc(100% - 32px)); }
}
</style>
<!-- Site footer styles: end -->
<!-- Plausible analytics: start -->
<!-- Privacy-friendly analytics by Plausible -->
<script async src="https://157.230.3.9.sslip.io/js/pa-omp0F7DsOXM4sGKR50l7S.js"></script>
<script>
window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};
plausible.init()
</script>
<!-- Plausible analytics: end -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"inLanguage": "ko-KR",
"mainEntity": [
{
"@type": "Question",
"name": "WebBrain은 Claude 브라우저 플러그인의 무료 대안인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예. WebBrain은 비슷한 AI 브라우저 에이전트 기능을 제공합니다 — 페이지 읽기, 데이터 추출, 버튼 클릭, 양식 입력, 다단계 워크플로 자동화. Claude Pro 구독이 필요하고 Anthropic 모델만 지원하는 독점 Claude 플러그인과 달리, WebBrain은 완전 무료이고 오픈소스(GPL-3.0-or-later 라이선스)이며, 머신에서 완전히 실행되는 로컬 모델을 포함해 여러 LLM 프로바이더를 지원합니다."
}
},
{
"@type": "Question",
"name": "WebBrain Compass 구독료는 얼마인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "WebBrain Compass는 현재 기기 프로필당 월 5달러이며, 당분간 Claude Pro보다 훨씬 저렴합니다. 현재 사용량은 공정 사용 정책 안에서 무제한입니다. 일반적인 개인 사용은 괜찮지만, 남용, 자동화된 대량 사용, 재판매, 비정상적으로 높은 사용량은 허용되지 않습니다. 구독은 사용자 계정이 아니라 확장 프로그램이 해당 브라우저 + OS GUID에 대해 생성한 기기 식별자에 연결됩니다. 확장 프로그램 저장소를 초기화하거나, 브라우저 프로필을 삭제하거나, 브라우저를 재설치하거나, 브라우저/OS를 바꾸거나, 기기를 잃어버려 이 식별자가 사라지면 복구하거나 이전할 수 없으며 그 손실에 대해 환불하지 않습니다."
}
},
{
"@type": "Question",
"name": "구독을 관리하거나 취소하려면 어떻게 하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "api.webbrain.one/account에서 결제를 관리하고 이메일로 로그인하세요."
}
},
{
"@type": "Question",
"name": "WebBrain Compass 요금을 이미 결제했는데 확장 프로그램이 다시 결제를 요구합니다. 두 번 결제해야 하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "아니요. 다시 결제하지 마세요. Compass 구독은 확장 프로그램이 생성한 브라우저/기기 식별자에 연결되어 있으므로, 이 식별자가 변경되면(새 브라우저나 기기, 브라우저 재설치, 브라우저 프로필 삭제, 확장 프로그램 저장소 초기화) 확장 프로그램이 기존 구독을 인식하지 못하고 결제를 요구합니다. 셀프서비스 포털 api.webbrain.one/portal에서 기존 구독을 현재 브라우저에 다시 연결하고 안내에 따라 액세스를 복원하세요. 영수증 및 기타 결제 변경은 이메일로 api.webbrain.one/account에 로그인하여 관리하세요."
}
},
{
"@type": "Question",
"name": "암호화된 Cloud Sync는 어떻게 작동하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Cloud Sync는 활성 WebBrain Compass 구독자를 위한 선택 기능입니다. WebBrain 메모리, 프로필 자동 입력 텍스트, 지원되는 제공자 설정(API 키 포함)을 동기화합니다. 채팅 기록, 브라우저 기록, 페이지 스크린샷, 레거시 OAuth 액세스/리프레시 토큰은 동기화하지 않습니다. 브라우저는 업로드 전에 사용자가 선택한 비밀번호로 동기화 볼트를 암호화합니다. WebBrain Compass는 암호화된 볼트만 저장하며, 메모리, 프로필 텍스트, 제공자 설정, API 키를 읽을 수 없고 동기화 비밀번호를 대신 복구해 줄 수도 없습니다. 이메일 필드는 WebBrain Compass 매직 링크 결제/구독 인증용입니다. 계정 비밀번호가 아닙니다. UI에서 Cloud Sync 비밀번호 변경을 안내하면 이는 동기화 암호화 비밀번호를 의미하며 WebBrain 계정 비밀번호가 아닙니다. 동기화 비밀번호를 잊으면 기존의 암호화된 클라우드 볼트를 복호화할 수 없습니다. 클라우드 볼트를 재설정하고 데이터가 아직 로컬에 있는 기기에서 새 암호화 사본을 업로드할 수 있습니다."
}
},
{
"@type": "Question",
"name": "WebBrain은 OpenClaw, Browser-Use 같은 다른 AI 에이전트 프레임워크와 어떻게 비교되나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "서로 다른 범주의 도구입니다. WebBrain은 브라우저 확장입니다 — Chrome이나 Firefox에 설치해 사이드 패널에서 대화하며, 코딩이 필요 없습니다. OpenClaw, Browser-Use 같은 프레임워크는 Python으로 자동 브라우저 파이프라인을 구축하는 개발자용 SDK이며, 보통 헤드리스 브라우저와 CDP를 사용합니다. 한 줄로: WebBrain은 AI 어시스턴트와 함께 일상 브라우징을 하는 용도, 에이전트 프레임워크는 스크래핑 봇과 테스트 자동화를 만드는 용도. 둘을 함께 써도 됩니다 — 서로 보완 관계입니다."
}
},
{
"@type": "Question",
"name": "WebBrain 워크플로를 편집할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예. WebBrain 워크플로 편집기를 사용하여 브라우저에서 워크플로 JSON 파일을 검토, 편집, 검증 및 내보낼 수 있습니다."
}
},
{
"@type": "Question",
"name": "WebBrain을 완전히 오프라인에서 사용할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예. WebBrain의 기본 프로바이더는 llama.cpp이며, 컴퓨터에서 로컬 AI 모델을 실행합니다. API 키도 필요 없고, AI에 인터넷도 필요 없으며, 데이터가 머신을 떠나지 않습니다. GGUF 모델을 받고 llama-server를 실행하면, 완전히 비공개인 AI 브라우저 에이전트가 됩니다. OpenAI 호환 엔드포인트가 있는 Ollama도 사용할 수 있습니다."
}
},
{
"@type": "Question",
"name": "비상 박스란 무엇이며 오프라인 RAG는 어떻게 작동하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "비상 박스는 WebBrain이 다운로드하여 로컬로 색인할 수 있는 퍼블릭 도메인 현장 참조 문서(약 570건, 의료·생존·교육·소통 분야)를 엄선한 모음입니다. 설치 후에는 인터넷 연결 없이 오프라인으로 사실 관계 질문을 하고 이 문서들에 근거한 답변을 받을 수 있습니다. 내부적으로 WebBrain은 비상 박스와 설치된 Wikipedia 아카이브에 대한 빠른 키워드 검색에 SQLite FTS5를 사용하며, 로컬에 다운로드한 다국어 E5 모델(약 140MB)을 이용한 선택적 시맨틱 검색 레이어를 제공합니다. 두 방식의 결과는 결합되고 다양화되며, 모든 답변은 정확한 출처 구절을 인용합니다. 인용은 표시 전에 문서 무결성을 검증하는 로컬 리더에서 열리며, 실시간 웹 페이지로 이동하지 않습니다. 더 넓은 오프라인 지식 베이스를 위해 아포칼립스 모드에서 Wikipedia 아카이브를 설치할 수도 있습니다. 출처 및 언어 필터로 검색할 컬렉션을 제어할 수 있습니다."
}
},
{
"@type": "Question",
"name": "WebBrain은 어떤 AI 모델을 지원하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "WebBrain은 네 가지 프로바이더 유형을 지원합니다: llama.cpp (모든 로컬 GGUF 모델), OpenAI (GPT-4o, GPT-4 등), Claude (네이티브 API를 통한 Claude Opus, Sonnet, Haiku), 그리고 OpenRouter (여러 프로바이더의 100개 이상 모델 접근). OpenAI 호환 API 엔드포인트는 무엇이든 작동하므로, Together AI, Groq, Mistral 같은 서비스나 OpenAI 호환 인터페이스를 가진 로컬 서버도 사용할 수 있습니다."
}
},
{
"@type": "Question",
"name": "가장 추천하는 모델은 무엇인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "2026년 4월 21일 기준 최상위 추천은 Qwen 3.6 35B입니다. 이유: 자체 비전 벤치마크(vision-model-shootout)에서 스크린샷 이해 성능이 Gemma 4를 능가했고, 동시에 로컬 추론에도 실용적이었습니다. 컨슈머 GPU에서는 RTX 5090이 이상적이며, RTX 4090도 Intel/Qwen3.6-35B-A3B-int4-AutoRound의 INT4 AutoRound 양자화로 충분히 돌릴 수 있는 경우가 많습니다. 최대 속도를 원한다면 vLLM으로 서빙하는 것을 추천합니다. 명령어 예시: python -u -m vllm.entrypoints.openai.api_server --model Intel/Qwen3.6-35B-A3B-int4-AutoRound --served-model-name qwen3.6-35b --quantization auto --dtype bfloat16 --max-model-len 65536 --max-num-batched-tokens 32768 --max-num-seqs 4 --host 0.0.0.0 --port 8000 --gpu-memory-utilization 0.92 --enable-prefix-caching --enable-chunked-prefill --limit-mm-per-prompt '{\"image\": 4, \"video\": 1}' --mm-processor-cache-type shm --reasoning-parser qwen3 --enable-auto-tool-choice --tool-call-parser qwen3_coder --trust-remote-code --allowed-origins '[\"*\"]' --speculative-config '{\"method\": \"dflash\", \"model\": \"z-lab/Qwen3.6-35B-A3B-DFlash\", \"num_speculative_tokens\": 15}' --attention-backend flash_attn DFlash speculative decoding은 선택 사항입니다."
}
},
{
"@type": "Question",
"name": "WebGPU가 아포칼립스 모드에서만 제공되는 이유는 무엇인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "브라우저 내 WebGPU 텍스트 추론이 아직 대부분의 사용자에게 충분히 좋은 수준이라고 보지 않으며, 좋지 않은 경험을 감수하게 하고 싶지 않기 때문입니다. 같은 LFM2.5 2.6B 모델을 로컬에서 사용하려면 컴퓨터에서 llama.cpp 또는 Ollama로 추론을 실행하고, WebGPU에 의존하는 대신 WebBrain을 해당 로컬 엔드포인트에 연결하세요. WebGPU 비전 폴백은 모델이 훨씬 작고 가끔만 사용되므로 계속 제공됩니다."
}
},
{
"@type": "Question",
"name": "네트워크의 로컬 LLM 서버(vLLM, Ollama, llama.cpp)에 연결할 때 \"Failed to fetch\"가 나타납니다",
"acceptedAnswer": {
"@type": "Answer",
"text": "LLM 서버가 로컬 네트워크의 다른 머신(예: http://192.168.1.x:8000)에 있으면, 서버가 CORS 헤더를 보내지 않는 한 Chrome이 요청을 차단합니다. 해결책은 서버에 따라 다릅니다: vLLM: --allowed-origins '[\"*\"]'로 시작하세요 (값은 반드시 JSON 리스트). Ollama: 시작 전에 환경 변수 OLLAMA_ORIGINS=*를 설정하세요. llama.cpp: CORS가 기본으로 활성화되어 있어 — 변경할 필요가 없습니다. 서버가 localhost(브라우저와 같은 머신)에서 실행 중이면 보통 CORS가 필요 없습니다. 이 문제는 로컬 네트워크의 머신 간 연결에만 영향을 미칩니다. WebBrain 설정의 base URL이 /v1로 끝나는지(예: http://192.168.1.47:8000/v1) 확인하세요. 예외: 브라우저 확장 프로그램에서 Ollama를 사용할 때는 여전히 OLLAMA_ORIGINS가 필요할 수 있습니다. 아래 Ollama FAQ를 참고하세요."
}
},
{
"@type": "Question",
"name": "localhost의 Ollama가 WebBrain 확장 프로그램에서 403을 반환하는 이유는 무엇인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "최근 Ollama 버전은 Ollama가 같은 컴퓨터에서 실행 중이어도 브라우저 확장 프로그램 origin의 요청을 거부할 수 있습니다. 확장 프로그램은 chrome-extension://... 또는 moz-extension://... 같은 Origin을 보내며, 이 origin이 허용되지 않으면 Ollama가 403으로 응답할 수 있습니다. 이미 포트 11434를 잡고 있는 Ollama 데스크톱 앱을 종료한 뒤, 다음 명령 중 하나로 Ollama를 시작하세요. OLLAMA_ORIGINS=\"*\" ollama serve OLLAMA_ORIGINS=\"chrome-extension://*,moz-extension://*\" ollama serve WebBrain의 Ollama 기본 URL은 http://localhost:11434/v1로 유지하세요. 터미널의 curl 확인은 브라우저 확장 프로그램 origin을 보내지 않기 때문에 이 설정 없이도 성공할 수 있습니다."
}
},
{
"@type": "Question",
"name": "WebBrain이 Firefox에서 작동하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예. WebBrain은 Chrome 버전(Manifest V3, sidePanel API 사용)과 Firefox 버전(Manifest V2, sidebar_action 사용) 모두로 배포됩니다. 두 버전의 기능은 동일합니다. Firefox 버전은 개발용 임시 부가 기능으로 로드하거나, 영구 설치를 위해 addons.mozilla.org에 게시할 수 있습니다."
}
},
{
"@type": "Question",
"name": "Chrome의 사이드 패널처럼 Firefox 사이드바를 왼쪽에서 오른쪽으로 옮길 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예 — Firefox 사이드바는 기본적으로 왼쪽이지만, 옮길 수 있습니다. 사이드바 헤더의 아무 데서나 오른쪽 클릭한 뒤 「사이드바를 오른쪽으로 이동」을 고르면 됩니다(또는 메뉴 바에서 「보기 → 사이드바 → 사이드바를 오른쪽으로 이동」). 위치는 재시작 후에도 유지됩니다. Chrome의 sidePanel은 기본적으로 오른쪽이고, 패널 자체에서 사용자가 옮길 수는 없습니다."
}
},
{
"@type": "Question",
"name": "Vivaldi Web Panel에서 WebBrain을 사용할 때 제한이 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예. Vivaldi Web Panel은 confirm(), alert(), prompt() 같은 기본 JavaScript 대화상자를 차단합니다. WebBrain의 Ask, Act, Dev 모드 전환은 더 이상 이런 대화상자에 의존하지 않지만, 일부 보조 작업은 아직 의존합니다. 녹화: 당분간 Vivaldi에서는 /record를 사용하지 마세요. 녹화가 실패하면 Vivaldi가 오류 경고를 숨겨 아무 설명도 표시되지 않을 수 있습니다. 설정, 기록, 트레이스, Ollama 핸드오프: 이 페이지들도 기본 대화상자를 사용하지만 WebBrain은 보통 정상 작동하는 일반 탭에서 엽니다. 수동으로 Web Panel에 넣었다면 대화상자에 의존하는 작업을 사용하기 전에 일반 탭에서 여세요."
}
},
{
"@type": "Question",
"name": "WebBrain은 안전한가요? 웹 페이지를 수정할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "WebBrain에는 세 가지 모드가 있습니다. 묻기 모드(기본)는 읽기 전용이며 페이지를 수정하지 못합니다. 실행 모드는 클릭, 입력, 탐색 같은 브라우저 동작을 허용하고, Dev 모드는 페이지 디버깅 도구를 추가합니다. 결과를 초래하는 동작은 기본적으로 승인이 필요하며, 이 권한 게이트를 끄면 WebBrain이 눈에 띄는 경고 배너를 표시합니다. 정지 버튼으로 언제든지 에이전트를 멈출 수 있습니다. 확장의 소스 코드는 GitHub에 완전히 공개되어 감사가 가능합니다."
}
},
{
"@type": "Question",
"name": "「WebBrain started debugging this browser」 배너는 무엇인가요? WebBrain은 왜 CDP를 사용하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "페이지에서 안정적으로 작업하기 위해 WebBrain은 표준 확장 API인 chrome.debugger를 통해 Chrome DevTools Protocol(CDP)을 사용합니다. 이것이 Chrome의 「WebBrain started debugging this browser」 배너가 나타나는 이유입니다. CDP는 에이전트가 최신 사이트가 실제로 받아들이는 신뢰된 입력 이벤트로 클릭하고 입력할 수 있게 해 줍니다. content script에서 발생시킨 합성 이벤트는 많은 사이트, Web Components, 프레임워크가 제어하는 입력란에서 거부됩니다. 또한 WebBrain은 이를 통해 비전 폴백용 픽셀 단위 스크린샷을 캡처하고 content script가 볼 수 없는 교차 출처 iframe과 shadow DOM에 접근합니다. 읽기 전용 묻기 모드는 CDP가 필요 없습니다 — 페이지와 접근성 트리 읽기는 일반 content script를 거칩니다. CDP가 필요한 것은 실행 모드의 안정성과 교차 출처 작업이며, Manifest V3 확장에는 신뢰된 입력을 위한 디버거 없는 API가 없습니다. WebBrain은 작업이 필요할 때만 탭별로 디버거를 연결하며, 확장 전체가 오픈 소스라서 세션이 정확히 무엇을 하는지 감사할 수 있습니다. CDP는 강력하므로 그 영향 범위를 억제해야 할 대상으로 다루고(필요할 때만 연결하고 읽기에는 사용하지 않음), 이를 더 강화하는 것이 보안 로드맵에 포함되어 있습니다."
}
},
{
"@type": "Question",
"name": "질문을 너무 많이 합니다. 비활성화할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "이 승인 프롬프트는 사용자의 안전을 위한 것입니다. 신뢰하는 사이트에서도 악의적인 행위자가 LLM 지시를 흉내 내거나 콘텐츠를 삽입해, 사용자가 승인하지 않을 일을 에이전트가 대신 하도록 유도할 수 있습니다. 그래서 WebBrain은 중대한 결과가 따르는 작업 전에 항상 승인을 요청합니다. 그래도 이러한 프롬프트를 거치고 싶지 않다면 사이드 패널에 /dangerously-skip-permissions을 입력하거나 비활성화할 수 있습니다. 사이드 플러그인을 열고 헤더의 톱니바퀴 아이콘을 클릭한 다음 settings.html의 Permissions 탭으로 이동하여 Ask before consequential actions 옵션을 끄세요."
}
},
{
"@type": "Question",
"name": "웹 스크래핑과 데이터 추출에 WebBrain을 어떻게 사용하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "원하는 웹 페이지를 열고 WebBrain 사이드 패널을 연 뒤 자연어로 물어보면 됩니다: \"이 페이지의 모든 제품명과 가격을 추출해 줘\", \"이 페이지의 모든 이메일 주소를 가져와 줘\", 또는 \"이 글을 글머리표로 요약해 줘\". AI 에이전트가 페이지 내용을 읽고, 구조를 이해해, 추출한 데이터를 돌려줍니다. 더 복잡한 스크래핑이라면 실행 모드로 전환하세요. 에이전트가 페이지 사이를 이동하고, 페이지네이션 버튼을 누르고, 여러 페이지에 걸쳐 데이터를 모을 수 있습니다."
}
},
{
"@type": "Question",
"name": "WebBrain은 API를 직접 호출하나요, 아니면 항상 UI로 클릭하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "기본적으로 WebBrain은 무언가를 만들거나, 수정하거나, 삭제하거나, 보내거나, 제출하거나, 게시하거나, 구매하는 모든 동작에 대해 항상 보이는 UI를 거쳐서 수행합니다. 페이지로 이동하고, 양식을 채우고, 버튼을 누르는 — 당신이 하는 방식 그대로 말이죠. 변경 작업을 위해 백그라운드 fetch()로 REST/GraphQL 엔드포인트를 직접 호출하는 것은 거부합니다. 이는 의도된 설계입니다: API 동작은 보이지 않고(무엇을 보내는지 보이지 않습니다), 별도의 인증 토큰이 필요할 때가 많고(설정하지 않았을 수도 있습니다), 보이는 한 번의 오클릭보다 영향 범위가 훨씬 넓습니다. UI-first는 모든 것이 화면 위에, 평소의 브라우저 세션 안에, 그리고 언제든 멈출 수 있는 상태로 있다는 뜻입니다. 데이터를 읽는 경우에는 — README를 가져오고, 이슈를 살펴보고, 사이트 간 가격을 비교하고, 상태 페이지를 확인하는 등 — WebBrain은 fetch_url과 research_url 도구를 통해 백그라운드 HTTP 요청을 자유롭게 사용합니다. 읽기는 행위가 아닙니다. 원격 서비스의 무언가를 바꾸지 않으므로 같은 안전 문제는 적용되지 않습니다. 특정 작업에 한해 API 변경을 허용하고 싶다면, 메시지 맨 앞에 /allow-api를 입력하세요(짧은 작업 설명을 뒤에 붙여도 됩니다). 이 대화 단위의 오버라이드는 UI가 정말로 실패하거나 사용 불가일 때 WebBrain이 API 엔드포인트로 폴백할 수 있게 하되, UI가 동작할 때는 여전히 UI를 우선시합니다. 오버라이드가 활성화된 동안에는 입력 영역 위에 고정 배지가 표시되며, 대화를 초기화하면 해제됩니다."
}
},
{
"@type": "Question",
"name": "LM Studio에서도 사용할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예. WebBrain의 읽기 전용 네트워크 도구 — fetch_url과 research_url — 는 LM Studio의 독립 플러그인으로도 제공되며 webbrain/web-tools에서 받을 수 있습니다. lms clone webbrain/web-tools로 설치하고 LM Studio의 아무 채팅에서나 켜면, 도구 호출이 가능한 모든 모델이 브라우저 확장을 설치하지 않고도 이 두 도구를 호출할 수 있습니다. 순수 Node, 헤드리스 브라우저 없음. 소스: lmstudio-plugin/."
}
},
{
"@type": "Question",
"name": "WebBrain이 내 탭에서 작업하는 동안 위아래로 스크롤해도 되나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "대부분의 경우 가능합니다. 특히 “이 페이지를 요약해 줘” 같은 읽기 전용 요청을 Ask 모드에서 처리할 때는 WebBrain이 작업하는 동안에도 계속 스크롤할 수 있습니다. 언제 피해야 하나요? 자동 스크린샷에는 탭의 현재 뷰포트가 반영됩니다. WebBrain이 Act 또는 Dev 모드에서 보이는 콘텐츠를 적극적으로 살피거나 조작하는 동안 스크롤하면 대상이 이동하거나 모델이 보는 내용이 달라질 수 있습니다. 그 단계가 끝난 뒤 스크롤하세요. 그 외에는 계속 페이지를 사용해도 됩니다."
}
},
{
"@type": "Question",
"name": "WebBrain이 한 페이지에서 작업하는 동안 다른 탭으로 전환할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "예. 27.0.0부터 WebBrain은 전면 접근이 반드시 필요한 경우를 제외하고 Chromium 기반 브라우저와 Firefox 모두에서 포커스를 빼앗지 않습니다. 실행은 시작된 탭에 계속 연결되어 있으므로 다른 탭에서 안전하게 작업할 수 있습니다. 드물게 원래 탭을 전면에 표시해야 하는 단계에서는 WebBrain이 잠시 그 탭에 포커스를 줄 수 있습니다. WebBrain이 작업 중인 같은 탭에서는 클릭하거나 입력하지 마세요."
}
},
{
"@type": "Question",
"name": "프로필 자동 입력은 어떻게 작동하나요? 안전한가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "프로필 자동 입력은 설정 → 메모리에 있는 선택 기능입니다. 짧은 자기소개 — 이름, 업무 이메일, 회사, 저위험 가입용 일회용 비밀번호 — 를 입력하고 켜면, WebBrain이 그 텍스트를 에이전트의 시스템 프롬프트에 덧붙여 매번 묻지 않고도 가입 양식을 채울 수 있게 합니다. 텍스트는 브라우저 로컬 저장소에 평문으로 저장됩니다. WebBrain 프로젝트로는 전송되지 않지만, 설정한 LLM 프로바이더에게는 매 턴 시스템 프롬프트의 일부로 전송됩니다. 기본은 꺼짐입니다. 여기에 중요한 계정(Google, Apple, iCloud, 은행, 회사 SSO, 주 이메일) 비밀번호는 절대로 넣지 마세요. 이런 계정은 2FA를 사용해야 하고, 애초에 에이전트에게 넘길 일이 없어야 합니다. 의도된 사용 사례는 뉴스레터 가입과 무료 체험에서 재사용하는 일회용 비밀번호입니다."
}
},
{
"@type": "Question",
"name": "스크린샷 마스킹 설정을 켜면 개인 데이터가 클라우드 비전 모델에 절대 도달하지 않는다는 것이 보장되나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "아니요 — 노출을 줄여줄 뿐 보장은 아닙니다. 활성화하면(설정 → 고급 → 스크린샷 마스킹, 기본값은 꺼짐) WebBrain은 모든 스크린샷에서 비전 모델로 전송되기 전에 양식 필드와 이메일 주소·전화번호처럼 보이는 텍스트를 픽셀화합니다. 감지는 DOM 휴리스틱을 사용해 전적으로 사용자 기기에서 실행되며, 추가로 전송되는 데이터는 없습니다. 이 기능은 최선을 다하는 방식이며 fail-open입니다. 탐색 직후, PDF 뷰어, 제한된 브라우저 페이지 등에서 감지기가 동작할 수 없는 경우, 작업을 중단하는 대신 스크린샷이 마스킹되지 않은 채로 전송됩니다. DOM 휴리스틱이 볼 수 없는 콘텐츠(캔버스에 그려진 텍스트, 이미지 안의 개인정보, 특이한 위젯 등)도 놓칠 수 있습니다. 그리고 이 설정은 스크린샷만 다루며, 모델로 전송되는 페이지 텍스트는 이것으로 마스킹되지 않습니다. 비전에 대한 완전한 프라이버시가 필요하다면 로컬 모델을 사용하세요. llama.cpp나 Ollama 같은 오프라인 제공자를 사용하면 스크린샷과 페이지 텍스트가 기기를 절대 벗어나지 않으므로 애초에 마스킹할 것이 없습니다 — 프라이버시가 보장되는 유일한 구성입니다. 위의 \"WebBrain을 완전히 오프라인에서 사용할 수 있나요?\"를 참고하세요. 비전을 지원하는 로컬 모델을 돌릴 만한 기기가 없다면? 계획 수립과 도구 호출에는 가벼운 소형 로컬 모델(평범한 CPU/GPU에서도 충분히 가벼운)을 쓰고, 비전 서브콜은 클라우드 제공자에 맡기면서 스크린샷 마스킹을 켜두는 것이 좋은 절충안입니다. 대화와 페이지 텍스트는 여전히 기기 안에 남고, 클라우드 비전으로 나가는 모든 스크린샷은 이미 양식 필드와 감지된 이메일/전화번호가 흐리게 처리된 상태입니다 — 완전한 로컬 비전 모델용 하드웨어 없이도 클라우드 노출을 줄일 수 있습니다. 이 분할 설정은 제공자 → 비전에서 구성하세요(위의 \"WebBrain은 클라우드 LLM 청구를 어떻게 통제하나요?\"도 참고하세요)."
}
},
{
"@type": "Question",
"name": "WebBrain은 쿠키 배너와 페이월을 어떻게 다루나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "쿠키 배너: WebBrain은 일반적인 프레임워크(OneTrust, Cookiebot, Didomi, Quantcast, Google Funding Choices, TrustArc)의 동의 배너를 인식해, 페이지에 대해 추론하기 전에 닫습니다. 우선순위는 명확히 보일 때 「모두 거부」/「필수 외 거부」/「필수만」이며, 그렇지 않다면 「설정 관리」 미로에 빠지는 대신 「모두 수락」으로 폴백합니다. 페이월: WebBrain은 페이월의 존재를 정직하게 보고하고, 실제로 본 부분(헤드라인, 부제, 첫 단락 정도)을 알려 줍니다. 페이월을 우회하려고 시도하지 않습니다 — archive.today, 12ft.io, 쿠키 삭제, JS 비활성화, 리더 모드 트릭 등은 모두 사용하지 않습니다. 전체 기사를 원한다면 구독으로 로그인하거나, 같은 사안에 대한 무료 보도를 찾아 달라고 WebBrain에 부탁하세요."
}
},
{
"@type": "Question",
"name": "WebBrain은 dry-run 모드를 지원하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "7.0.0 기준으로는 아직 아닙니다. dry-run 모드는 이미 로드맵에 올라가 있고 계획되어 있습니다."
}
},
{
"@type": "Question",
"name": "WebBrain은 전체 DOM을 AI 모델에 보내나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "아니요. WebBrain은 기본적으로 원시 HTML이나 원시 DOM 덤프를 보내지 않습니다. 먼저 페이지 URL과 제목, 해당 사이트 안내를 사용하며, 비전 기능이 활성화된 경우 보이는 영역의 스크린샷을 선택적으로 추가합니다. 작업에 페이지 콘텐츠가 필요하면 WebBrain은 축약된 의미 기반 접근성 트리 또는 추출된 텍스트로 필요한 만큼만 읽습니다. 읽기 결과는 적절한 경우 가시성 기준으로 필터링되고, 문자 수 제한과 페이지 나누기가 적용됩니다. 원시 페이지 소스 접근은 Dev 모드에서만 사용할 수 있습니다."
}
},
{
"@type": "Question",
"name": "WebBrain 33.0.0 이상이 GPL 라이선스인 이유는 무엇인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "WebBrain 33.0.0 이상은 Wikipedia ZIM 전문 검색을 위해 GPL 라이선스의 Xapian/libzim WebAssembly 런타임을 브라우저 확장 프로그램에 묶어 통합하므로 GPL-3.0-or-later로 배포됩니다. 확장 프로그램 패키지에는 해당 GPL 고지가 포함되며, 묶인 런타임의 완전한 대응 소스가 각 릴리스와 함께 게시됩니다. 33.0.0 이전 릴리스는 MIT 라이선스를 유지하며, 독립적으로 게시된 하위 프로젝트와 타사 구성 요소는 명시된 라이선스를 유지합니다. 자세한 내용은 라이선스 결정 기록을 참조하세요."
}
},
{
"@type": "Question",
"name": "WebBrain은 클라우드 LLM 청구를 어떻게 통제하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "독립적인 세 가지 레이어가 있습니다: 토큰을 아끼는 스크린샷. 이미지가 머신을 떠나기 전에, WebBrain은 크기를 조정하고(짧은 변에 상한, 가로세로 비율 유지) 턴당 이미지 토큰 예산에 맞을 때까지 JPEG로 반복 압축합니다. GPT-4o에서 입력 토큰 약 1,500개에 해당하는 2000×1200 스크린샷이, 페이지 읽기 작업에서 실질적인 손실 없이 ~300–500 토큰으로 압축됩니다. _fitImageDimensions에 구현되어 있고 예산 계산용 유닛 테스트도 있습니다. 스마트 컨텍스트 트리밍. 대화 기록, 도구 출력, 인라인 DOM 덤프 모두 턴 단위로 상한이 걸리고, 활성 모델의 컨텍스트 윈도우가 가득 차 가면 오래된 것부터 잘립니다. read_page가 소설 분량의 글을 반환했다는 이유로 실행이 조용히 10k 토큰에서 100k 토큰으로 부풀어 오르는 일은 없습니다. 전용 비전 모델. 계획과 도구 호출에는 저렴한 텍스트 모델(예: GPT-4o-mini)을, 스크린샷에만 별도의 비전 지원 모델(예: GPT-4o)을 짝지으면 매 턴마다 멀티모달 모델 가격을 낼 필요가 없습니다. 제공자 → 비전에서 구성하세요. 결과적으로 클라우드 프로바이더와의 긴 세션은 예측 가능한 상태를 유지합니다. 완전한 제어를 원한다면 로컬 llama.cpp를 쓰세요 — 토큰당 비용은 0입니다."
}
},
{
"@type": "Question",
"name": "WebBrain에 기여할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "물론입니다! WebBrain은 GPL-3.0-or-later 라이선스이며 기여를 환영합니다. 이슈, 기능 요청, 기여 가이드는 GitHub 저장소에서 확인하세요."
}
}
]
}
</script>
<style>
[hidden] { display: none !important; }
.visually-hidden {
position: absolute !important;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border: 0;
}
.faq-shell { grid-template-columns: 238px minmax(0, 820px); justify-content: center; }
.faq-language {
position: relative;
display: inline-flex;
align-items: center;
min-width: 142px;
}
.faq-language select {
width: 100%;
height: 36px;
appearance: none;
padding: 0 34px 0 13px;
border: 1px solid var(--line);
border-radius: 999px;
background: var(--panel);
color: var(--muted);
font: inherit;
font-size: 12px;
font-weight: 700;
cursor: pointer;
}
[dir="rtl"] .faq-language select { padding: 0 13px 0 34px; }
.faq-language::after {
content: "⌄";
position: absolute;
inset-inline-end: 13px;
color: var(--faint);
pointer-events: none;
}
.sidebar-link-note {
float: inline-end;
color: var(--faint);
font-family: "SFMono-Regular", Consolas, monospace;
font-size: 10px;
}
.faq-hero { padding-bottom: 30px; }
.faq-search {
position: relative;
display: block;
max-width: 640px;
margin-top: 26px;
}
.faq-search svg {
position: absolute;
inset-inline-start: 18px;
top: 17px;
width: 19px;
height: 19px;
color: var(--signal);
pointer-events: none;
}
.faq-search input {
width: 100%;
height: 54px;
padding: 0 46px;
border: 1px solid var(--line-strong);
border-radius: 14px;
background: linear-gradient(145deg, var(--panel), var(--panel-2));
box-shadow: 0 14px 44px rgba(0, 0, 0, 0.16);
color: var(--ink);
font: inherit;
font-size: 15px;
outline: none;
}
.faq-search input:focus {
border-color: color-mix(in srgb, var(--signal) 65%, var(--line));
box-shadow: 0 0 0 3px var(--signal-soft), 0 18px 54px rgba(0, 0, 0, 0.2);
}
.faq-search input::placeholder { color: var(--faint); }
.faq-search kbd {
position: absolute;
inset-inline-end: 14px;
top: 15px;
color: var(--faint);
pointer-events: none;
}
.faq-empty {
margin: 34px 0;
padding: 18px 20px;
border: 1px dashed var(--line-strong);
border-radius: var(--radius-sm);
color: var(--muted);
text-align: center;
}
.faq-topic { padding: 38px 0 2px; scroll-margin-top: calc(var(--header-h) + 22px); }
.faq-topic + .faq-topic { border-top: 1px solid var(--line); }
.faq-topic-header {
display: flex;
align-items: center;
justify-content: space-between;
gap: 18px;
margin-bottom: 14px;
}
.faq-topic-header h2 { margin: 0; font-size: 25px; }
.faq-topic-header > span {
min-width: 30px;
padding: 3px 9px;
border: 1px solid var(--line);
border-radius: 999px;
color: var(--faint);
font-family: "SFMono-Regular", Consolas, monospace;
font-size: 11px;
text-align: center;
}
.faq-question {
border-top: 1px solid var(--line);
scroll-margin-top: calc(var(--header-h) + 22px);
}
.faq-question:last-child { border-bottom: 1px solid var(--line); }
.faq-question summary {
display: flex;
align-items: center;
justify-content: space-between;
gap: 22px;
min-height: 66px;
padding: 15px 4px;
color: var(--ink);
font-weight: 720;
line-height: 1.4;
list-style: none;
cursor: pointer;
}
.faq-question summary::-webkit-details-marker { display: none; }
.faq-question summary:hover { color: var(--brand-2); }
.faq-question-mark {
position: relative;
width: 22px;
height: 22px;
flex: 0 0 22px;
border: 1px solid var(--line-strong);
border-radius: 50%;
color: var(--signal);
}
.faq-question-mark::before,
.faq-question-mark::after {
content: "";
position: absolute;
left: 5px;
right: 5px;
top: 10px;
height: 1px;
background: currentColor;
}
.faq-question-mark::after { transform: rotate(90deg); transition: transform 0.18s ease; }
.faq-question[open] .faq-question-mark { border-color: var(--signal); background: var(--signal-soft); }
.faq-question[open] .faq-question-mark::after { transform: rotate(0); }
.faq-answer {
padding: 0 44px 20px 4px;
color: var(--muted);
font-size: 15px;
}
[dir="rtl"] .faq-answer { padding: 0 4px 20px 44px; }
.faq-answer p { margin: 0 0 14px; color: var(--muted); }
.faq-answer p:last-child { margin-bottom: 0; }
.faq-answer strong { color: var(--ink); }
.faq-answer ul, .faq-answer ol { padding-inline-start: 22px; }
.faq-answer a { overflow-wrap: anywhere; }
@media (max-width: 1080px) {
.faq-shell { grid-template-columns: 220px minmax(0, 1fr); }
}
@media (max-width: 780px) {
.faq-shell { display: block; }
.faq-language { min-width: 118px; }
.faq-language select { max-width: 118px; }
}
@media (max-width: 560px) {
.faq-language { min-width: 104px; }
.faq-language select { max-width: 104px; }
.faq-search kbd { display: none; }
.faq-search input { padding-inline-end: 18px; }
.faq-topic-header h2 { font-size: 22px; }
.faq-question summary { min-height: 62px; font-size: 15px; }
}
</style>
</head>
<body>
<a class="skip-link" href="#main">본문으로 건너뛰기</a>
<header class="site-header">
<div class="header-inner">
<a class="brand" href="https://webbrain.one/ko/"><img src="/logo-github.png" alt=""><span>WebBrain</span><span class="brand-docs">FAQ</span></a>
<nav class="top-nav" aria-label="문서">
<a href="/docs/">문서</a>
<a href="/blog/">블로그</a>
<a href="https://github.com/webbrain-one/webbrain">GitHub</a>
</nav>
<div class="header-tools">
<label class="faq-language">
<span class="visually-hidden">언어 선택</span>
<select data-faq-language aria-label="언어 선택"><option value="en">English</option><option value="es">Español</option><option value="fr">Français</option><option value="tr">Türkçe</option><option value="zh">中文</option><option value="ru">Русский</option><option value="uk">Українська</option><option value="ar">العربية</option><option value="ja">日本語</option><option value="ko" selected>한국어</option><option value="id">Bahasa Indonesia</option><option value="th">ไทย</option><option value="ms">Bahasa Melayu</option><option value="tl">Filipino</option><option value="he">עברית</option><option value="hi">हिन्दी</option><option value="pt">Português</option><option value="vi">Tiếng Việt</option><option value="bn">বাংলা</option><option value="fa">فارسی</option><option value="nl">Nederlands</option><option value="de">Deutsch</option></select>
</label>
<button class="icon-button" type="button" data-theme-toggle aria-label="라이트 / 다크 테마 전환">☀</button>
<button class="sidebar-toggle" type="button" data-sidebar-toggle aria-expanded="false" aria-label="주제">☰</button>
</div>
</div>
</header>
<div class="docs-shell faq-shell">
<aside class="docs-sidebar" aria-label="주제">
<div class="sidebar-group">
<div class="sidebar-label">주제</div>
<nav><a href="#topic-about">WebBrain 소개</a><a href="#topic-cloud">클라우드 및 결제</a><a href="#topic-models">모델 및 로컬 설정</a><a href="#topic-browsers">브라우저 및 일상적인 사용</a><a href="#topic-safety">안전 및 개인정보 보호</a></nav>
</div>
<div class="sidebar-group">
<div class="sidebar-label">문서</div>
<nav>
<a href="/docs/">문서 <span class="sidebar-link-note">EN</span></a>
<a href="https://discord.gg/cgC325ssfw">Discord의 WebBrain</a>
</nav>
</div>
</aside>
<main class="doc-main" id="main">
<div class="breadcrumb"><a href="/docs/">문서</a> / FAQ</div>
<section class="doc-hero faq-hero">
<div class="eyebrow">FAQ</div>
<h1>자주 묻는 질문</h1>
<p class="lede">설정, 모델, 결제, 안전 및 브라우저에서 WebBrain이 작동하는 방식에 대한 빠른 답변입니다.</p>
<label class="faq-search">
<span class="visually-hidden">질문과 답변 검색…</span>
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"></circle><path d="m16.5 16.5 4 4"></path></svg>
<input type="search" data-faq-search placeholder="질문과 답변 검색…" autocomplete="off" spellcheck="false">
<kbd aria-hidden="true">/</kbd>
</label>
</section>
<p class="faq-empty" data-faq-empty role="status" aria-live="polite" hidden>검색과 일치하는 답변이 없습니다.</p>
<section class="faq-topic" id="topic-about" data-faq-topic>
<header class="faq-topic-header">
<h2>WebBrain 소개</h2>
<span aria-label="7">7</span>
</header>
<details class="faq-question" id="alt-claude" data-faq-item>
<summary><span>WebBrain은 Claude 브라우저 플러그인의 무료 대안인가요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예. WebBrain은 비슷한 AI 브라우저 에이전트 기능을 제공합니다 — 페이지 읽기, 데이터 추출, 버튼 클릭, 양식 입력, 다단계 워크플로 자동화. Claude Pro 구독이 필요하고 Anthropic 모델만 지원하는 독점 Claude 플러그인과 달리, WebBrain은 완전 무료이고 오픈소스(GPL-3.0-or-later 라이선스)이며, 머신에서 완전히 실행되는 로컬 모델을 포함해 여러 LLM 프로바이더를 지원합니다.</p></div>
</details>
<details class="faq-question" id="vs-frameworks" data-faq-item>
<summary><span>WebBrain은 OpenClaw, Browser-Use 같은 다른 AI 에이전트 프레임워크와 어떻게 비교되나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>서로 다른 범주의 도구입니다. WebBrain은 브라우저 확장입니다 — Chrome이나 Firefox에 설치해 사이드 패널에서 대화하며, 코딩이 필요 없습니다. OpenClaw, Browser-Use 같은 프레임워크는 Python으로 자동 브라우저 파이프라인을 구축하는 개발자용 SDK이며, 보통 헤드리스 브라우저와 CDP를 사용합니다. 한 줄로: WebBrain은 AI 어시스턴트와 함께 일상 브라우징을 하는 용도, 에이전트 프레임워크는 스크래핑 봇과 테스트 자동화를 만드는 용도. 둘을 함께 써도 됩니다 — 서로 보완 관계입니다.</p></div>
</details>
<details class="faq-question" id="workflow-editor" data-faq-item>
<summary><span>WebBrain 워크플로를 편집할 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예. <a href="https://www.webbrain.one/workflow-editor">WebBrain 워크플로 편집기</a>를 사용하여 브라우저에서 워크플로 JSON 파일을 검토, 편집, 검증 및 내보낼 수 있습니다.</p></div>
</details>
<details class="faq-question" id="firefox" data-faq-item>
<summary><span>WebBrain이 Firefox에서 작동하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예. WebBrain은 Chrome 버전(Manifest V3, sidePanel API 사용)과 Firefox 버전(Manifest V2, sidebar_action 사용) 모두로 배포됩니다. 두 버전의 기능은 동일합니다. Firefox 버전은 개발용 임시 부가 기능으로 로드하거나, 영구 설치를 위해 addons.mozilla.org에 게시할 수 있습니다.</p></div>
</details>
<details class="faq-question" id="scraping" data-faq-item>
<summary><span>웹 스크래핑과 데이터 추출에 WebBrain을 어떻게 사용하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>원하는 웹 페이지를 열고 WebBrain 사이드 패널을 연 뒤 자연어로 물어보면 됩니다: "이 페이지의 모든 제품명과 가격을 추출해 줘", "이 페이지의 모든 이메일 주소를 가져와 줘", 또는 "이 글을 글머리표로 요약해 줘". AI 에이전트가 페이지 내용을 읽고, 구조를 이해해, 추출한 데이터를 돌려줍니다. 더 복잡한 스크래핑이라면 실행 모드로 전환하세요. 에이전트가 페이지 사이를 이동하고, 페이지네이션 버튼을 누르고, 여러 페이지에 걸쳐 데이터를 모을 수 있습니다.</p></div>
</details>
<details class="faq-question" id="multilingual" data-faq-item>
<summary><span>WebBrain은 dry-run 모드를 지원하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p><strong>7.0.0</strong> 기준으로는 아직 아닙니다. dry-run 모드는 이미 로드맵에 올라가 있고 계획되어 있습니다.</p></div>
</details>
<details class="faq-question" id="contribute" data-faq-item>
<summary><span>WebBrain에 기여할 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>물론입니다! WebBrain은 GPL-3.0-or-later 라이선스이며 기여를 환영합니다. 이슈, 기능 요청, 기여 가이드는 <a href="https://github.com/webbrain-one/webbrain" target="_blank">GitHub 저장소</a>에서 확인하세요.</p></div>
</details>
</section>
<section class="faq-topic" id="topic-cloud" data-faq-topic>
<header class="faq-topic-header">
<h2>클라우드 및 결제</h2>
<span aria-label="5">5</span>
</header>
<details class="faq-question" id="cloud-subscription" data-faq-item>
<summary><span>WebBrain Compass 구독료는 얼마인가요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>WebBrain Compass는 현재 <strong>기기 프로필당 월 5달러</strong>이며, 당분간 Claude Pro보다 훨씬 저렴합니다. 현재 사용량은 공정 사용 정책 안에서 무제한입니다. 일반적인 개인 사용은 괜찮지만, 남용, 자동화된 대량 사용, 재판매, 비정상적으로 높은 사용량은 허용되지 않습니다.</p><p>구독은 사용자 계정이 아니라 확장 프로그램이 해당 브라우저 + OS GUID에 대해 생성한 기기 식별자에 연결됩니다. 확장 프로그램 저장소를 초기화하거나, 브라우저 프로필을 삭제하거나, 브라우저를 재설치하거나, 브라우저/OS를 바꾸거나, 기기를 잃어버려 이 식별자가 사라지면 복구하거나 이전할 수 없으며 그 손실에 대해 환불하지 않습니다.</p></div>
</details>
<details class="faq-question" id="manage-subscription" data-faq-item>
<summary><span>구독을 관리하거나 취소하려면 어떻게 하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p><a href="https://api.webbrain.one/account" target="_blank" rel="noopener">api.webbrain.one/account</a>에서 결제를 관리하고 이메일로 로그인하세요.</p></div>
</details>
<details class="faq-question" id="subscription-unrecognized" data-faq-item>
<summary><span>WebBrain Compass 요금을 이미 결제했는데 확장 프로그램이 다시 결제를 요구합니다. 두 번 결제해야 하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>아니요. 다시 결제하지 마세요. Compass 구독은 확장 프로그램이 생성한 브라우저/기기 식별자에 연결되어 있으므로, 이 식별자가 변경되면(새 브라우저나 기기, 브라우저 재설치, 브라우저 프로필 삭제, 확장 프로그램 저장소 초기화) 확장 프로그램이 기존 구독을 인식하지 못하고 결제를 요구합니다.</p><p>셀프서비스 포털 <a href="https://api.webbrain.one/portal" target="_blank" rel="noopener">api.webbrain.one/portal</a>에서 기존 구독을 현재 브라우저에 다시 연결하고 안내에 따라 액세스를 복원하세요.</p><p>영수증 및 기타 결제 변경은 이메일로 <a href="https://api.webbrain.one/account" target="_blank" rel="noopener">api.webbrain.one/account</a>에 로그인하여 관리하세요.</p></div>
</details>
<details class="faq-question" id="cloud-sync" data-faq-item>
<summary><span>암호화된 Cloud Sync는 어떻게 작동하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>Cloud Sync는 활성 WebBrain Compass 구독자를 위한 선택 기능입니다. WebBrain 메모리, 프로필 자동 입력 텍스트, 지원되는 제공자 설정(API 키 포함)을 동기화합니다. 채팅 기록, 브라우저 기록, 페이지 스크린샷, 레거시 OAuth 액세스/리프레시 토큰은 <strong>동기화하지 않습니다</strong>.</p><p>브라우저는 업로드 전에 사용자가 선택한 비밀번호로 동기화 볼트를 암호화합니다. WebBrain Compass는 암호화된 볼트만 저장하며, 메모리, 프로필 텍스트, 제공자 설정, API 키를 읽을 수 없고 동기화 비밀번호를 대신 복구해 줄 수도 없습니다.</p><p>이메일 필드는 WebBrain Compass 매직 링크 결제/구독 인증용입니다. 계정 비밀번호가 아닙니다. UI에서 Cloud Sync 비밀번호 변경을 안내하면 이는 <strong>동기화 암호화 비밀번호</strong>를 의미하며 WebBrain 계정 비밀번호가 아닙니다.</p><p>동기화 비밀번호를 잊으면 기존의 암호화된 클라우드 볼트를 복호화할 수 없습니다. 클라우드 볼트를 재설정하고 데이터가 아직 로컬에 있는 기기에서 새 암호화 사본을 업로드할 수 있습니다.</p></div>
</details>
<details class="faq-question" id="token-conscious" data-faq-item>
<summary><span>WebBrain은 클라우드 LLM 청구를 어떻게 통제하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>독립적인 세 가지 레이어가 있습니다:</p><p><strong>토큰을 아끼는 스크린샷.</strong> 이미지가 머신을 떠나기 전에, WebBrain은 크기를 조정하고(짧은 변에 상한, 가로세로 비율 유지) 턴당 이미지 토큰 예산에 맞을 때까지 JPEG로 반복 압축합니다. GPT-4o에서 입력 토큰 약 1,500개에 해당하는 2000×1200 스크린샷이, 페이지 읽기 작업에서 실질적인 손실 없이 ~300–500 토큰으로 압축됩니다. <code>_fitImageDimensions</code>에 구현되어 있고 예산 계산용 유닛 테스트도 있습니다.</p><p><strong>스마트 컨텍스트 트리밍.</strong> 대화 기록, 도구 출력, 인라인 DOM 덤프 모두 턴 단위로 상한이 걸리고, 활성 모델의 컨텍스트 윈도우가 가득 차 가면 오래된 것부터 잘립니다. <code>read_page</code>가 소설 분량의 글을 반환했다는 이유로 실행이 조용히 10k 토큰에서 100k 토큰으로 부풀어 오르는 일은 없습니다.</p><p><strong>전용 비전 모델.</strong> 계획과 도구 호출에는 저렴한 텍스트 모델(예: GPT-4o-mini)을, 스크린샷에만 별도의 비전 지원 모델(예: GPT-4o)을 짝지으면 매 턴마다 멀티모달 모델 가격을 낼 필요가 없습니다. <strong>제공자 → 비전</strong>에서 구성하세요.</p><p>결과적으로 클라우드 프로바이더와의 긴 세션은 예측 가능한 상태를 유지합니다. 완전한 제어를 원한다면 로컬 llama.cpp를 쓰세요 — 토큰당 비용은 0입니다.</p></div>
</details>
</section>
<section class="faq-topic" id="topic-models" data-faq-topic>
<header class="faq-topic-header">
<h2>모델 및 로컬 설정</h2>
<span aria-label="8">8</span>
</header>
<details class="faq-question" id="offline" data-faq-item>
<summary><span>WebBrain을 완전히 오프라인에서 사용할 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예. WebBrain의 기본 프로바이더는 llama.cpp이며, 컴퓨터에서 로컬 AI 모델을 실행합니다. API 키도 필요 없고, AI에 인터넷도 필요 없으며, 데이터가 머신을 떠나지 않습니다. GGUF 모델을 받고 llama-server를 실행하면, 완전히 비공개인 AI 브라우저 에이전트가 됩니다. OpenAI 호환 엔드포인트가 있는 Ollama도 사용할 수 있습니다.</p></div>
</details>
<details class="faq-question" id="emergency-box" data-faq-item>
<summary><span>비상 박스란 무엇이며 오프라인 RAG는 어떻게 작동하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>비상 박스는 WebBrain이 다운로드하여 로컬로 색인할 수 있는 퍼블릭 도메인 현장 참조 문서(약 570건, 의료·생존·교육·소통 분야)를 엄선한 모음입니다. 설치 후에는 인터넷 연결 없이 오프라인으로 사실 관계 질문을 하고 이 문서들에 근거한 답변을 받을 수 있습니다.</p><p>내부적으로 WebBrain은 비상 박스와 설치된 Wikipedia 아카이브에 대한 빠른 키워드 검색에 SQLite FTS5를 사용하며, 로컬에 다운로드한 다국어 E5 모델(약 140MB)을 이용한 선택적 시맨틱 검색 레이어를 제공합니다. 두 방식의 결과는 결합되고 다양화되며, 모든 답변은 정확한 출처 구절을 인용합니다. 인용은 표시 전에 문서 무결성을 검증하는 로컬 리더에서 열리며, 실시간 웹 페이지로 이동하지 않습니다.</p><p>더 넓은 오프라인 지식 베이스를 위해 아포칼립스 모드에서 Wikipedia 아카이브를 설치할 수도 있습니다. 출처 및 언어 필터로 검색할 컬렉션을 제어할 수 있습니다.</p></div>
</details>
<details class="faq-question" id="models-supported" data-faq-item>
<summary><span>WebBrain은 어떤 AI 모델을 지원하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>WebBrain은 네 가지 프로바이더 유형을 지원합니다: llama.cpp (모든 로컬 GGUF 모델), OpenAI (GPT-4o, GPT-4 등), Claude (네이티브 API를 통한 Claude Opus, Sonnet, Haiku), 그리고 OpenRouter (여러 프로바이더의 100개 이상 모델 접근). OpenAI 호환 API 엔드포인트는 무엇이든 작동하므로, Together AI, Groq, Mistral 같은 서비스나 OpenAI 호환 인터페이스를 가진 로컬 서버도 사용할 수 있습니다.</p></div>
</details>
<details class="faq-question" id="recommended-model" data-faq-item>
<summary><span>가장 추천하는 모델은 무엇인가요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p><strong>2026년 4월 21일</strong> 기준 최상위 추천은 <a href="https://huggingface.co/Qwen/Qwen3.6-35B-A3B" target="_blank">Qwen 3.6 35B</a>입니다. 이유: 자체 비전 벤치마크(<a href="https://www.webbrain.one/blog/vision-model-shootout" target="_blank">vision-model-shootout</a>)에서 스크린샷 이해 성능이 Gemma 4를 능가했고, 동시에 로컬 추론에도 실용적이었습니다.</p><p>컨슈머 GPU에서는 RTX 5090이 이상적이며, RTX 4090도 <a href="https://huggingface.co/Intel/Qwen3.6-35B-A3B-int4-AutoRound" target="_blank">Intel/Qwen3.6-35B-A3B-int4-AutoRound</a>의 INT4 AutoRound 양자화로 충분히 돌릴 수 있는 경우가 많습니다.</p><p>최대 속도를 원한다면 <strong>vLLM</strong>으로 서빙하는 것을 추천합니다. 명령어 예시:</p><p><code>python -u -m vllm.entrypoints.openai.api_server --model Intel/Qwen3.6-35B-A3B-int4-AutoRound --served-model-name qwen3.6-35b --quantization auto --dtype bfloat16 --max-model-len 65536 --max-num-batched-tokens 32768 --max-num-seqs 4 --host 0.0.0.0 --port 8000 --gpu-memory-utilization 0.92 --enable-prefix-caching --enable-chunked-prefill --limit-mm-per-prompt '{"image": 4, "video": 1}' --mm-processor-cache-type shm --reasoning-parser qwen3 --enable-auto-tool-choice --tool-call-parser qwen3_coder --trust-remote-code --allowed-origins '["*"]' --speculative-config '{"method": "dflash", "model": "z-lab/Qwen3.6-35B-A3B-DFlash", "num_speculative_tokens": 15}' --attention-backend flash_attn</code></p><p><em>DFlash speculative decoding은 선택 사항입니다.</em></p></div>
</details>
<details class="faq-question" id="webgpu-apocalypse" data-faq-item>
<summary><span>WebGPU가 아포칼립스 모드에서만 제공되는 이유는 무엇인가요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>브라우저 내 WebGPU 텍스트 추론이 아직 대부분의 사용자에게 충분히 좋은 수준이라고 보지 않으며, 좋지 않은 경험을 감수하게 하고 싶지 않기 때문입니다. 같은 LFM2.5 2.6B 모델을 로컬에서 사용하려면 컴퓨터에서 <strong>llama.cpp</strong> 또는 <strong>Ollama</strong>로 추론을 실행하고, WebGPU에 의존하는 대신 WebBrain을 해당 로컬 엔드포인트에 연결하세요.</p><p>WebGPU 비전 폴백은 모델이 훨씬 작고 가끔만 사용되므로 계속 제공됩니다.</p></div>
</details>
<details class="faq-question" id="cors" data-faq-item>
<summary><span>네트워크의 로컬 LLM 서버(vLLM, Ollama, llama.cpp)에 연결할 때 "Failed to fetch"가 나타납니다</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>LLM 서버가 로컬 네트워크의 다른 머신(예: <code>http://192.168.1.x:8000</code>)에 있으면, 서버가 <strong>CORS 헤더</strong>를 보내지 않는 한 Chrome이 요청을 차단합니다. 해결책은 서버에 따라 다릅니다:</p><p><strong>vLLM:</strong> <code>--allowed-origins '["*"]'</code>로 시작하세요 (값은 반드시 JSON 리스트).<br><strong>Ollama:</strong> 시작 전에 환경 변수 <code>OLLAMA_ORIGINS=*</code>를 설정하세요.<br><strong>llama.cpp:</strong> CORS가 기본으로 활성화되어 있어 — 변경할 필요가 없습니다.</p><p>서버가 <code>localhost</code>(브라우저와 같은 머신)에서 실행 중이면 보통 CORS가 필요 없습니다. 이 문제는 로컬 네트워크의 머신 간 연결에만 영향을 미칩니다. WebBrain 설정의 base URL이 <code>/v1</code>로 끝나는지(예: <code>http://192.168.1.47:8000/v1</code>) 확인하세요. 예외: 브라우저 확장 프로그램에서 Ollama를 사용할 때는 여전히 <code>OLLAMA_ORIGINS</code>가 필요할 수 있습니다. 아래 Ollama FAQ를 참고하세요.</p></div>
</details>
<details class="faq-question" id="ollama-origins" data-faq-item>
<summary><span>localhost의 Ollama가 WebBrain 확장 프로그램에서 403을 반환하는 이유는 무엇인가요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>최근 Ollama 버전은 Ollama가 같은 컴퓨터에서 실행 중이어도 브라우저 확장 프로그램 origin의 요청을 거부할 수 있습니다. 확장 프로그램은 <code>chrome-extension://...</code> 또는 <code>moz-extension://...</code> 같은 <code>Origin</code>을 보내며, 이 origin이 허용되지 않으면 Ollama가 403으로 응답할 수 있습니다.</p><p>이미 포트 <code>11434</code>를 잡고 있는 Ollama 데스크톱 앱을 종료한 뒤, 다음 명령 중 하나로 Ollama를 시작하세요.</p><p><code>OLLAMA_ORIGINS="*" ollama serve</code><br><code>OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*" ollama serve</code></p><p>WebBrain의 Ollama 기본 URL은 <code>http://localhost:11434/v1</code>로 유지하세요. 터미널의 <code>curl</code> 확인은 브라우저 확장 프로그램 origin을 보내지 않기 때문에 이 설정 없이도 성공할 수 있습니다.</p></div>
</details>
<details class="faq-question" id="lm-studio" data-faq-item>
<summary><span>LM Studio에서도 사용할 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예. WebBrain의 읽기 전용 네트워크 도구 — <code>fetch_url</code>과 <code>research_url</code> — 는 <a href="https://lmstudio.ai" target="_blank">LM Studio</a>의 독립 플러그인으로도 제공되며 <a href="https://lmstudio.ai/webbrain/web-tools" target="_blank">webbrain/web-tools</a>에서 받을 수 있습니다. <code>lms clone webbrain/web-tools</code>로 설치하고 LM Studio의 아무 채팅에서나 켜면, 도구 호출이 가능한 모든 모델이 브라우저 확장을 설치하지 않고도 이 두 도구를 호출할 수 있습니다. 순수 Node, 헤드리스 브라우저 없음. 소스: <a href="https://github.com/webbrain-one/webbrain/tree/main/lmstudio-plugin" target="_blank">lmstudio-plugin/</a>.</p></div>
</details>
</section>
<section class="faq-topic" id="topic-browsers" data-faq-topic>
<header class="faq-topic-header">
<h2>브라우저 및 일상적인 사용</h2>
<span aria-label="5">5</span>
</header>
<details class="faq-question" id="firefox-sidebar-move" data-faq-item>
<summary><span>Chrome의 사이드 패널처럼 Firefox 사이드바를 왼쪽에서 오른쪽으로 옮길 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예 — Firefox 사이드바는 기본적으로 왼쪽이지만, 옮길 수 있습니다. 사이드바 헤더의 아무 데서나 오른쪽 클릭한 뒤 <strong>「사이드바를 오른쪽으로 이동」</strong>을 고르면 됩니다(또는 메뉴 바에서 <strong>「보기 → 사이드바 → 사이드바를 오른쪽으로 이동」</strong>). 위치는 재시작 후에도 유지됩니다. Chrome의 sidePanel은 기본적으로 오른쪽이고, 패널 자체에서 사용자가 옮길 수는 없습니다.</p></div>
</details>
<details class="faq-question" id="vivaldi-dialogs" data-faq-item>
<summary><span>Vivaldi Web Panel에서 WebBrain을 사용할 때 제한이 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예. Vivaldi Web Panel은 <code>confirm()</code>, <code>alert()</code>, <code>prompt()</code> 같은 기본 JavaScript 대화상자를 차단합니다. WebBrain의 Ask, Act, Dev 모드 전환은 더 이상 이런 대화상자에 의존하지 않지만, 일부 보조 작업은 아직 의존합니다.</p><p><strong>녹화:</strong> 당분간 Vivaldi에서는 <code>/record</code>를 사용하지 마세요. 녹화가 실패하면 Vivaldi가 오류 경고를 숨겨 아무 설명도 표시되지 않을 수 있습니다.</p><p><strong>설정, 기록, 트레이스, Ollama 핸드오프:</strong> 이 페이지들도 기본 대화상자를 사용하지만 WebBrain은 보통 정상 작동하는 일반 탭에서 엽니다. 수동으로 Web Panel에 넣었다면 대화상자에 의존하는 작업을 사용하기 전에 일반 탭에서 여세요.</p></div>
</details>
<details class="faq-question" id="scroll-during-run" data-faq-item>
<summary><span>WebBrain이 내 탭에서 작업하는 동안 위아래로 스크롤해도 되나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>대부분의 경우 가능합니다. 특히 “이 페이지를 요약해 줘” 같은 읽기 전용 요청을 <strong>Ask 모드</strong>에서 처리할 때는 WebBrain이 작업하는 동안에도 계속 스크롤할 수 있습니다.</p><p><strong>언제 피해야 하나요?</strong> 자동 스크린샷에는 탭의 현재 뷰포트가 반영됩니다. WebBrain이 <strong>Act 또는 Dev 모드</strong>에서 보이는 콘텐츠를 적극적으로 살피거나 조작하는 동안 스크롤하면 대상이 이동하거나 모델이 보는 내용이 달라질 수 있습니다. 그 단계가 끝난 뒤 스크롤하세요. 그 외에는 계속 페이지를 사용해도 됩니다.</p></div>
</details>
<details class="faq-question" id="tab-switch-during-run" data-faq-item>
<summary><span>WebBrain이 한 페이지에서 작업하는 동안 다른 탭으로 전환할 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>예. <strong>27.0.0</strong>부터 WebBrain은 전면 접근이 반드시 필요한 경우를 제외하고 Chromium 기반 브라우저와 Firefox 모두에서 포커스를 빼앗지 않습니다. 실행은 시작된 탭에 계속 연결되어 있으므로 다른 탭에서 안전하게 작업할 수 있습니다.</p><p>드물게 원래 탭을 전면에 표시해야 하는 단계에서는 WebBrain이 잠시 그 탭에 포커스를 줄 수 있습니다. WebBrain이 작업 중인 같은 탭에서는 클릭하거나 입력하지 마세요.</p></div>
</details>
<details class="faq-question" id="cookies-paywalls" data-faq-item>
<summary><span>WebBrain은 쿠키 배너와 페이월을 어떻게 다루나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p><strong>쿠키 배너:</strong> WebBrain은 일반적인 프레임워크(OneTrust, Cookiebot, Didomi, Quantcast, Google Funding Choices, TrustArc)의 동의 배너를 인식해, 페이지에 대해 추론하기 전에 닫습니다. 우선순위는 명확히 보일 때 「모두 거부」/「필수 외 거부」/「필수만」이며, 그렇지 않다면 「설정 관리」 미로에 빠지는 대신 「모두 수락」으로 폴백합니다.</p><p><strong>페이월:</strong> WebBrain은 페이월의 존재를 정직하게 보고하고, 실제로 본 부분(헤드라인, 부제, 첫 단락 정도)을 알려 줍니다. 페이월을 우회하려고 시도하지 <strong>않습니다</strong> — archive.today, 12ft.io, 쿠키 삭제, JS 비활성화, 리더 모드 트릭 등은 모두 사용하지 않습니다. 전체 기사를 원한다면 구독으로 로그인하거나, 같은 사안에 대한 무료 보도를 찾아 달라고 WebBrain에 부탁하세요.</p></div>
</details>
</section>
<section class="faq-topic" id="topic-safety" data-faq-topic>
<header class="faq-topic-header">
<h2>안전 및 개인정보 보호</h2>
<span aria-label="8">8</span>
</header>
<details class="faq-question" id="safe" data-faq-item>
<summary><span>WebBrain은 안전한가요? 웹 페이지를 수정할 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>WebBrain에는 세 가지 모드가 있습니다. 묻기 모드(기본)는 읽기 전용이며 페이지를 수정하지 못합니다. 실행 모드는 클릭, 입력, 탐색 같은 브라우저 동작을 허용하고, Dev 모드는 페이지 디버깅 도구를 추가합니다. 결과를 초래하는 동작은 기본적으로 승인이 필요하며, 이 권한 게이트를 끄면 WebBrain이 눈에 띄는 경고 배너를 표시합니다. 정지 버튼으로 언제든지 에이전트를 멈출 수 있습니다. 확장의 소스 코드는 GitHub에 완전히 공개되어 감사가 가능합니다.</p></div>
</details>
<details class="faq-question" id="cdp" data-faq-item>
<summary><span>「WebBrain started debugging this browser」 배너는 무엇인가요? WebBrain은 왜 CDP를 사용하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>페이지에서 안정적으로 작업하기 위해 WebBrain은 표준 확장 API인 <code>chrome.debugger</code>를 통해 Chrome DevTools Protocol(CDP)을 사용합니다. 이것이 Chrome의 「WebBrain started debugging this browser」 배너가 나타나는 이유입니다. CDP는 에이전트가 최신 사이트가 실제로 받아들이는 <strong>신뢰된 입력 이벤트</strong>로 클릭하고 입력할 수 있게 해 줍니다. content script에서 발생시킨 합성 이벤트는 많은 사이트, Web Components, 프레임워크가 제어하는 입력란에서 거부됩니다. 또한 WebBrain은 이를 통해 비전 폴백용 픽셀 단위 스크린샷을 캡처하고 content script가 볼 수 없는 <strong>교차 출처 iframe과 shadow DOM</strong>에 접근합니다.</p><p>읽기 전용 <strong>묻기 모드는 CDP가 필요 없습니다</strong> — 페이지와 접근성 트리 읽기는 일반 content script를 거칩니다. CDP가 필요한 것은 <strong>실행 모드</strong>의 안정성과 교차 출처 작업이며, Manifest V3 확장에는 신뢰된 입력을 위한 디버거 없는 API가 없습니다. WebBrain은 <strong>작업이 필요할 때만</strong> 탭별로 디버거를 연결하며, 확장 전체가 오픈 소스라서 세션이 정확히 무엇을 하는지 감사할 수 있습니다. CDP는 강력하므로 그 영향 범위를 억제해야 할 대상으로 다루고(필요할 때만 연결하고 읽기에는 사용하지 않음), 이를 더 강화하는 것이 보안 로드맵에 포함되어 있습니다.</p></div>
</details>
<details class="faq-question" id="disable-approval-questions" data-faq-item>
<summary><span>질문을 너무 많이 합니다. 비활성화할 수 있나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>이 승인 프롬프트는 사용자의 안전을 위한 것입니다. 신뢰하는 사이트에서도 악의적인 행위자가 LLM 지시를 흉내 내거나 콘텐츠를 삽입해, 사용자가 승인하지 않을 일을 에이전트가 대신 하도록 유도할 수 있습니다. 그래서 WebBrain은 중대한 결과가 따르는 작업 전에 항상 승인을 요청합니다. 그래도 이러한 프롬프트를 거치고 싶지 않다면 사이드 패널에 <code>/dangerously-skip-permissions</code>을 입력하거나 비활성화할 수 있습니다. 사이드 플러그인을 열고 헤더의 톱니바퀴 아이콘을 클릭한 다음 <code>settings.html</code>의 <strong>Permissions</strong> 탭으로 이동하여 <strong>Ask before consequential actions</strong> 옵션을 끄세요.</p></div>
</details>
<details class="faq-question" id="api-mutations" data-faq-item>
<summary><span>WebBrain은 API를 직접 호출하나요, 아니면 항상 UI로 클릭하나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>기본적으로 WebBrain은 무언가를 만들거나, 수정하거나, 삭제하거나, 보내거나, 제출하거나, 게시하거나, 구매하는 모든 동작에 대해 <strong>항상 보이는 UI를 거쳐서</strong> 수행합니다. 페이지로 이동하고, 양식을 채우고, 버튼을 누르는 — 당신이 하는 방식 그대로 말이죠. 변경 작업을 위해 백그라운드 <code>fetch()</code>로 REST/GraphQL 엔드포인트를 직접 호출하는 것은 거부합니다. 이는 의도된 설계입니다: API 동작은 보이지 않고(무엇을 보내는지 보이지 않습니다), 별도의 인증 토큰이 필요할 때가 많고(설정하지 않았을 수도 있습니다), 보이는 한 번의 오클릭보다 영향 범위가 훨씬 넓습니다. UI-first는 모든 것이 화면 위에, 평소의 브라우저 세션 안에, 그리고 언제든 멈출 수 있는 상태로 있다는 뜻입니다.</p><p>데이터를 <strong>읽는</strong> 경우에는 — README를 가져오고, 이슈를 살펴보고, 사이트 간 가격을 비교하고, 상태 페이지를 확인하는 등 — WebBrain은 <code>fetch_url</code>과 <code>research_url</code> 도구를 통해 백그라운드 HTTP 요청을 자유롭게 사용합니다. 읽기는 행위가 아닙니다. 원격 서비스의 무언가를 바꾸지 않으므로 같은 안전 문제는 적용되지 않습니다.</p><p>특정 작업에 한해 API 변경을 허용하고 싶다면, 메시지 맨 앞에 <code>/allow-api</code>를 입력하세요(짧은 작업 설명을 뒤에 붙여도 됩니다). 이 대화 단위의 오버라이드는 UI가 정말로 실패하거나 사용 불가일 때 WebBrain이 API 엔드포인트로 폴백할 수 있게 하되, UI가 동작할 때는 여전히 UI를 우선시합니다. 오버라이드가 활성화된 동안에는 입력 영역 위에 고정 배지가 표시되며, 대화를 초기화하면 해제됩니다.</p></div>
</details>
<details class="faq-question" id="profile" data-faq-item>
<summary><span>프로필 자동 입력은 어떻게 작동하나요? 안전한가요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>프로필 자동 입력은 <strong>설정 → 메모리</strong>에 있는 선택 기능입니다. 짧은 자기소개 — 이름, 업무 이메일, 회사, 저위험 가입용 <em>일회용</em> 비밀번호 — 를 입력하고 켜면, WebBrain이 그 텍스트를 에이전트의 시스템 프롬프트에 덧붙여 매번 묻지 않고도 가입 양식을 채울 수 있게 합니다.</p><p>텍스트는 브라우저 로컬 저장소에 <strong>평문</strong>으로 저장됩니다. WebBrain 프로젝트로는 <strong>전송되지 않지만</strong>, 설정한 LLM 프로바이더에게는 매 턴 시스템 프롬프트의 일부로 <strong>전송됩니다</strong>. 기본은 꺼짐입니다.</p><p>여기에 중요한 계정(Google, Apple, iCloud, 은행, 회사 SSO, 주 이메일) 비밀번호는 <strong>절대로 넣지 마세요</strong>. 이런 계정은 2FA를 사용해야 하고, 애초에 에이전트에게 넘길 일이 없어야 합니다. 의도된 사용 사례는 뉴스레터 가입과 무료 체험에서 재사용하는 일회용 비밀번호입니다.</p></div>
</details>
<details class="faq-question" id="screenshot-redaction" data-faq-item>
<summary><span>스크린샷 마스킹 설정을 켜면 개인 데이터가 클라우드 비전 모델에 절대 도달하지 않는다는 것이 보장되나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>아니요 — 노출을 줄여줄 뿐 보장은 아닙니다. 활성화하면(<strong>설정 → 고급 → 스크린샷 마스킹</strong>, 기본값은 꺼짐) WebBrain은 모든 스크린샷에서 비전 모델로 전송되기 <em>전에</em> 양식 필드와 이메일 주소·전화번호처럼 보이는 텍스트를 픽셀화합니다. 감지는 DOM 휴리스틱을 사용해 전적으로 사용자 기기에서 실행되며, 추가로 전송되는 데이터는 없습니다.</p><p><strong>이 기능은 최선을 다하는 방식이며 fail-open입니다.</strong> 탐색 직후, PDF 뷰어, 제한된 브라우저 페이지 등에서 감지기가 동작할 수 없는 경우, 작업을 중단하는 대신 스크린샷이 <em>마스킹되지 않은 채로</em> 전송됩니다. DOM 휴리스틱이 볼 수 없는 콘텐츠(캔버스에 그려진 텍스트, 이미지 안의 개인정보, 특이한 위젯 등)도 놓칠 수 있습니다. 그리고 이 설정은 스크린샷만 다루며, 모델로 전송되는 페이지 <em>텍스트</em>는 이것으로 마스킹되지 않습니다.</p><p><strong>비전에 대한 완전한 프라이버시가 필요하다면 로컬 모델을 사용하세요.</strong> llama.cpp나 Ollama 같은 오프라인 제공자를 사용하면 스크린샷과 페이지 텍스트가 기기를 절대 벗어나지 않으므로 애초에 마스킹할 것이 없습니다 — 프라이버시가 보장되는 유일한 구성입니다. 위의 "WebBrain을 완전히 오프라인에서 사용할 수 있나요?"를 참고하세요.</p><p><strong>비전을 지원하는 로컬 모델을 돌릴 만한 기기가 없다면?</strong> 계획 수립과 도구 호출에는 가벼운 소형 로컬 모델(평범한 CPU/GPU에서도 충분히 가벼운)을 쓰고, 비전 서브콜은 클라우드 제공자에 맡기면서 스크린샷 마스킹을 켜두는 것이 좋은 절충안입니다. 대화와 페이지 텍스트는 여전히 기기 안에 남고, 클라우드 비전으로 나가는 모든 스크린샷은 이미 양식 필드와 감지된 이메일/전화번호가 흐리게 처리된 상태입니다 — 완전한 로컬 비전 모델용 하드웨어 없이도 클라우드 노출을 줄일 수 있습니다. 이 분할 설정은 <strong>제공자 → 비전</strong>에서 구성하세요(위의 "WebBrain은 클라우드 LLM 청구를 어떻게 통제하나요?"도 참고하세요).</p></div>
</details>
<details class="faq-question" id="page-context" data-faq-item>
<summary><span>WebBrain은 전체 DOM을 AI 모델에 보내나요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>아니요. WebBrain은 기본적으로 원시 HTML이나 원시 DOM 덤프를 보내지 않습니다. 먼저 페이지 URL과 제목, 해당 사이트 안내를 사용하며, 비전 기능이 활성화된 경우 보이는 영역의 스크린샷을 선택적으로 추가합니다.</p><p>작업에 페이지 콘텐츠가 필요하면 WebBrain은 축약된 의미 기반 접근성 트리 또는 추출된 텍스트로 필요한 만큼만 읽습니다. 읽기 결과는 적절한 경우 가시성 기준으로 필터링되고, 문자 수 제한과 페이지 나누기가 적용됩니다. 원시 페이지 소스 접근은 Dev 모드에서만 사용할 수 있습니다.</p></div>
</details>
<details class="faq-question" id="offline-licensing" data-faq-item>
<summary><span>WebBrain 33.0.0 이상이 GPL 라이선스인 이유는 무엇인가요?</span><span class="faq-question-mark" aria-hidden="true"></span></summary>
<div class="faq-answer"><p>WebBrain 33.0.0 이상은 Wikipedia ZIM 전문 검색을 위해 GPL 라이선스의 Xapian/libzim WebAssembly 런타임을 브라우저 확장 프로그램에 묶어 통합하므로 GPL-3.0-or-later로 배포됩니다.</p><p>확장 프로그램 패키지에는 해당 GPL 고지가 포함되며, 묶인 런타임의 완전한 대응 소스가 각 릴리스와 함께 게시됩니다. 33.0.0 이전 릴리스는 MIT 라이선스를 유지하며, 독립적으로 게시된 하위 프로젝트와 타사 구성 요소는 명시된 라이선스를 유지합니다. 자세한 내용은 <a href="https://github.com/webbrain-one/webbrain/blob/main/docs/offline-rag-licensing.md" target="_blank">라이선스 결정 기록</a>을 참조하세요.</p></div>
</details>
</section>
</main>
</div>
<!-- Site footer: start -->
<footer class="wb-footer">
<div class="wb-footer-inner">
<div class="wb-footer-brand">
<p class="wb-footer-tagline">웹을 더 똑똑하게 만드는 것이 우리의 미션입니다.</p>
<p class="wb-footer-copy">© 2026 WebBrain. <a href="https://emresokullu.com" target="_blank">Emre Sokullu</a>와 <a href="https://github.com/webbrain-one/webbrain/graphs/contributors" target="_blank">기여자</a>들이 만들었습니다.</p>
</div>
<div class="wb-footer-row">
<div class="wb-footer-links">
<a href="/ko/">브라우저 확장 프로그램</a>
<a href="/companion/ko/">데스크톱 Companion</a>
<a href="/research/">연구</a>
<a href="/docs/">문서</a>
<a href="/docs/ko/faq/">FAQ</a>
<a href="/blog/">블로그</a>
<a href="/privacy">개인정보 처리방침</a>
<a href="https://github.com/webbrain-one/webbrain/issues" target="_blank" rel="noopener">버그 신고</a>
<a href="https://github.com/webbrain-one/webbrain/blob/main/LICENSE" target="_blank" rel="noopener">GPL-3.0 라이선스</a>
<a href="https://pressreleases.online/org/webbrain.one" target="_blank" rel="noopener">프레스</a>
<a href="https://api.webbrain.one/account" target="_blank" rel="noopener">Compass 구독</a>
</div>
<div class="wb-footer-social">
<a href="https://mastoturk.org/@webbrain" target="_blank" rel="me noopener" aria-label="Mastodon의 WebBrain" title="Mastodon의 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M21.327 8.566c0-5.035-3.298-6.511-3.298-6.511C16.366 1.292 13.508.971 12.04.947h-.036c-1.468.024-4.326.345-5.989 1.108 0 0-3.298 1.476-3.298 6.511 0 1.153-.022 2.535.014 4.001.12 4.935.907 9.799 5.478 11.007 2.106.557 3.916.674 5.374.594 2.645-.147 4.128-.943 4.128-.943l-.087-1.918s-1.888.595-4.012.523c-2.104-.072-4.326-.227-4.668-2.809a5.289 5.289 0 0 1-.047-.724s2.066.505 4.686.625c1.603.073 3.107-.094 4.632-.276 2.925-.349 5.474-2.149 5.794-3.793.503-2.591.462-6.287.462-6.287ZM8.545 15.023H6.09V8.996c0-2.534 1.627-3.829 3.424-3.829 1.963 0 2.909 1.268 3.35 2.257.44-.989 1.386-2.257 3.349-2.257 1.797 0 3.424 1.295 3.424 3.829v6.027h-2.454V9.174c0-1.233-.519-1.859-1.557-1.859-1.148 0-1.724.742-1.724 2.207v3.203h-2.454V9.522c0-1.465-.576-2.207-1.724-2.207-1.038 0-1.557.626-1.557 1.859v5.849Z"/></svg></a>
<a href="https://bsky.app/profile/webbrain-one.bsky.social" target="_blank" rel="me noopener" aria-label="Bluesky의 WebBrain" title="Bluesky의 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12 10.8c-1.1-2.1-4-6-6.8-8C2.6.9 1.6 1.3.9 1.6.1 1.9 0 3.1 0 3.8c0 .7.4 5.7.6 6.5.8 2.7 3.7 3.7 5.6 3.4-3.5.6-6.5 2-2.5 6.5 4.3 4.5 5.9-1 6.3-2.8.1-.5.2-.8.3-.8.1 0 .2.3.3.8.4 1.8 2 7.3 6.3 2.8 4-4.5 1-5.9-2.5-6.5 1.9.3 4.8-.7 5.6-3.4.2-.8.6-5.8.6-6.5 0-.7-.1-1.9-.9-2.2-.7-.3-1.7-.6-4.3 1.2-2.8 2-5.7 5.9-6.8 8Z"/></svg></a>
<a href="https://discord.gg/cgC325ssfw" target="_blank" rel="noopener" aria-label="Discord의 WebBrain" title="Discord의 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 16 16" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M13.545 2.907a13.227 13.227 0 0 0-3.257-1.011c.05.069.098.137.142.207a12.471 12.471 0 0 0-3.616 0c.044-.07.093-.138.143-.207A13.207 13.207 0 0 0 3.7 2.907 13.136 13.136 0 0 0 .931 13.362a13.667 13.667 0 0 0 4.022 2.018c.33-.442.623-.907.87-1.396a8.95 8.95 0 0 1-1.37-.652c.114-.083.225-.171.33-.269a9.6 9.6 0 0 0 8.243 0c.108.09.218.18.33.269a8.923 8.923 0 0 1-1.37.652c.248.489.54.954.87 1.396a13.667 13.667 0 0 0 4.022-2.018 13.136 13.136 0 0 0-2.769-10.455zM5.106 11.275c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608zm5.788 0c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608z"/></svg></a>
<a href="https://huggingface.co/webbrain-one" target="_blank" rel="me noopener" aria-label="Hugging Face의 WebBrain" title="Hugging Face의 WebBrain" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12.025 1.13c-5.77 0-10.449 4.647-10.449 10.378 0 1.112.178 2.181.503 3.185.064-.222.203-.444.416-.577a.96.96 0 0 1 .524-.15c.293 0 .584.124.84.284.278.173.48.408.71.694.226.282.458.611.684.951v-.014c.017-.324.106-.622.264-.874s.403-.487.762-.543c.3-.047.596.06.787.203s.31.313.4.467c.15.257.212.468.233.542.01.026.653 1.552 1.657 2.54.616.605 1.01 1.223 1.082 1.912.055.537-.096 1.059-.38 1.572.637.121 1.294.187 1.967.187.657 0 1.298-.063 1.921-.178-.287-.517-.44-1.041-.384-1.581.07-.69.465-1.307 1.081-1.913 1.004-.987 1.647-2.513 1.657-2.539.021-.074.083-.285.233-.542.09-.154.208-.323.4-.467a1.08 1.08 0 0 1 .787-.203c.359.056.604.29.762.543s.247.55.265.874v.015c.225-.34.457-.67.683-.952.23-.286.432-.52.71-.694.257-.16.547-.284.84-.285a.97.97 0 0 1 .524.151c.228.143.373.388.43.625l.006.04a10.3 10.3 0 0 0 .534-3.273c0-5.731-4.678-10.378-10.449-10.378M8.327 6.583a1.5 1.5 0 0 1 .713.174 1.487 1.487 0 0 1 .617 2.013c-.183.343-.762-.214-1.102-.094-.38.134-.532.914-.917.71a1.487 1.487 0 0 1 .69-2.803m7.486 0a1.487 1.487 0 0 1 .689 2.803c-.385.204-.536-.576-.916-.71-.34-.12-.92.437-1.103.094a1.487 1.487 0 0 1 .617-2.013 1.5 1.5 0 0 1 .713-.174m-10.68 1.55a.96.96 0 1 1 0 1.921.96.96 0 0 1 0-1.92m13.838 0a.96.96 0 1 1 0 1.92.96.96 0 0 1 0-1.92M8.489 11.458c.588.01 1.965 1.157 3.572 1.164 1.607-.007 2.984-1.155 3.572-1.164.196-.003.305.12.305.454 0 .886-.424 2.328-1.563 3.202-.22-.756-1.396-1.366-1.63-1.32q-.011.001-.02.006l-.044.026-.01.008-.03.024q-.018.017-.035.036l-.032.04a1 1 0 0 0-.058.09l-.014.025q-.049.088-.11.19a1 1 0 0 1-.083.116 1.2 1.2 0 0 1-.173.18q-.035.029-.075.058a1.3 1.3 0 0 1-.251-.243 1 1 0 0 1-.076-.107c-.124-.193-.177-.363-.337-.444-.034-.016-.104-.008-.2.022q-.094.03-.216.087-.06.028-.125.063l-.13.074q-.067.04-.136.086a3 3 0 0 0-.135.096 3 3 0 0 0-.26.219 2 2 0 0 0-.12.121 2 2 0 0 0-.106.128l-.002.002a2 2 0 0 0-.09.132l-.001.001a1.2 1.2 0 0 0-.105.212q-.013.036-.024.073c-1.139-.875-1.563-2.317-1.563-3.203 0-.334.109-.457.305-.454m.836 10.354c.824-1.19.766-2.082-.365-3.194-1.13-1.112-1.789-2.738-1.789-2.738s-.246-.945-.806-.858-.97 1.499.202 2.362c1.173.864-.233 1.45-.685.64-.45-.812-1.683-2.896-2.322-3.295s-1.089-.175-.938.647 2.822 2.813 2.562 3.244-1.176-.506-1.176-.506-2.866-2.567-3.49-1.898.473 1.23 2.037 2.16c1.564.932 1.686 1.178 1.464 1.53s-3.675-2.511-4-1.297c-.323 1.214 3.524 1.567 3.287 2.405-.238.839-2.71-1.587-3.216-.642-.506.946 3.49 2.056 3.522 2.064 1.29.33 4.568 1.028 5.713-.624m5.349 0c-.824-1.19-.766-2.082.365-3.194 1.13-1.112 1.789-2.738 1.789-2.738s.246-.945.806-.858.97 1.499-.202 2.362c-1.173.864.233 1.45.685.64.451-.812 1.683-2.896 2.322-3.295s1.089-.175.938.647-2.822 2.813-2.562 3.244 1.176-.506 1.176-.506 2.866-2.567 3.49-1.898-.473 1.23-2.037 2.16c-1.564.932-1.686 1.178-1.464 1.53s3.675-2.511 4-1.297c.323 1.214-3.524 1.567-3.287 2.405.238.839 2.71-1.587 3.216-.642.506.946-3.49 2.056-3.522 2.064-1.29.33-4.568 1.028-5.713-.624"/></svg></a>
</div>
</div>
</div>
</footer>
<!-- Site footer: end -->
<script>
(function () {
const root = document.documentElement;
const themeButton = document.querySelector('[data-theme-toggle]');
const sidebarButton = document.querySelector('[data-sidebar-toggle]');
const languageSelect = document.querySelector('[data-faq-language]');
const languageRoutes = Object.freeze({"en":"/docs/faq/","es":"/docs/es/faq/","fr":"/docs/fr/faq/","tr":"/docs/tr/faq/","zh":"/docs/zh/faq/","ru":"/docs/ru/faq/","uk":"/docs/uk/faq/","ar":"/docs/ar/faq/","ja":"/docs/ja/faq/","ko":"/docs/ko/faq/","id":"/docs/id/faq/","th":"/docs/th/faq/","ms":"/docs/ms/faq/","tl":"/docs/tl/faq/","he":"/docs/he/faq/","hi":"/docs/hi/faq/","pt":"/docs/pt/faq/","vi":"/docs/vi/faq/","bn":"/docs/bn/faq/","fa":"/docs/fa/faq/","nl":"/docs/nl/faq/","de":"/docs/de/faq/"});
const searchInput = document.querySelector('[data-faq-search]');
const emptyState = document.querySelector('[data-faq-empty]');
const topics = Array.from(document.querySelectorAll('[data-faq-topic]'));
function setTheme(theme, persist) {
root.dataset.theme = theme;
themeButton.textContent = theme === 'dark' ? '☀' : '☾';
if (persist) try { localStorage.setItem('webbrain-theme', theme); } catch (_) {}
}
setTheme(root.dataset.theme === 'light' ? 'light' : 'dark', false);
themeButton.addEventListener('click', function () {
setTheme(root.dataset.theme === 'light' ? 'dark' : 'light', true);
});
languageSelect.addEventListener('change', function () {
const route = languageRoutes[languageSelect.value];
if (route) window.location.assign(route);
});
sidebarButton.addEventListener('click', function () {
const open = document.body.classList.toggle('sidebar-open');
sidebarButton.setAttribute('aria-expanded', String(open));
});
document.querySelectorAll('.docs-sidebar a').forEach(function (link) {
link.addEventListener('click', function () {
document.body.classList.remove('sidebar-open');
sidebarButton.setAttribute('aria-expanded', 'false');
});
});
function normalize(value) {
return String(value || '').normalize('NFKD').replace(/[\u0300-\u036f]/g, '').toLocaleLowerCase().replace(/\s+/g, ' ').trim();
}
function filterFaq() {
const query = normalize(searchInput.value);
let totalVisible = 0;
topics.forEach(function (topic) {
let topicVisible = 0;
topic.querySelectorAll('[data-faq-item]').forEach(function (item) {
const match = !query || normalize(item.textContent).includes(query);
item.hidden = !match;
if (match) topicVisible += 1;
});
topic.hidden = topicVisible === 0;
const count = topic.querySelector('.faq-topic-header > span');
count.textContent = String(topicVisible);
totalVisible += topicVisible;
});
emptyState.hidden = !query || totalVisible > 0;
}
searchInput.addEventListener('input', filterFaq);
searchInput.addEventListener('keydown', function (event) {
if (event.key === 'Escape' && searchInput.value) {
searchInput.value = '';
filterFaq();
}
});
document.addEventListener('keydown', function (event) {
const target = event.target;
const typing = target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target?.isContentEditable;
if (event.key === '/' && !typing && !event.metaKey && !event.ctrlKey && !event.altKey) {
event.preventDefault();
searchInput.focus();
}
});
function openHashTarget() {
if (!window.location.hash) return;
const target = document.getElementById(decodeURIComponent(window.location.hash.slice(1)));
if (target && target.matches('details')) target.open = true;
}
window.addEventListener('hashchange', openHashTarget);
openHashTarget();
})();
</script>
</body>
</html>