# 🚀 Obscura — Headless Browser ตัวจิ๋วแต่แจ๋ว สำหรับยุค AI

## 1. Obscura คืออะไร?

**Obscura** คือ headless browser engine ที่เขียนด้วยภาษา **Rust** — มันคือ "เบราว์เซอร์ที่ไม่มีหน้า" ที่รัน JavaScript ผ่าน V8 engine พูดภาษา Chrome DevTools Protocol (CDP) ได้ และสามารถใช้แทน headless Chrome สำหรับ Puppeteer และ Playwright ได้แบบ **drop-in replacement**

พูดง่ายๆ คือ Obscura เป็นโปรแกรมที่เปิดเว็บ อ่านเนื้อหา รัน JavaScript ดึงข้อมูล และทำงานอัตโนมัติ โดยที่ไม่ต้องมีหน้าจอ GUI เลย เหมาะมากสำหรับงาน scraping, automation, AI agent browsing

**จุดเด่นสำคัญ:**

- ใช้หน่วยความจำแค่ **30 MB** (Chrome Headless ใช้ 200+ MB)

- Binary ขนาดแค่ **70 MB** (Chrome Headless 300+ MB)

- Startup แทบจะทันที

- Anti-detection ในตัว (stealth mode)

- รองรับทั้ง CLI, CDP, MCP Protocol

---

## 2. ทำไมต้อง Obscura? (ข้อดี)

### ✅ ข้อดี

| คุณสมบัติ | รายละเอียด |

|-----------|-----------|

| 🏎️ **เร็วมาก** | หน้าเว็บโหลดเฉลี่ย ~85 ms เทียบกับ Chrome ~500 ms |

| 🪶 **เบา** | RAM ~30 MB, Binary ~70 MB ไม่ต้องพึ่ง Chromium 300MB+ |

| ⚡ **Startup ทันที** | ไม่ต้องรอ 2-3 วิเหมือน launch Chromium |

| 🛡️ **Stealth ในตัว** | TLS fingerprint, tracker blocking, profile randomization |

| 📦 **Binary เดียว** | ไม่ต้องติดตั้ง dependencies เยอะ |

| 🔌 **รองรับ CDP** | ใช้ Puppeteer/Playwright เชื่อมต่อได้ทันที |

| 🤖 **MCP Protocol** | ให้ AI Agent ใช้ browser automation ได้โดยตรง |

| 🐳 **Docker Ready** | Image ~57 MB บน distroless/cc |

| 🧩 **Rust Library** | ฝัง engine ในโปรเจกต์ Rust ได้ |

| 🗃️ **Persist Cookies** | เก็บ cookies/localStorage ข้าม session |

| 🌐 **ข้ามแพลตฟอร์ม** | Linux, macOS, Windows, Docker |

---

## 3. ข้อจำกัดและข้อเสีย

### ❌ ข้อเสีย / สิ่งที่ไม่รองรับ

| ข้อจำกัด | รายละเอียด |

|----------|-----------|

| ❌ **ไม่มี Pixel Rendering** | `page.screenshot()`, `page.pdf()` ใช้ไม่ได้ — Obscura ไม่มี GPU engine |

| ❌ **ไม่ bypass Cloudflare แบบหนัก** | Web Application Firewall ที่ต้อง JS computation challenge (Under Attack mode) จะไม่ผ่าน |

| ❌ **ไม่ bypass Datadome / Akamai** | Active bot management challenge |

| ❌ **ไม่มี CAPTCHA solver** | ต้องใช้ proxy + stealth เพื่อเลี่ยง |

| 🔶 **V8 Isolate แชร์กัน** | ทุกหน้าเว็บใช้ V8 isolate เดียวกัน ถ้ามี JS หนักๆ ในหน้าเดียวจะทำให้หน้าอื่นค้าง |

| 🔶 **ไม่มี Service Workers** | ไม่รองรับ Progressive Web App |

| 🔶 **Device Emulation จำกัด** | viewport metadata ได้ แต่ไม่มี real layout |

