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

browser-search is a set of tools designed to give AI agents the ability to search and browse the web without being blocked by anti-bot protections (like Cloudflare or Akamai). It aims to eliminate model hallucinations by forcing agents to verify factual claims against live web sources using a deterministic "search first, answer second" workflow.

How it works

The project implements a three-tier escalation system for web access:

  1. Search Phase: Uses SearXNG (a self-hosted metasearch engine) to quickly gather a list of URLs and snippets from multiple sources.
  2. Standard Browsing: Uses Camofox, a Firefox-based browser accessible via REST API, to navigate and extract clean content using Readability.js.
  3. Stealth Browsing: If a site blocks Camofox, the agent automatically escalates to CloakBrowser, a Chromium-based browser with advanced fingerprinting and C++ source-level patches to bypass sophisticated anti-bot challenges.

Who it’s for

It is designed for developers and users of AI agents (such as OpenCode, Claude Code, Cursor, and GitHub Copilot) who need their agents to perform reliable, unlimited, and self-hosted web research without relying on paid APIs or encountering "blocked by challenge" errors.

Highlights

  • Anti-Bot Bypass: Specifically designed to clear Cloudflare, Turnstile, DataDome, Akamai, and other protections.
  • Self-Hosted & Free: No API keys or subscriptions; all components run on the machine via Docker and npm.
  • Anti-Hallucination: Enforces a rigid workflow where agents must verify claims against live sources.
  • Automatic Escalation: The agent autonomously decides when to switch from standard browsing to stealth mode based on site response.
  • Security Hardened: Includes built-in SSRF prevention, script sandboxing, and rate limiting.

Related

  • Project
    redf0x1/camofox-browser

    An anti-detection browser server for AI agents that uses C++ engine-level fingerprint spoofing to bypass bot detection via a REST API and CLI.

  • 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 for an anti-detect browser that allows AI agents to bypass bot detection using C++-level fingerprint spoofing and persistent identities.

  • Project
    vibheksoni/stealth-browser-mcp

    An MCP server that enables AI agents to automate real Chrome-family browsers to bypass anti-bot checks and Cloudflare challenges.

  • Project
    jo-inc/camofox-browser

    camofox-browser is a Node.js server that runs a patched Firefox (Camoufox) with built‑in anti‑bot fingerprint spoofing and exposes a REST API for AI agents. It returns compact accessibility snapshots, stable element references, cookie import, proxy/GeoIP handling, VNC login, and optional Playwright tracing, all deployable via Docker, Fly.io, Railway, or locally.