From d51ebbac44897d2b224e456ac708c24b6e0e9621 Mon Sep 17 00:00:00 2001
From: feder-cr <Federico.elia.majo@gmail.com>
Date: Wed, 27 May 2026 09:48:22 -0700
Subject: [PATCH] feat(tool): add InvisibleFirefoxTool (proposal)

Adds a draft stub for an InvisibleFirefoxTool parallel to Crawl4aiTool
and BrowserUseTool. Wraps invisible_playwright which drives a patched
Firefox 150 binary with fingerprint patches at the C++ source code
level (no JS shims). Useful for sites where the existing tools hit
Cloudflare/Akamai/Datadome/hCaptcha walls.

Mirrors the shape of crawl4ai.py (PR #1197 precedent). Opened as
draft to check interest before fleshing out additional tool methods.
---
 app/tool/invisible_firefox.py | 84 +++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 app/tool/invisible_firefox.py

diff --git a/app/tool/invisible_firefox.py b/app/tool/invisible_firefox.py
new file mode 100644
index 000000000..f9ddc9e01
--- /dev/null
+++ b/app/tool/invisible_firefox.py
@@ -0,0 +1,84 @@
+"""
+Invisible Firefox Tool for OpenManus (proposal stub).
+
+Optional Firefox-based stealth fetcher tool, parallel to Crawl4aiTool and
+BrowserUseTool. Wraps invisible_playwright which drives a patched Firefox
+150 binary with fingerprint patches applied at the C++ source code level
+(no JS shims to detect).
+
+Tracking discussion: TBD
+"""
+
+from typing import Optional
+
+from app.logger import logger
+from app.tool.base import BaseTool, ToolResult
+
+try:
+    from invisible_playwright import InvisiblePlaywright
+except ImportError:
+    raise ImportError(
+        "`invisible_playwright` not installed. "
+        "Install with `pip install invisible_playwright` and run "
+        "`python -m invisible_playwright fetch` to download the patched Firefox binary."
+    )
+
+
+class InvisibleFirefoxTool(BaseTool):
+    """Firefox-based stealth fetcher tool.
+
+    Wraps invisible_playwright (https://github.com/feder-cr/invisible_playwright),
+    which drives a patched Firefox 150 binary (feder-cr/invisible_firefox,
+    MPL-2.0, same license as Firefox upstream). Useful for sites where the
+    Crawl4aiTool, BrowserUseTool, or web_search backends hit Cloudflare,
+    Akamai, Datadome, or hCaptcha walls.
+    """
+
+    name: str = "invisible_firefox"
+    description: str = """Fetch a URL using a patched stealth Firefox browser.
+
+    Use this when other browser or scraper tools return 403, empty content,
+    or get flagged as automation. The patched binary handles fingerprint
+    spoofing at the native level so there are no detectable JS shims.
+
+    Returns the rendered HTML of the page.
+    """
+
+    parameters: dict = {
+        "type": "object",
+        "properties": {
+            "url": {
+                "type": "string",
+                "description": "(required) The URL to fetch.",
+            },
+            "wait_for_selector": {
+                "type": "string",
+                "description": "(optional) CSS selector to wait for before returning. Useful for JS-rendered pages.",
+            },
+            "seed": {
+                "type": "integer",
+                "description": "(optional) Integer seed for deterministic fingerprint across runs.",
+            },
+        },
+        "required": ["url"],
+    }
+
+    async def execute(
+        self,
+        url: str,
+        wait_for_selector: Optional[str] = None,
+        seed: Optional[int] = None,
+    ) -> ToolResult:
+        try:
+            from invisible_playwright.async_api import InvisiblePlaywright as AsyncIP
+
+            async with AsyncIP(seed=seed, headless=True) as browser:
+                page = await browser.new_page()
+                await page.goto(url)
+                if wait_for_selector:
+                    await page.wait_for_selector(wait_for_selector)
+                html = await page.content()
+                return ToolResult(output=html)
+        except Exception as e:
+            logger.error(f"InvisibleFirefoxTool failed for {url}: {e}")
+            return ToolResult(error=str(e))