| 🔶 **GPU ไม่มี** | ไม่มี WebGL จริง (แต่มี GPU renderer string ปลอมให้ fingerprint สมบูรณ์) |

### เปรียบเทียบกับ agent-browser / Playwright จริง

| Scenario | Obscura | Chrome Headless / Playwright |

|----------|---------|------------------------------|

| Scrape เว็บทั่วไป | ✅ เร็วกว่า, เบากว่า | ✅ ช้ากว่า แต่ reliable |

| เว็บ JS-heavy (SPA) | ✅ ได้ | ✅ ได้ |

| เว็บมี Cloudflare ปานกลาง | ✅ ผ่าน (stealth mode) | ✅ ผ่าน |

| เว็บมี Cloudflare หนัก (Under Attack) | ❌ ไม่ผ่าน | ✅ ผ่าน (Chromium จริง) |

| Screenshot/PDF | ❌ ไม่มี | ✅ มี |

| ใช้งานใน Docker | ✅ 57MB Image | ❌ Image ใหญ่ |

| ใช้กับ Puppeteer/Playwright code เดิม | ✅ ต่อ CDP ได้ | ✅ |

---

## 4. เทียบกับ Chrome Headless

| Metric | Obscura | Headless Chrome |

|--------|---------|-----------------|

| 💾 **Memory** | ~30 MB | 200+ MB |

| 📦 **Binary size** | ~70 MB | 300+ MB |

| 🚀 **Startup** | Instant (~0ms) | ~2 วินาที |

| ⚡ **Page load** | ~85 ms | ~500 ms |

| 🛡️ **Anti-detect** | ✅ Built-in | ❌ ไม่มี |

| 🎭 **Puppeteer** | ✅ Yes (CDP) | ✅ Yes |

| 🎭 **Playwright** | ✅ Yes (CDP) | ✅ Yes |

| 🖼️ **Screenshot/PDF** | ❌ ไม่มี | ✅ มี |

| 🏭 **Deploy-friendly** | ✅ Binary ตัวเดียว | ❌ ต้องมี Chromium |

---

## 5. การติดตั้ง

### Linux x86_64

```bash

# ดาวน์โหลด binary

curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-x86_64-linux.tar.gz

# แตกไฟล์

tar xzf obscura-x86_64-linux.tar.gz

# ทดสอบ

./obscura --version

# (optional) ย้ายไป PATH

sudo mv obscura /usr/local/bin/

```

> ต้องการ glibc 2.35+ (Ubuntu 22.04 ขึ้นไป)

### Linux ARM64

```bash

curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-aarch64-linux.tar.gz

tar xzf obscura-aarch64-linux.tar.gz

./obscura --version

```

### macOS Apple Silicon

```bash

curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-aarch64-macos.tar.gz

tar xzf obscura-aarch64-macos.tar.gz

./obscura --version

```

### macOS Intel

```bash

curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-x86_64-macos.tar.gz

tar xzf obscura-x86_64-macos.tar.gz

./obscura --version

```

### Windows

1. ไปที่ https://github.com/h4ckf0r0day/obscura/releases

2. ดาวน์โหลด `.zip` สำหรับ Windows

3. แตก zip แล้วรัน `obscura.exe --version`

### Arch Linux (AUR)

```bash

yay -S obscura-browser

```

### Docker

```bash

docker pull h4ckf0r0day/obscura

# รันแบบ server

docker run -d \

  --name obscura \

  --restart unless-stopped \

  -p 127.0.0.1:9222:9222 \

  -v /srv/obscura/data:/data \

  h4ckf0r0day/obscura \

  serve --host 0.0.0.0 --storage-dir /data --stealth

```

> Image ~57 MB compressed บน `distroless/cc`

### Build จาก Source

**Requirements:**

- Rust 1.75+ (`curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`)

- C compiler (gcc หรือ clang)

- พื้นที่ว่าง ~5 GB (V8 compile)

