From 26b930f5b4e7f11b3a52e33aadc406898ee90f73 Mon Sep 17 00:00:00 2001
From: root <root@v2202607377162478911.nicesrv.de>
Date: Tue, 21 Jul 2026 22:17:01 -0400
Subject: [PATCH] =?UTF-8?q?docs:=20Super=20Search=20v2.1=20=E2=80=94=20cir?=
 =?UTF-8?q?cuit=20breaker,=20racing=20search,=20screenshots?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/super-search-cf-bypass.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/super-search-cf-bypass.md b/docs/super-search-cf-bypass.md
index d3a1571..5a4f806 100644
--- a/docs/super-search-cf-bypass.md
+++ b/docs/super-search-cf-bypass.md
@@ -35,3 +35,30 @@ r = asyncio.run(_extract_one('https://nowsecure.nl'))
 print(r['provider'])  # Should be 'trafilatura' or 'browserless'
 "
 ```
+
+---
+
+## v2.1 Features (Added July 21, 2026)
+
+### 13 Tools
+| # | Tool | Description |
+|---|---|---|
+| 1-10 | Original 10 | Search, extract, lookup, suggest, images |
+| 11 | `web_search_fast` | Parallel racing: all providers fire simultaneously |
+| 12 | `screenshot` | Browserless Chrome → base64 PNG |
+| 13 | `circuit_status` | Provider health states (closed/open/half-open) |
+
+### Circuit Breaker
+- 8 provider circuits: 3 failures → open for 60s
+- Prevents hammering dead providers
+- Auto-recovers when provider comes back
+
+### Parallel Racing
+- `web_search_fast`: SearXNG ∥ Exa ∥ DuckDuckGo ∥ Wikipedia
+- First successful result wins — others cancelled
+- Typically 2-3x faster than sequential fallback
+
+### Screenshot
+- Browserless Chrome on port 3006 (Caddy HTTP proxy)
+- Full-page or viewport capture
+- Base64-encoded PNG in JSON response