init

README.md

@@ -1,2 +1,102 @@
-# Puppeteer-Stealth-Proxy
+---
 
+# 🕵️ Puppeteer Stealth Proxy
+
+A lightweight **HTTP proxy API** powered by **Puppeteer + Stealth Plugin**.
+Bypasses Cloudflare and anti-bot systems with real browser automation.
+
+---
+
+## 🚀 Features
+
+* Uses `puppeteer-extra-plugin-stealth` to avoid detection
+* Auto-save & load cookies per domain
+* Optional API key protection
+* Proxy any HTTP method (GET, POST, etc.)
+* Screenshot endpoint
+* Reuses one browser instance for better performance
+* Auto-closes browser on exit
+
+---
+
+## ⚙️ Setup
+
+```bash
+git clone https://github.com/yourname/puppeteer-stealth-proxy.git
+cd puppeteer-stealth-proxy
+npm install
+```
+
+Create `.env` (optional):
+
+```bash
+PORT=4000
+API_KEY=your-secret-key
+NODE_ENV=production
+```
+
+---
+
+## 🏃 Run
+
+```bash
+npm run dev        # development
+NODE_ENV=production node index.js  # production
+```
+
+Default: `http://localhost:4000`
+
+---
+
+## 🔑 API
+
+### Health check
+
+```
+GET /
+→ { "ok": true, "msg": "puppeteer-stealth-proxy" }
+```
+
+### Proxy request
+
+```
+GET /proxy?url=https://example.com
+```
+
+Optional headers:
+
+```
+x-api-key: your-secret-key
+authorization: Bearer your-secret-key
+```
+
+### Screenshot
+
+```
+GET /screenshot?url=https://example.com
+```
+
+---
+
+## 📁 Structure
+
+```
+index.js
+cookies/
+package.json
+README.md
+```
+
+---
+
+## 🧩 Notes
+
+* Puppeteer runs in headless mode with stealth enabled
+* Automatically stores cookies under `cookies/`
+* Morgan logs disabled in production
+
+---
+
+## 📜 License
+
+MIT © 2025 — Kain344