```bash

# Clone

git clone https://github.com/h4ckf0r0day/obscura.git

cd obscura

# Build ปกติ (ใช้เวลา ~5 นาทีครั้งแรก)

cargo build --release

# Build พร้อม stealth (แนะนำ)

cargo build --release --features stealth

# ระบบ OpenSSL เก่า อาจต้องใช้

OPENSSL_NO_VENDOR=1 cargo build --release

# Binary อยู่ที่

./target/release/obscura --version

# Install system-wide

cargo install --path crates/obscura-cli

```

**สิ่งที่อยู่ใน archive:**

- `obscura` — CLI และ CDP server

- `obscura-worker` — helper สำหรับคำสั่ง `scrape` (ต้องอยู่ path เดียวกัน)

### Smoke Test หลังติดตั้ง

```bash

./obscura fetch https://example.com --eval "document.title"

# Expected: "Example Domain"

```

---

## 6. คำสั่งพื้นฐาน (CLI)

### รูปแบบคำสั่ง

```bash

obscura [OPTIONS] <COMMAND> [URLS]

```

### 4 คำสั่งหลัก

| คำสั่ง | ใช้ทำอะไร |

|--------|-----------|

| `fetch <URL>` | โหลด URL เดียว, รัน JS, แสดงผลลัพธ์ |

| `scrape [URLS]...` | รัน JS พร้อมกันหลาย URL |

| `serve` | รัน CDP server ให้ Puppeteer/Playwright เชื่อมต่อ |

| `mcp` | รันเป็น MCP server ให้ AI Agent ใช้งาน |

### Global Flags (ใช้ได้กับทุกคำสั่ง)

| Flag | คำอธิบาย |

|------|----------|

| `--stealth` | เปิด stealth mode (TLS fingerprint + tracker blocking) |

| `--proxy <URL>` | ใช้ proxy (HTTP/SOCKS5) |

| `--user-agent <UA>` | เปลี่ยน User-Agent |

| `--allow-private-network` | อนุญาต localhost/192.168.x.x |

| `-v, --verbose` | แสดง log เยอะขึ้น |

| `-q, --quiet` | ปิด log |

| `--v8-flags <FLAGS>` | ตั้งค่า V8 engine |

| `--storage-dir <DIR>` | โฟลเดอร์เก็บ cookies/localStorage |

---

## 7. การดึงข้อมูล (Extract Data)

### --dump รูปแบบต่างๆ

```bash

# HTML หลังจากรัน JS (ค่าเริ่มต้น)

obscura fetch https://example.com --dump html

# ข้อความล้วน (Plain text)

obscura fetch https://example.com --dump text

# Markdown (แนะนำสำหรับ AI/LLM)

obscura fetch https://example.com --dump markdown

# ลิงก์ทั้งหมดบนหน้า

obscura fetch https://example.com --dump links

# Sub-resources ทั้งหมด (script, img, iframe, fetch/XHR calls)

obscura fetch https://example.com --dump assets

# HTML ดิบก่อนรัน JS (เหมือน server ส่งมา)

obscura fetch https://example.com --dump original

# Cookies ทั้งหมด (รวม HttpOnly ที่ document.cookie มองไม่เห็น)

obscura fetch https://example.com --dump cookies

```

### การใช้ CSS Selector

```bash

# เฉพาะ content หลัก

obscura fetch https://example.com --selector "main" --dump markdown

# เฉพาะ article

obscura fetch https://example.com --selector "article.post" --dump markdown

```

### Markdown Extraction — เหมาะกับ AI Agent โดยเฉพาะ

```bash

# สุดยอดสำหรับ AI — markdown สะอาด ไม่มี noise

obscura fetch https://docs.example.com/page --dump markdown --quiet

# บันทึกเป็นไฟล์

obscura fetch https://docs.example.com/page --dump markdown -o page.md

# รอ SPA โหลดเสร็จก่อน

obscura fetch https://my-spa.example --wait-until load --dump markdown

```

**สิ่งที่ถูกแปลงเป็น Markdown:**

