browser-search — three tools, zero cost, and your AI agent learns to search and browse the web

개요

browser-search는 AI 에이전트가 웹 검색 및 브라우징 시 직면하는 제약 사항을 해결하기 위해 개발된 오픈 소스 도구 모음으로, SearXNG, Camofox, CloakBrowser를 통합하여 완전 자동화된 검색 및 브라우징 기능을 제공합니다.

주요 내용

* 개발 배경: 기존 AI 에이전트(OpenCode, Claude Code, Cursor 등)는 코드 생성에는 뛰어나지만 웹 검색 및 브라우징 시 Cloudflare 차단, JavaScript 중심 사이트 로딩 문제, API 비용 등의 제약에 직면하여 browser-search가 개발되었습니다.
* 포함된 도구:
* SearXNG: 수십 개의 검색 엔진을 동시에 쿼리하는 메타 검색 엔진입니다.
* Camofox: REST API를 통해 제공되는 완전한 브라우저로, 항상 준비 상태를 유지하며 브라우징 및 상호작용을 수행합니다.
* CloakBrowser: Cloudflare, Akamai, DataDome 등의 보안 솔루션에 의해 차단되는 사이트를 위한 스텔스 브라우저입니다.
* 작동 방식: AI 에이전트가 상황에 따라 적절한 도구를 자동으로 선택하여 사용하며, 인간의 개입, API 키, 구독료가 전혀 필요 없습니다.
* 주요 특징:
* 스킬(Skill) 기반: 플러그인이 아닌 스킬 형태로 작동하여, 지침을 읽을 수 있는 모든 에이전트와 호환됩니다.
* 자동 탐색 에스컬레이션: Camofox가 차단될 경우 자동으로 CloakBrowser로 전환합니다.
* 심층 연구 모드: 표면적인 답변을 넘어 출처를 교차 검증하고 모든 측면을 다루도록 에이전트에 지시합니다.
* 통합 Readability.js: 깔끔한 기사 추출 기능을 제공하여 토큰 사용량을 약 70% 절감합니다.
* 커스터마이징 가능: SKILL.md 파일은 일반 텍스트로 제공되어 사용자가 자유롭게 수정할 수 있습니다.
* 보안: SSRF 보호, 스크립트 샌드박싱, 속도 제한, 경로 탐색 차단 등 설치 및 사용 시 안전성을 고려하여 설계되었습니다.
* 라이선스: MIT 라이선스로 GitHub에서 사용 가능합니다.

시사점

browser-search는 AI 에이전트의 웹 접근성을 크게 향상시키고, 비용 및 보안 문제 없이 복잡한 웹 환경에서의 정보 수집 및 상호작용을 자동화할 수 있는 잠재력을 제공합니다.