web-automation-server

Web Automation Server

Web Automation Server là một công cụ mạnh mẽ cho phép tự động hóa các thao tác trong trình duyệt thông qua API RESTful. Sử dụng Playwright làm nền tảng, server này cho phép bạn điều khiển trình duyệt, thực hiện các hành động như click, điều hướng, nhập liệu, và chụp ảnh màn hình.

Sử dụng thông qua NPX

Bạn có thể chạy Web Automation Server trực tiếp bằng npx mà không cần cài đặt:

npx web-automation-server

Server sẽ khởi động trên cổng 3100 (mặc định).

Cài đặt toàn cục

Nếu bạn muốn cài đặt toàn cục:

npm install -g web-automation-server

Sau đó chạy:

web-automation-server

Tài liệu API

1. Khởi tạo session trình duyệt

POST http://localhost:3100/api/session/start
Content-Type: application/json

{
  "projectId": "my-project",
  "options": {
    "browserType": "chromium",
    "headless": false
  }
}

2. Điều hướng đến một trang web

POST http://localhost:3100/api/navigate
Content-Type: application/json

{
  "projectId": "my-project",
  "url": "https://example.com"
}

3. Click vào phần tử

POST http://localhost:3100/api/click
Content-Type: application/json

{
  "projectId": "my-project",
  "selector": "#submit-button"
}

4. Nhập text

POST http://localhost:3100/api/type
Content-Type: application/json

{
  "projectId": "my-project",
  "selector": "#username",
  "text": "testuser"
}

5. Chụp ảnh màn hình

POST http://localhost:3100/api/screenshot
Content-Type: application/json

{
  "projectId": "my-project"
}

6. Thực hiện chuỗi hành động

POST http://localhost:3100/api/actions/sequence
Content-Type: application/json

{
  "projectId": "my-project",
  "actions": [
    { "type": "navigate", "params": { "url": "https://example.com" } },
    { "type": "click", "params": { "selector": "#button" } }
  ]
}

7. Lưu cấu hình tùy chỉnh

POST http://localhost:3100/api/project/config
Content-Type: application/json

{
  "projectId": "my-project",
  "config": {
    "actions": {
      "login": [
        { "type": "navigate", "params": { "url": "https://example.com/login" } },
        { "type": "type", "params": { "selector": "#username", "text": "${username}" } },
        { "type": "type", "params": { "selector": "#password", "text": "${password}" } },
        { "type": "click", "params": { "selector": "#login-button" } }
      ]
    }
  }
}

8. Thực hiện hành động đã cấu hình

POST http://localhost:3100/api/project/action
Content-Type: application/json

{
  "projectId": "my-project",
  "actionId": "login",
  "params": {
    "username": "testuser",
    "password": "password123"
  }
}

9. Đóng session

POST http://localhost:3100/api/session/close
Content-Type: application/json

{
  "projectId": "my-project"
}

Yêu cầu hệ thống

• Node.js >= 16.0.0
• Các trình duyệt sẽ được tự động cài đặt khi khởi động server

License

MIT