Johell1NS/browser-search

A skill for AI agents: search the web with SearXNG, browse with Camofox, bypass protections with CloakBrowser. Anti-hallucination by design. Self-hosted, free, unlimited.

What it solves

It provides AI agents with a reliable, anti-hallucination web search and browsing capability. It solves the problem of agents being blocked by anti-bot protections (like Cloudflare or Akamai) and the tendency of models to hallucinate facts when they lack live web access.

How it works

The project implements a three-tier escalation system that an AI agent can navigate autonomously:

  1. Search: Uses SearXNG (a self-hosted metasearch engine) to quickly find URLs and snippets.
  2. Standard Browsing: Uses Camofox (a Firefox-based REST API) for fast, structured data extraction from most websites.
  3. Stealth Browsing: If a site blocks Camofox, the agent escalates to CloakBrowser, a stealth Chromium instance with advanced fingerprinting and C++ patches to bypass sophisticated anti-bot challenges.

This workflow is enforced via deterministic scripts, ensuring the agent follows a "search first, answer second" process to verify claims against live sources.

Who it’s for

Developers and users of AI agents (such as OpenCode, Claude Code, Cursor, and GitHub Copilot) who need their agents to perform deep research and extract data from the web without being blocked or relying on paid APIs.

Highlights

  • Anti-Bot Bypass: Specifically designed to clear Cloudflare, Akamai, DataDome, and other protections using CloakBrowser.
  • Self-Hosted & Free: No API keys or subscriptions; all components (SearXNG, Camofox, CloakBrowser) run on the user's own hardware.
  • Automatic Escalation: The agent automatically switches from standard browsing to stealth mode if it encounters a block.
  • Resource Efficient: Lightweight enough to run on a Raspberry Pi.
  • Security Hardened: Includes built-in SSRF prevention, script sandboxing, and path traversal protection.

Related

  • Project
    redf0x1/camofox-browser

    CamoFox Browser Server is a TypeScript‑based REST/CLI wrapper around the Camoufox stealth‑Firefox engine. It provides engine‑level fingerprint spoofing, persistent profiles, geo/proxy presets, structured accessibility snapshots, and an encrypted credential vault—making it a robust, anti‑detection browser platform for LLM‑driven agents and other automation tools.

  • Project
    browser-act/skills

    A browser automation framework for AI agents that bypasses anti-bot protections and provides token-efficient web interaction via indexed text formats.

  • Project
    Bin-Huang/camoufox-cli

    A command-line interface and set of skills for AI agents to browse the web using an anti-detect browser that spoofs fingerprints to avoid bot detection.

  • Project
    vibheksoni/stealth-browser-mcp

    An MCP-compatible server for stealth browser automation that enables AI agents to bypass anti-bot checks and Cloudflare challenges using real Chrome-family browsers.