✅ Headings, paragraphs, bold, italic, code spans

✅ Links (พร้อม href), Images (พร้อม src + alt)

✅ List, Block quotes, Code blocks, Tables

**สิ่งที่ถูกตัดออก:**

❌ `<script>`, `<style>`, `<noscript>`, inline styles, ARIA attributes, tracking pixels

---

## 8. JavaScript Evaluation

`--eval` รัน JavaScript บนหน้าเว็บและคืนค่าเป็น JSON

### Single Expression

```bash

# ดึง title

obscura fetch https://example.com --eval "document.title"

# → "Example Domain"

# ดึง structured data

obscura fetch https://news.ycombinator.com --eval \

  "Array.from(document.querySelectorAll('.titleline a')).slice(0,5).map(a => a.textContent)"

```

### Multi-statement (IIFE Pattern)

```bash

obscura fetch https://example.com --eval "(function(){

  const links = document.querySelectorAll('a');

  return Array.from(links).map(a => ({text: a.textContent, href: a.href}));

})()"

```

> ⚠️ **ข้อควรระวัง:** ถ้าเขียน `const` หรือ `let` ที่ top-level โดยตรง จะคืน `null` เพราะ V8 ให้ top-level declaration มี completion value เป็น `null`  

> ✅ **วิธีแก้:** ใช้ IIFE `(function(){...})()` ทุกครั้งที่มีหลาย statement

### Wait Options

```bash

# รอทุกอย่าง (ค่าเริ่มต้น แต่ช้าที่สุด)

--wait-until load

# HTML parsed + scripts รันแล้ว (แนะนำ - เร็วกว่า)

--wait-until domcontentloaded

# รอให้ network connections ≤2 เป็นเวลา 500ms

--wait-until networkidle2

# รอให้ network connections =0 เป็นเวลา 500ms

--wait-until networkidle0

# Extra wait หลัง page settle (default 5s)

--wait 3

```

---

## 9. Stealth Mode และ Proxy

### Stealth Mode

```bash

# เปิด stealth

obscura fetch https://example.com --stealth

obscura serve --stealth

```

**Stealth ทำอะไรบ้าง:**

1. ใช้ HTTP client ที่มี TLS fingerprint ตรงกับ Chrome จริง (ClientHello, ALPN, cipher order)

2. โหลด tracker blocklist — ปิดกั้น analytics/fingerprinting endpoints

3. ใช้ webpki roots แทน system certificate store

4. Browser profile — `navigator.platform`, `userAgentData`, GPU renderer สอดคล้องกัน

**สิ่งที่ Stealth จัดการได้:**

- ✅ Basic bot detection (TLS fingerprint, User-Agent)

- ✅ เว็บที่พึ่งพา third-party analytics

**สิ่งที่ Stealth จัดการไม่ได้:**

- ❌ Cloudflare interactive challenges (JS computation challenge)

- ❌ Datadome, Akamai bot manager

- ❌ CAPTCHA

- ❌ IP-based rate limiting (ต้องใช้ proxy)

### Browser Profile

```bash

# Profile ปกติ (stable, ตัวเดียว)

obscura serve --stealth

# เลือก profile index

OBSCURA_PROFILE=2 obscura serve

# หมุน profile อัตโนมัติ (random ทุก context)

OBSCURA_ROTATE_PROFILE=1 obscura serve

```

**ข้อควรระวัง:** ถ้าใช้ proxy อย่าหมุน profile เพราะการหมุน identity แต่ IP เดิม = suspicious

### Timezone & Geolocation

```bash

# ตั้งเวลาzone ให้ตรงกับ proxy region

OBSCURA_TIMEZONE=Asia/Bangkok obscura serve

# ตั้งพิกัด GPS

OBSCURA_GEOLOCATION="13.7563,100.5018" obscura serve

```

### Proxy

