Metadata-Version: 2.4
Name: shadowsurf
Version: 0.1.1
Summary: A lightweight and undetectable browser automation library utilizing pure CDP.
Home-page: https://github.com/inyongnation/shadowsurf
Author: Inyong Nation
Author-email: admin@inyongnation.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: websockets>=11.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ShadowSurf

ShadowSurf adalah library otomatisasi browser berbasis Python yang sangat ringan (*lightweight*) dan tidak terdeteksi (*undetectable*). Didesain sebagai alternatif untuk Selenium dan Playwright yang sering diblokir oleh anti-bot modern (seperti Cloudflare, Datadome, reCAPTCHA).

## Fitur Utama
* **No Bundled Binaries**: Menggunakan Chrome yang sudah terinstal di perangkat Anda.
* **Native CDP (WebSockets)**: Koneksi langsung ke Chrome tanpa melalui ekstensi WebDriver.
* **No Automation Flags**: Berjalan murni seperti pengguna biasa, tanpa pesan peringatan otomasi.
* **Pre-Document Stealth**: Menyuntikkan manipulasi JS (*stealth.js*) sebelum website memuat untuk membypass deteksi `navigator.webdriver` dan proteksi lainnya.

## Instalasi

Anda bisa menginstal library ini secara lokal dengan perintah:
```bash
pip install .
```

## Contoh Penggunaan (YouTube Viewer)
```python
import asyncio
from shadowsurf import launch

async def view_youtube():
    browser = await launch(headless=False)
    page = await browser.new_page()
    await page.goto("https://www.youtube.com/watch?v=LXb3EKWsInQ")
    await asyncio.sleep(30)
    await page.close()
    browser.close()

asyncio.run(view_youtube())
```
