• Blog
  • Docs
  • Pricing
  • We’re hiring!
Log inSign up
minhnguyen00

minhnguyen00

bb_agent

Public
Like
bb_agent
Home
Code
7
frontend
2
services
2
storage
2
tasks
1
README.md
browser.ts
H
main.ts
Connections
Environment variables
6
Branches
1
Pull requests
Remixes
History
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
README.md
Code
/
README.md
Search
…
Viewing readonly version of main branch: v22
View latest version
README.md

🤖 BB Agent

Hệ thống tự động hóa trình duyệt dùng Browserbase (remote Chrome) + 5sim (SMS OTP) + 2Captcha (giải captcha) + OpenAI (AI agent).

🏗️ Kiến trúc

Rendering mermaid diagram...

📁 Cấu trúc

bb_agent/
├── main.ts              ← HTTP entrypoint, Dashboard, API routes
├── browser.ts           ← BrowserManager (kết nối Browserbase qua CDP)
├── tasks/
│   └── register.ts      ← Task đăng ký tài khoản (Google skeleton)
├── services/
│   ├── sms.ts           ← 5sim.net API (mua số, chờ OTP)
│   └── captcha.ts       ← 2Captcha API (reCAPTCHA v2/v3, Turnstile, image)
└── storage/
    ├── db.ts            ← SQLite schema + queries
    └── csv.ts           ← Đọc/ghi CSV qua SQLite

🔑 Environment Variables

KeyMô tảTrạng thái
BROWSERBASE_API_KEYAPI key Browserbase✅ Đã set
BROWSERBASE_PROJECT_IDProject ID Browserbase✅ Đã set
FIVESIM_API_KEYJWT token 5sim.net⚠️ Cần kiểm tra (xem bên dưới)
TWOCAPTCHA_API_KEY32-char key từ 2captcha.com❌ Chưa set
OPENAI_API_KEYAPI key proxy simpleverse✅ Đã set

⚠️ Fix 5sim Key

5sim JWT token bị cắt ngắn khi copy. Lấy lại tại: https://5sim.net/settings/profile
→ Section "API KEY" → Copy toàn bộ JWT → Cập nhật env var FIVESIM_API_KEY

❌ Fix 2Captcha Key

Lấy API key tại: https://2captcha.com/setting
→ Cập nhật env var TWOCAPTCHA_API_KEY (dạng 32 ký tự, ví dụ: abc123def456...)

📡 API Endpoints

Base URL

https://minhnguyen00--08404dd62b7f11f18d7a42dde27851f2.web.val.run

GET /health

Kiểm tra tất cả service connections:

curl https://minhnguyen00--08404dd62b7f11f18d7a42dde27851f2.web.val.run/health

POST /task/browser-test

Test kết nối Browserbase (mở Google, lấy title):

curl -X POST https://.../task/browser-test

Response:

{ "success": true, "title": "Google", "sessionId": "...", "replayUrl": "https://browserbase.com/sessions/..." }

POST /task/register

Đăng ký tài khoản mới:

curl -X POST https://.../task/register \ -H "Content-Type: application/json" \ -d '{ "platform": "google", "country": "any", "operator": "any" }'

Platforms hỗ trợ hiện tại: google (skeleton)
TODO thêm: shopee, facebook, tiktok, instagram, lazada...

POST /csv/upload

Upload file CSV:

curl -X POST https://.../csv/upload \ -F "file=@accounts.csv" \ -F "name=accounts" \ -F "separator=,"

GET /csv/list

curl https://.../csv/list

GET /csv/:name

Download CSV:

curl https://.../csv/accounts -o accounts.csv

GET /accounts

curl "https://.../accounts?platform=google&status=active"

GET /logs

curl "https://.../logs?limit=50"

🚀 Roadmap

Phase 1 (hiện tại) ✅

  • BrowserManager → Browserbase CDP
  • SMS service → 5sim
  • Captcha service → 2Captcha (reCAPTCHA v2/v3, Turnstile, image)
  • SQLite storage (accounts, logs, CSV, queue)
  • CSV đọc/ghi
  • HTTP API Gateway + Dashboard
  • Task skeleton: đăng ký Google

Phase 2 (tiếp theo)

  • Fix 5sim + 2Captcha credentials → test health = ✅
  • Test /task/browser-test end-to-end
  • Thêm flow đăng ký Shopee, Facebook
  • tasks/warmup.ts — nuôi tài khoản (duyệt web, like, scroll)
  • tasks/listing.ts — đăng sản phẩm

Phase 3

  • AI Agent (OpenAI) tự phân tích DOM và quyết định action
  • Interval val — chạy warmup định kỳ
  • Proxy support (Browserbase proxies)
  • Multi-account parallel execution

⚡ Giới hạn Val Town cần biết

Giới hạnGiá trịGiải pháp
HTTP timeout30 giâyDùng Interval val cho task dài
Không có filesystem-Dùng SQLite/Blob thay file
Cold start~100msWarm instance sau request đầu
Browserbase session timeoutTheo plankeepAlive option
FeaturesVersion controlCode intelligenceCLIMCP
Use cases
TeamsAI agentsSlackGTM
DocsShowcaseTemplatesNewestTrendingAPI examplesNPM packages
AboutAlternativesPricingBlogNewsletterCareers
We’re hiring!
Brandhi@val.townStatus
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Open Source Pledge
Terms of usePrivacy policyAbuse contact
© 2026 Val Town, Inc.