```bash

# HTTP proxy

obscura fetch https://example.com --proxy http://proxy.example.com:8080

# HTTP proxy พร้อม auth

obscura fetch https://example.com --proxy http://user:[email protected]:8080

# SOCKS5

obscura fetch https://example.com --proxy socks5://proxy.example.com:1080

# รวม stealth + proxy + custom UA

obscura serve \

  --stealth \

  --proxy http://user:[email protected]:8080 \

  --user-agent "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ..."

```

---

## 10. การใช้งานกับ Puppeteer / Playwright

### เริ่ม CDP Server

```bash

obscura serve --port 9222

# → obscura listening on ws://127.0.0.1:9222

```

### Puppeteer

```bash

npm install puppeteer-core

```

```javascript

const puppeteer = require('puppeteer-core');

const browser = await puppeteer.connect({

  browserWSEndpoint: 'ws://127.0.0.1:9222',

});

const page = await browser.newPage();

await page.goto('https://example.com');

console.log(await page.title()); // "Example Domain"

await browser.disconnect();

```

> ⚠️ ใช้ `puppeteer-core` ไม่ใช่ `puppeteer` (puppeteer แบบเต็มจะโหลด Chromium มาให้)

### Playwright

```bash

npm install playwright

```

```javascript

const { chromium } = require('playwright');

const browser = await chromium.connectOverCDP('ws://127.0.0.1:9222');

const context = browser.contexts()[0] || await browser.newContext();

const page = await context.newPage();

await page.goto('https://example.com');

console.log(await page.title());

await browser.close();

```

> ⚠️ ใช้ `connectOverCDP` ไม่ใช่ `connect` (connect ใช้ protocol ของ Playwright เอง)

### สิ่งที่รองรับ

| ฟีเจอร์ | รองรับ? |

|---------|:-------:|

| `page.goto`, `page.reload`, `page.goBack`, `page.goForward` | ✅ |

| `page.evaluate`, `page.evaluateHandle` | ✅ |

| `page.click`, `page.type`, `page.fill`, `page.focus` | ✅ |

| `page.waitForSelector`, `page.waitForFunction`, `page.waitForNavigation` | ✅ |

| `page.cookies`, `page.setCookie`, `context.cookies` | ✅ |

| `page.setRequestInterception` (block/modify) | ✅ |

| `page.exposeFunction` | ✅ |

| `page.content`, `page.title`, `page.url` | ✅ |

| DOM Agent frameworks (browser-use) | ✅ |

| `page.screenshot()`, `page.pdf()` | ❌ ไม่มี pixel rendering |

| Service Workers | ❌ |

---

## 11. MCP Server — ให้ AI Agent ใช้ Browser

Obscura มี MCP (Model Context Protocol) server ในตัว ทำให้ AI Agent เชื่อมต่อและใช้ browser automation ได้ทันที

### รัน MCP Server

```bash

# Stdio mode (default — สำหรับ Claude Desktop โดยตรง)

obscura mcp

# HTTP mode (สำหรับ remote หรือ container)

obscura mcp --http --port 3000

# HTTP + bind all interfaces (ใน Docker)

obscura mcp --http --host 0.0.0.0 --port 3000

# พร้อม stealth + proxy

obscura mcp --stealth --proxy http://proxy.example.com:8080

```

### การเชื่อมต่อกับ Claude Desktop

แก้ไข `claude_desktop_config.json`:

```json

{

  "mcpServers": {

    "obscura": {

      "command": "/path/to/obscura",

      "args": ["mcp", "--stealth"]

    }

  }

}

```

### การเชื่อมต่อกับ Claude Code

```bash

claude mcp add obscura /path/to/obscura mcp

```

### เครื่องมือ MCP ที่ Obscura ให้

**Navigation:**

- `browser_navigate`, `browser_back`, `browser_forward`, `browser_reload`, `browser_close`

**Read page:**

- `browser_snapshot` — DOM/accessibility snapshot

- `browser_markdown`, `browser_links`, `browser_extract`

- `browser_interactive_elements`, `browser_detect_forms`

- `browser_get_attribute`, `browser_count`, `browser_search`

