Johell1NS/browser-search

解决的问题

browser-search 是一套专为 AI 代理设计的工具，旨在让 AI 代理在不被反机器人保护（如 Cloudflare 或 Akamai）拦截的情况下，实现网页搜索与浏览。通过强制采用确定性的「先搜索，后回答」工作流，要求代理必须基于实时网页源验证事实主张，从而消除模型幻觉。

工作原理

该项目实现了三阶段升级系统用于网页访问：

1. 搜索阶段：使用 SearXNG（自托管元搜索引擎）从多个来源快速获取 URL 和摘要列表。
2. 标准浏览：使用 Camofox（基于 Firefox 的浏览器，可通过 REST API 访问），利用 Readability.js 提取干净的内容。
3. 隐身浏览：若网站屏蔽 Camofox，代理将自动升级至 CloakBrowser，这是一个基于 Chromium 的浏览器，具备高级指纹识别功能和 C++ 源码级补丁，可绕过复杂的反机器人挑战。

适用人群

适用于 OpenCode、Claude Code、Cursor 和 GitHub Copilot 等 AI 代理的开发者和用户，他们希望在不依赖付费 API 或遭遇「被挑战阻止」错误的前提下，实现可靠、无限、自托管的网络研究。

核心亮点

• 反机器人绕过：专为绕过 Cloudflare、Turnstile、DataDome、Akamai 等保护机制而设计。
• 自托管且免费：无需 API 密钥或订阅；所有组件通过 Docker 和 npm 在本地机器上运行。
• 防幻觉：强制执行严格的「先搜索后回答」工作流，确保代理必须基于实时网络源验证主张。
• 自动升级：代理可根据网站响应，自主决定何时从标准浏览切换至隐身模式。
• 安全加固：内置 SSRF 防护、脚本沙箱和请求限速机制。