docs: Update README

Author: swapnilpawar-07

README.md

@@ -1,5 +1,3 @@
-# surenav
-"Open-source web unblocker for AI agents - no API keys required"
 # 🧭 SureNav
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
@@ -8,7 +6,7 @@
 
 **SureNav** is a fully open-source web navigation and scraping toolkit for AI agents that requires **zero API keys**. It provides anti-detection browser automation, intelligent proxy rotation, and web unblocking capabilities—completely free.
 
-> 🚀 **Drop-in replacement for paid services** like Massive's ClawPod, but open source and free forever.
+> 🚀 **Drop-in replacement for paid services** like Massive's ClawPod, but open source and free forever.
 
 ## ✨ Features
 
@@ -25,4 +23,84 @@
 ### Docker (Easiest)
 
 ```bash
-docker run -p 8000:8000 ghcr.io/YOUR_USERNAME/surenav:latest
+docker run -p 8000:8000 ghcr.io/colomboai-com/surenav:latest
+```
+
+### Local Installation
+
+```bash
+pip install surenav
+playwright install chromium
+surenav-server
+```
+
+## 📖 Usage
+
+### Fetch a Web Page
+
+```bash
+curl "http://localhost:8000/browser?url=https://example.com"
+```
+
+### Search Google
+
+```bash
+# JSON output
+curl "http://localhost:8000/search?terms=open+source+ai&format=json"
+
+# HTML output
+curl "http://localhost:8000/search?terms=python+tutorial"
+```
+
+### Python SDK
+
+```python
+from surenav import StealthBrowser
+
+browser = StealthBrowser()
+result = await browser.fetch_page("https://example.com")
+print(result["content"])
+```
+
+## 🏗️ Architecture
+
+```mermaid
+graph LR
+    A[Client Request] --> B[FastAPI Server]
+    B --> C[Proxy Manager]
+    C --> D[Free Proxy Lists]
+    B --> E[Stealth Browser]
+    E --> F[Playwright + Stealth]
+    F --> G[Target Website]
+    G --> H[Clean Content]
+    H --> A
+```
+
+## ⚙️ Configuration
+
+Environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SURENAV_PORT` | 8000 | Server port |
+| `SURENAV_PROXY_REFRESH` | 300 | Proxy refresh interval (seconds) |
+| `SURENAV_HEADLESS` | true | Run browser headless |
+| `SURENAV_MAX_RETRIES` | 3 | Retry attempts per request |
+
+## 🛡️ Anti-Detection Features
+
+- ✅ User agent rotation
+- ✅ Viewport fingerprint randomization
+- ✅ WebGL/Canvas noise injection
+- ✅ Automation flag removal
+- ✅ Mouse movement humanization
+- ✅ Cookie/session handling
+- ✅ TLS/JA3 fingerprint randomization (planned)
+
+## 🤝 Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## 📜 License
+
+MIT - Free for personal and commercial use.