**Interactive:**

- `browser_click`, `browser_fill`, `browser_fill_form`

- `browser_type`, `browser_press_key`, `browser_select_option`, `browser_scroll`

**Wait & JS:**

- `browser_wait_for`, `browser_wait_for_text`, `browser_evaluate`

**Cookies & Storage:**

- `browser_get_cookies`, `browser_set_cookie`, `browser_clear_cookies`

- `browser_storage_state`, `browser_set_storage_state`

**Network:**

- `browser_network_requests`, `browser_console_messages`

**Tabs:**

- `browser_tab_new`, `browser_tab_list`, `browser_tab_switch`, `browser_tab_close`

### Security (HTTP transport)

```bash

# จำกัดเฉพาะ Origin ที่อนุญาต

OBSCURA_MCP_ALLOWED_ORIGINS="https://app.example.com" obscura mcp --http

# Body cap 16 MiB (default — ป้องกัน large allocation)

```

---

## 12. Production Deployment

### Docker (Production)

```bash

docker run -d \

  --name obscura \

  --memory=4g --cpus=2 \

  --restart unless-stopped \

  -p 127.0.0.1:9222:9222 \

  -v /srv/obscura/data:/data \

  h4ckf0r0day/obscura \

  serve --host 0.0.0.0 --storage-dir /data --stealth

```

### Systemd service

```ini

# /etc/systemd/system/obscura.service

[Unit]

Description=Obscura headless browser

After=network.target

[Service]

ExecStart=/usr/local/bin/obscura serve --port 9222 --stealth --storage-dir /var/lib/obscura

Restart=always

RestartSec=5

User=obscura

Group=obscura

LimitNOFILE=65536

MemoryMax=4G

MemoryHigh=3G

[Install]

WantedBy=multi-user.target

```

```bash

sudo systemctl enable --now obscura

sudo journalctl -fu obscura

```

### Workers (Multi-core)

```bash

# 1 worker ต่อ 1 CPU core

obscura serve --workers 4

```

### Parallel Scrape

```bash

# Scrape 20 URL พร้อมกัน

obscura scrape \

  --concurrency 20 \

  --format json \

  --timeout 60 \

  --stealth \

  url1 url2 url3 ...

# หรืออ่านจาก stdin

cat urls.txt | obscura scrape --concurrency 20 --stealth -

```

> ⚠️ ต้องมี `obscura-worker` อยู่ข้างๆ `obscura` ใน PATH

### V8 Heap Management

```bash

# Default: --max-old-space-size=4096 (4GB) 

# ลดสำหรับเครื่อง RAM น้อย

obscura serve --v8-flags "--max-old-space-size=2048"

```

### Timeouts (ป้องกัน session ค้าง)

```bash

OBSCURA_NAV_TIMEOUT_MS=60000 \

OBSCURA_CDP_COMMAND_TIMEOUT_MS=30000 \

OBSCURA_FETCH_TIMEOUT_MS=20000 \

  obscura serve

```

### Persist Cookies & Storage

```bash

# CLI

obscura fetch https://example.com --storage-dir ./obscura-data

# Server

obscura serve --storage-dir ./obscura-data

# หลาย identity แยก directory

obscura serve --port 9222 --storage-dir ./identity-a

obscura serve --port 9223 --storage-dir ./identity-b

```

**ภายใน `--storage-dir`:**

- `cookies.json` — cookie jar (inspect ด้วย `jq`)

- `localStorage/*.json` — 1 file ต่อ origin

**เมื่อ state ถูกเขียน:**

- ตอน process exit

- หลัง navigation เสร็จ

- ผ่าน CDP `Network.setCookie`

---

## 13. Environment Variables

### Runtime

| Variable | ค่าเริ่มต้น | คำอธิบาย |

|----------|-----------|---------|

| `OBSCURA_ALLOW_PRIVATE_NETWORK` | off | อนุญาต localhost/192.168.x.x (ตั้งเป็น `1`) |

