shadowsurf 0.1.0

A lightweight and undetectable browser automation library utilizing pure CDP.

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:

pip install .

Contoh Penggunaan (YouTube Viewer)

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())