Johell1NS/browser-search

解决的问题

它为 AI 代理提供了可靠且防止幻觉的网络搜索和浏览能力。它解决了代理被反机器人防护（如 Cloudflare 或 Akamai）拦截的问题，以及模型在缺乏实时网络访问时捏造事实的倾向。

工作原理

该项目实现了三层升级机制，AI 代理可以自主导航：

1. 搜索：使用 SearXNG（一个自托管的元搜索引擎）快速查找 URL 和摘要。
2. 标准浏览：使用 Camofox（一个基于 Firefox 的 REST API）从大多数网站快速提取结构化数据。
3. 隐蔽浏览：如果网站拦截了 Camofox，代理会升级到 CloakBrowser，这是一个具有高级指纹伪装和 C++ 补丁的隐蔽 Chromium 实例，用于绕过复杂的反机器人挑战。

此工作流程通过确定性脚本强制执行，确保代理遵循“先搜索，后回答”的流程，以对照实时来源验证声明。

适用对象

AI 代理（如 OpenCode、Claude Code、Cursor 和 GitHub Copilot）的开发者和用户，他们需要其代理执行深度研究并从网络提取数据，而不被拦截或依赖付费 API。

亮点

• 反机器人绕过：专门设计用于通过 CloakBrowser清除 Cloudflare、Akamai、DataDome 等防护。
• 自托管且免费：无需 API 密钥或订阅；所有组件（SearXNG、Camofox、CloakBrowser）都在用户自己的硬件上运行。
• 自动升级：如果遇到拦截，代理会自动从标准浏览切换到隐蔽模式。
• 资源高效：轻量到足以在 Raspberry Pi 上运行。
• 安全强化：包括内置的 SSRF 防护、脚本沙盒和路径遍历保护。