| `OBSCURA_NAV_TIMEOUT_MS` | 30000 | Timeout navigation (ms) |

| `OBSCURA_CDP_COMMAND_TIMEOUT_MS` | 60000 | Timeout แต่ละ CDP command (ms) |

| `OBSCURA_FETCH_TIMEOUT_MS` | 30000 | Timeout fetch/XHR (ms) |

### Stealth & Identity

| Variable | ค่าเริ่มต้น | คำอธิบาย |

|----------|-----------|---------|

| `OBSCURA_TIMEZONE` | Europe/Berlin | Timezone สำหรับ fingerprint |

| `OBSCURA_GEOLOCATION` | fixed default | พิกัด GPS (`lat,lon`) |

| `OBSCURA_PROFILE` | 0 (stable) | เลือก browser profile index |

| `OBSCURA_ROTATE_PROFILE` | off | หมุน profile ทุก context |

### MCP Security

| Variable | คำอธิบาย |

|----------|---------|

| `OBSCURA_MCP_ALLOWED_ORIGINS` | comma-separated origin allowlist |

### Logging

```bash

RUST_LOG=obscura=info obscura serve

RUST_LOG=obscura=debug obscura serve

RUST_LOG=obscura_cdp=trace,obscura_browser=debug obscura serve

```

### Build

```bash

OPENSSL_NO_VENDOR=1 cargo build --release

```

---

## 14. การใช้งานสำหรับ AI Agent (Hermes)

สำหรับการใช้งาน Obscura ใน Hermes Agent (หรือ AI Agent ทั่วไป) มี 2 แนวทาง:

### วิธีที่ 1: CLI Mode (แนะนำสำหรับ Scraping)

ใช้ผ่าน `terminal()` tool โดยตรง:

```bash

# Scrape หน้าเว็บ

/home/tong/obscura fetch <URL> --dump markdown --quiet

# ดึง structured data

/home/tong/obscura fetch <URL> --quiet --eval "JS code"

# Batch scrape

/home/tong/obscura scrape --quiet --stealth --eval "document.title" URL1 URL2

```

**ข้อดี:** Binary ตัวเดียว, เร็วมาก, ไม่ต้อง setup session

**ข้อเสีย:** แต่ละครั้งเป็น session ใหม่ (cookie ไม่ persist)

### วิธีที่ 2: MCP Mode (แนะนำสำหรับ Interactive)

รัน `obscura mcp --http` แล้ว configure Hermes ให้ใช้ MCP tools:

```yaml

# ใน config.yaml ของ Hermes

mcp_servers:

  obscura:

    command: /home/tong/obscura

    args: ["mcp", "--stealth", "--http"]

    port: 3000

```

**ข้อดี:** มี session ที่ persist, รองรับ interactive (click, fill form)

**ข้อเสีย:** ต้องรัน background service, ทรัพยากรเพิ่ม

### Skill สำหรับ Hermes

มี skill `web/obscura-browser` ที่สามารถ load เพื่อใช้งาน:

```bash

# terminal เรียกใช้ตาม pattern ใน skill

/home/tong/obscura fetch <URL> --dump markdown --quiet --wait-until domcontentloaded

```

### Cron Job Integration

ใน cron job prompt ให้ใช้ Obscura แทน browser tools:

```bash

# แทนที่จะใช้ browser_navigate → ใช้:

/home/tong/obscura fetch <URL> --dump markdown --quiet --stealth

```

---

## 15. FAQ ปัญหาที่พบบ่อย

### Q: ติดตั้งแล้วรันไม่ได้ "cannot execute binary file"

**A:** เลือก architecture ผิด ตรวจสอบด้วย `uname -m` แล้วดาวน์โหลด binary ที่ถูกต้อง

### Q: "GLIBC_2.35 not found"

**A:** ระบบ Linux เก่ากว่า Ubuntu 22.04 ใช้ Docker แทน หรือ build จาก source

### Q: macOS Gatekeeper บล็อก

**A:** `xattr -d com.apple.quarantine ./obscura`

