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 防護、腳本沙箱與請求限速機制。