🧠 AUTO BROWSER CONTROLLER (ABC)

Phiên bản: v1.4.2
Trang tải chính thức: https://auto.pada.vn/download

🎯 1. Mục đích

Phần mềm Auto Browser Controller (ABC) cho phép n8n (hoặc hệ thống tự động hóa khác) điều khiển trình duyệt Chrome từ xa thông qua KÊNH liên lạc giữa hai bên — giúp thực hiện các thao tác như mở trang, click, gõ text, trích xuất dữ liệu, v.v.

⚙️ KHỞI ĐỘNG ỨNG DỤNG

✅ Cách 1 — Kết nối qua Cloud (khuyến nghị cho n8n)

Cách này đảm bảo tương thích 100% với mọi hệ thống n8n, không cần cấu hình thêm.

Tải ứng dụng từ https://auto.pada.vn/download.
Ví dụ: auto-v1.4.2.exe
Mở CMD hoặc PowerShell và chạy lệnh
(đương nhiên cần cd đến thư mục chứa file auto-v1.4.2.exe trước):
```
auto-v1.4.2.exe ID_KÊNH_CỦA_BẠN
```
(ID_KÊNH_CỦA_BẠN có thể đăng ký miễn phí tại https://auto.pada.vn/dang-ky-kenh.html)
Hoặc, nhấn đúp để mở ứng dụng → khi được hỏi, nhập ID KÊNH thủ công.

📡 Sau khi kết nối thành công, n8n có thể gửi truy vấn điều khiển đến:

https://auto.pada.vn

⚙️ Cách 2 — Chạy LOCAL (dành cho người có kinh nghiệm kỹ thuật)

Cách này phù hợp nếu bạn muốn chạy ABC trên chính máy tính của mình, không cần kết nối Internet.

Tải ứng dụng và nhấn đúp để mở.
Khi ứng dụng hỏi “Nhập ID kênh hoặc cổng localhost tại đây”, nhập số cổng (PORT) mong muốn, ví dụ:
```
3000
```
Controller sẽ khởi động tại địa chỉ:
```
http://localhost:3000
```
Từ n8n, dùng node HTTP Request hoặc Webhook để gửi yêu cầu đến các endpoint tương ứng.

🔗 DANH SÁCH ENDPOINT (CHO N8N)

Tất cả các ví dụ bên dưới có thể áp dụng cả ở môi trường Cloud (auto.pada.vn) và Local (localhost:PORT).
Chỉ cần thay phần domain tương ứng.

👉 Lưu ý: Khi sử dụng môi trường Cloud (qua https://auto.pada.vn), hãy thêm thuộc tính sau vào phần body của mọi request:

"channel": "ID_KÊNH_CỦA_BẠN"

1️⃣ `/r/start-browser`

Mục đích: Khởi động và kết nối Chrome
Phương thức: POST

{
    "url": "https://auto.pada.vn/r/start-browser",
    "method": "POST",
    "body": {
        "channel": "ID_KÊNH_CỦA_BẠN",
        "headless": true,
        "debuggingPort": "9222",
        "welcomeUrl": "https://google.com"
    },
    "responseFormat": "json"
}

Kết quả mẫu:

{
    "success": true,
    "message": "Chrome started and connected",
    "pid": 13452
}

2️⃣ `/r/new-tab`

Tạo tab mới

{
    "url": "https://auto.pada.vn/r/new-tab",
    "method": "POST",
    "body": { "channel": "ID_KÊNH_CỦA_BẠN" }
}

Phản hồi mẫu:

{ "success": true, "tabID": "mb7j6k5x" }

3️⃣ `/r/go-to`

Điều hướng đến URL

{
    "url": "https://auto.pada.vn/r/go-to",
    "method": "POST",
    "body": {
        "channel": "ID_KÊNH_CỦA_BẠN",
        "tabID": "mb7j6k5x",
        "url": "https://example.com"
    }
}

4️⃣ `/r/click`

Click vào phần tử

{
    "url": "https://auto.pada.vn/r/click",
    "method": "POST",
    "body": {
        "channel": "ID_KÊNH_CỦA_BẠN",
        "tabID": "mb7j6k5x",
        "selector": "#login-button"
    }
}

5️⃣ `/r/type`

Gõ văn bản vào ô input

{
    "url": "https://auto.pada.vn/r/type",
    "method": "POST",
    "body": {
        "channel": "ID_KÊNH_CỦA_BẠN",
        "tabID": "mb7j6k5x",
        "selector": "#username",
        "text": "pada.vn"
    }
}

6️⃣ `/r/wait-for-selector`

Chờ phần tử xuất hiện

{
    "url": "https://auto.pada.vn/r/wait-for-selector",
    "method": "POST",
    "body": {
        "channel": "ID_KÊNH_CỦA_BẠN",
        "tabID": "mb7j6k5x",
        "selector": "#success-message"
    }
}

7️⃣ `/r/evaluate`

Chạy đoạn script JS trong trang

{
    "url": "https://auto.pada.vn/r/evaluate",
    "method": "POST",
    "body": {
        "channel": "ID_KÊNH_CỦA_BẠN",
        "tabID": "mb7j6k5x",
        "fn": "(() => document.title)"
    }
}

8️⃣ `/r/close-tab`

Đóng tab hiện tại

{
    "url": "https://auto.pada.vn/r/close-tab",
    "method": "POST",
    "body": { 
        "channel": "ID_KÊNH_CỦA_BẠN",
        "tabID": "mb7j6k5x"
    }
}

9️⃣ `/r/check-browser`

Kiểm tra trạng thái kết nối Chrome

{
    "url": "https://auto.pada.vn/r/check-browser",
    "method": "POST",
    "body": { "channel": "ID_KÊNH_CỦA_BẠN" }
}

🔟 `/r/cookies`

Lấy danh sách cookies của tab

{
            "url": "https://auto.pada.vn/r/cookies",
            "method": "POST",
            "body": {
                "channel": "ID_KÊNH_CỦA_BẠN",
                "tabID": "mb7j6k5x"
            }
        }

Phản hồi mẫu:

{
            "success": true,
            "cookies": [
                {
                    "name": "sessionid",
                    "value": "abc123",
                    "domain": ".example.com",
                    "path": "/",
                    "expires": 1712345678,
                    "httpOnly": true,
                    "secure": true
                }
            ]
        }

1️⃣1️⃣ `/r/set-cookie`

Đặt cookies cho tab

{
            "url": "https://auto.pada.vn/r/set-cookie",
            "method": "POST",
            "body": {
            "channel": "ID_KÊNH_CỦA_BẠN",
            "tabID": "mb7j6k5x",
            "cookies": [
                {
                "name": "sessionid",
                "value": "abc123",
                "domain": ".example.com",
                "path": "/",
                "expires": 1712345678,
                "httpOnly": true,
                "secure": true
                }
            ]
            }
        }

Phản hồi mẫu:

{
            "success": true
        }

Lưu ý: Bạn có thể truyền cookies dưới dạng chuỗi JSON (string) thay vì mảng.
Nếu truyền chuỗi, cú pháp phải là một mảng JSON hợp lệ.
Ví dụ:

{
            "url": "https://auto.pada.vn/r/set-cookie",
            "method": "POST",
            "body": {
            "channel": "ID_KÊNH_CỦA_BẠN",
            "tabID": "mb7j6k5x",
            "cookies": "[{\"name\":\"sessionid\",\"value\":\"abc123\",\"domain\":\".example.com\",\"path\":\"/\",\"expires\":1712345678,\"httpOnly\":true,\"secure\":true}]"
            }
        }

Nếu truyền chuỗi không đúng cú pháp mảng JSON, hệ thống sẽ trả về lỗi.
Khuyến nghị: Luôn kiểm tra kỹ định dạng trước khi gửi.

1️⃣2️⃣ `/r/reload`

Reload lại tab hiện tại

{
            "url": "https://auto.pada.vn/r/reload",
            "method": "POST",
            "body": {
                "channel": "ID_KÊNH_CỦA_BẠN",
                "tabID": "mb7j6k5x",
                "options": {
                    "timeout": 30000,
                    "waitUntil": "load"
                }
            }
        }

Phản hồi mẫu:

{
            "success": true
        }

🧩 GỢI Ý ỨNG DỤNG TRONG N8N

Bạn có thể tạo Workflow tự động như sau:

HTTP Request → /r/start-browser → mở Chrome
HTTP Request → /r/new-tab → mở tab mới
HTTP Request → /r/go-to → truy cập website mục tiêu
HTTP Request → /r/type + /r/click → nhập form & click gửi
HTTP Request → /r/evaluate → trích xuất dữ liệu
HTTP Request → /r/close-tab → đóng tab sau khi hoàn tất

🧭 GHI CHÚ QUAN TRỌNG

Địa chỉ chính thức cho mọi truy vấn từ n8n:
👉 https://auto.pada.vn/r/:endpoint
Nếu dùng local:
👉 http://localhost:PORT/r/:endpoint
Mỗi KÊNH là một đường liên lạc riêng giữa n8n và Controller — bạn có thể tạo nhiều kênh cho nhiều workflow khác nhau.
Tất cả request đều dùng phương thức POST và body JSON.
Auto Browser Controller (ABC) hỗ trợ cả chế độ headless và hiển thị giao diện Chrome.

💬 Comments

Tham gia nhóm chat Zalo AUTO.PADA.VN để thảo luận:
https://zalo.me/g/qbpqjt679

Hoặc để lại bình luận, góp ý, câu hỏi bên dưới.

🧠 AUTO BROWSER CONTROLLER (ABC)

🎯 1. Mục đích

⚙️ KHỞI ĐỘNG ỨNG DỤNG

✅ Cách 1 — Kết nối qua Cloud (khuyến nghị cho n8n)

⚙️ Cách 2 — Chạy LOCAL (dành cho người có kinh nghiệm kỹ thuật)

🔗 DANH SÁCH ENDPOINT (CHO N8N)

1️⃣ /r/start-browser

2️⃣ /r/new-tab

3️⃣ /r/go-to

4️⃣ /r/click

5️⃣ /r/type

6️⃣ /r/wait-for-selector

7️⃣ /r/evaluate

8️⃣ /r/close-tab

9️⃣ /r/check-browser

🔟 /r/cookies

1️⃣1️⃣ /r/set-cookie

1️⃣2️⃣ /r/reload

🧩 GỢI Ý ỨNG DỤNG TRONG N8N

🧭 GHI CHÚ QUAN TRỌNG

💬 Comments

1️⃣ `/r/start-browser`

2️⃣ `/r/new-tab`

3️⃣ `/r/go-to`

4️⃣ `/r/click`

5️⃣ `/r/type`

6️⃣ `/r/wait-for-selector`

7️⃣ `/r/evaluate`

8️⃣ `/r/close-tab`

9️⃣ `/r/check-browser`

🔟 `/r/cookies`

1️⃣1️⃣ `/r/set-cookie`

1️⃣2️⃣ `/r/reload`