browser-search is an agent skill that gives a coding agent self-hosted web search and browsing by orchestrating three tools: SearXNG for metasearch, Camofox for standard browsing, and CloakBrowser for sites behind anti-bot protection. It needs no paid search API, and all three components run on your own machine. It was built and tested on a Raspberry Pi.
The skill restricts the agent to deterministic scripts for each step, so the model chooses which tool to call but cannot malform a command or misread its output. A typical run searches first with SearXNG, which queries Google, Bing, DuckDuckGo, Wikipedia, and other engines and returns JSON results, then browses the chosen URLs with Camofox. When Camofox is blocked by a Cloudflare or Akamai challenge, the agent escalates to CloakBrowser automatically. A Deep Research mode enforces a search-first workflow in which every factual claim is checked against live sources.
Camofox wraps the Camoufox Firefox fork in a REST API with an always-warm browser, so it can open tabs, click, scroll, run JavaScript, return compact accessibility snapshots, and extract clean articles with Readability.js. CloakBrowser launches a fresh patched Chromium per request with fingerprinting, proxy, and geo-IP support, and detects and waits out Cloudflare, Turnstile, DataDome, Imperva, PerimeterX, and DDoS-Guard challenges. The skill definition targets OpenCode and can be adapted for Claude Code, Cursor, OpenClaw, and other agents.
Features
- Metasearch: SearXNG queries many search engines at once and returns titles, snippets, and URLs as JSON
- Standard browsing: Camofox exposes a Firefox-based browser over REST for navigation, clicks, JavaScript evaluation, and accessibility snapshots
- Article extraction: Readability.js strips navigation, sidebars, and ads from pages to cut token use
- Anti-bot escalation: blocked pages are retried automatically in CloakBrowser, a stealth Chromium with challenge detection
- Proxy and geo-IP: CloakBrowser fetches can route through a proxy with matching geolocation
- Deterministic scripts: every action runs through fixed scripts so the model cannot misissue commands or misread results
- Deep Research mode: search-first workflow that cross-checks factual claims against live web sources
- Editable rules: the skill definition is plain text that can be changed to fit a team's workflow
- Self-hosted: all components run locally with no API keys, subscriptions, or rate limits