### Q: ใช้ `--eval` แล้วได้ `null`

**A:** ใช้ IIFE pattern: `(function(){...})()` แทนการเขียน `const`/`let` ที่ top-level

### Q: เจอ Cloudflare challenge

**A:** ใช้ `--stealth` + `--wait-until networkidle2` + `--wait 10` ถ้ายังไม่ผ่าน แสดงว่าเป็น Under Attack mode — ต้องใช้ Chromium จริงแทน

### Q: Scrape หลาย URL แล้ว error

**A:** ใช้ `--concurrency` ต่ำลง, เพิ่ม `--timeout`, หรือใช้ `obscura serve` + Puppeteer/Playwright แทน

### Q: ต้องการ screenshot

**A:** Obscura ไม่รองรับ pixel rendering ใช้ headless Chrome + screenshot tool แยก

### Q: Cookies ไม่ persist ข้าม session

**A:** ใช้ `--storage-dir` กำหนด path ที่เก็บ cookies ไว้

---

## 16. สรุป

### Obscura เหมาะกับใคร?

| กลุ่ม | เหมาะ? | เหตุผล |

|------|:------:|--------|

| 🕷️ **Web Scraper** | ✅ **เหมาะมาก** | เร็ว, เบา, stealth, markdown output |

| 🤖 **AI Agent** | ✅ **เหมาะมาก** | MCP native, CLI ใช้ง่าย, resource ต่ำ |

| 🧪 **QA / Test Automation** | ⚠️ **บางส่วน** | Puppeteer/Playwright CDP ได้ แต่ไม่มี screenshot |

| 🔬 **Data Scientist** | ✅ **เหมาะ** | Extract markdown/link/cookie ได้เร็ว |

| 🏭 **Production Scraping** | ✅ **เหมาะ** | Docker, systemd, worker scaling, timeouts ครบ |

### จุดเด่นที่สุดของ Obscura

1. **เร็วและเบา** — 30MB RAM, 70MB binary, startup instant — น้อยกว่า Chrome Headless 10x

2. **Stealth ในตัว** — ไม่ต้องหา proxy/extension เพิ่ม

3. **MCP Protocol** — AI Agent ใช้ browser ได้โดยตรง

4. **Binary เดียว** — deploy ง่ายสุดๆ

### จุดอ่อนที่ต้องระวัง

1. **ไม่มี pixel rendering** — screenshot, PDF ไม่ได้

2. **ไม่ bypass Cloudflare หนัก** — ต้องมี Chromium จริงสำรอง

3. **V8 Isolate แชร์กัน** — JS หนักๆ ในหน้าเดียวกระทบหน้าอื่น

### คำแนะนำในการเลือกใช้

```

หน้าเว็บทั่วไป → Obscura (เร็ว, เบา)

หน้าเว็บมี Cloudflare → Obscura + --stealth

หน้าเว็บมี CF Under Attack → Fallback ไป Chromium จริง

ต้องการ Screenshot → Obscura ไม่ได้ ใช้ tool อื่น

ต้องการ Interactive browser session → Obscura MCP หรือ serve

```

---

> 📝 **ท้ายบทความ:** Obscura เป็นเครื่องมือที่เปลี่ยนวิธีคิดเรื่อง headless browser ไปเลย จากที่เคยต้องพึ่ง Chromium 300MB+ ตอนนี้เรามี binary 70MB ที่ทำงานได้เร็วกว่าและกินทรัพยากรน้อยกว่า เหมาะมากสำหรับยุคที่ AI Agent ต้องเปิดเว็บอ่านข้อมูลเป็นร้อยเป็นพันครั้งต่อวัน!

> 🔗 **ลิงก์ที่เกี่ยวข้อง:**

> - Docs: https://docs.obscura.sh/

> - GitHub: https://github.com/h4ckf0r0day/obscura

> - Releases: https://github.com/h4ckf0r0day/obscura/releases

> - Issues: https://github.com/h4ckf0r0day/obscura/issues