Metadata-Version: 2.4
Name: stealthy-browser
Version: 1.0.0
Summary: A stealth Chromium browser with 75+ fingerprint patches and REST API
Home-page: https://github.com/ggfuchsi-oss/StealthyBrowserIguess
Author: Stealth Browser Team
License: MIT
Project-URL: Homepage, https://github.com/ggfuchsi-oss/StealthyBrowserIguess
Project-URL: Repository, https://github.com/ggfuchsi-oss/StealthyBrowserIguess
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Stealth Browser

A stealth Chromium browser with 75+ fingerprint patches and REST API. Bypasses Akamai, PerimeterX, Kasada, Cloudflare, reCAPTCHA.

## Features

- **25 C++ source patches** compiled into Chromium binary
- **50+ runtime JavaScript patches** for comprehensive fingerprint spoofing
- **Bypasses all major anti-bot systems:**
  - Akamai Bot Manager v2 ✅
  - PerimeterX/HUMAN ✅
  - Kasada ✅ (x-kpsdk-ct token)
  - Cloudflare Turnstile ✅
  - reCAPTCHA v3 (0.9 score) ✅
- **69 REST API endpoints** for full browser control
- **Warm-up mode** for building session trust
- **Human-like interaction** (mouse, scroll, keystroke timing)

## Installation

```bash
pip install stealth-browser
```

## Quick Start

```python
from stealthy_browser import StealthyBrowser

# Start browser
browser = StealthyBrowser()

# Navigate with warmup
browser.goto("https://www.amazon.com/s?k=ps5+pro", warmup=True)

# Extract data
print(browser.get_text())

# Take screenshot
browser.screenshot("amazon.png")

# Check fingerprint
print(browser.get_fingerprint())

# Check anti-bot status
print(browser.get_anti_bot_status())
```

## CLI Usage

```bash
# Start server
stealth-browser start

# Scrape a URL
stealth-browser scrape "https://www.amazon.com/s?k=ps5+pro"

# Take screenshot
stealth-browser screenshot "https://www.amazon.com/s?k=ps5+pro" --output amazon.png

# Check fingerprint
stealth-browser fingerprint

# Check anti-bot status
stealth-browser anti-bot
```

## API Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/health` | GET | Health check |
| `/goto` | POST | Navigate to URL |
| `/info/title` | GET | Page title |
| `/info/body/text` | GET | Page text |
| `/info/fingerprint` | GET | Browser fingerprint |
| `/info/anti-bot` | GET | Anti-bot status |
| `/cookies` | GET | Session cookies |
| `/js/execute` | POST | Execute JavaScript |
| `/screenshot` | POST | Take screenshot |
| `/warmup` | POST | Run warmup sequence |

## Configuration

Edit `config.json` to customize:

```json
{
  "server": {"port": 6666, "host": "127.0.0.1"},
  "browser": {
    "chrome_path": "path/to/chrome.exe",
    "headless": true,
    "stealth": true
  },
  "warmup": {
    "enabled": true,
    "sites": ["https://example.com"]
  }
}
```

## License

MIT
