feat: implement FastAPI service with device-locked automation for Shopee commissions and Facebook commenting

2026-07-23 12:22:15 +07:00
parent 3d00741e7b
commit 2bd6cfef55
1558 changed files with 389 additions and 191545 deletions
@@ -0,0 +1,99 @@
+# Bot Affiliate & Auto Comment - N8N Integration API
+
+Đây là máy chủ API viết bằng Python (FastAPI + UIAutomator2) dùng để điều khiển điện thoại Android tự động thực hiện các thao tác:
+1. **Shopee Affiliate**: Nhận link sản phẩm, tự động mở Shopee, chuyển đổi link lấy hoa hồng và trả về n8n.
+2. **Facebook Auto Comment**: Mở Group Facebook, tự động tìm bài viết, comment nội dung kèm hình ảnh động từ n8n.
+
+## 1. Cài đặt và Khởi động
+Dự án yêu cầu cài đặt môi trường ảo (venv) và các thư viện trong `requirements.txt`.
+
+**Khởi động Server:**
+Máy chủ đã được cài đặt như một Systemd Service (chạy ngầm tự động).
+- Bắt đầu service: `systemctl start shopeebot`
+- Xem trạng thái: `systemctl status shopeebot`
+- Khởi động lại khi sửa code: `systemctl restart shopeebot`
+- Xem log hoạt động: `journalctl -u shopeebot -f` hoặc xem file `shopee_bot.log`
+
+---
+
+## 2. Các API Endpoints cho N8N
+
+### 2.1. API Lấy link Shopee Affiliate
+- **URL**: `POST /get_commission`
+- **Body (JSON)**:
+  ```json
+  {
+    "link": "https://s.shopee.vn/...",
+    "device_ip": "10.160.138.2:5555" 
+  }
+  ```
+  *(Lưu ý: `device_ip` là tùy chọn, nếu bỏ trống Bot sẽ tự lấy IP mặc định)*
+
+- **Kết quả trả về**:
+  ```json
+  {
+    "status": "success",
+    "commission": "10.5%",
+    "affiliate_link": "https://s.shopee.vn/xyz...",
+    "price": "đ90.000",
+    "message": "Trích xuất thành công"
+  }
+  ```
+
+### 2.2. API Tự động Comment Facebook
+- **URL**: `POST /post_facebook_comment`
+- **Body (JSON)**:
+  ```json
+  {
+    "device_ip": "10.160.138.2:5555",
+    "group_id": "123456789",
+    "content": "Nội dung comment mà bạn muốn gõ...",
+    "image_url": "https://example.com/anh.jpg"
+  }
+  ```
+  *(Lưu ý: `image_url` là tùy chọn, nếu bài nào không cần ảnh thì không cần gửi trường này).*
+
+- **Luồng hoạt động**:
+  1. Python tải ảnh về và đẩy vào thư viện Android.
+  2. Dùng Deep Link mở thẳng vào Group.
+  3. Bấm "Bình luận" ở bài viết đầu tiên.
+  4. Gõ Text, chọn ảnh vừa tải và bấm "Gửi".
+  5. Xóa ảnh tạm để dọn dẹp bộ nhớ.
+
+---
+
+## 3. Quản lý Màn Hình Điện Thoại (Chống chạm nhầm)
+
+Để điện thoại chạy Auto mượt mà 24/7 mà không bị ai chạm nhầm vào màn hình và không tốn pin, hãy dùng 2 script có sẵn:
+
+1. **Tắt đen màn hình & Khóa cảm ứng**:
+   Chạy lệnh: `./disable_screen.sh`
+   *(Màn hình vật lý sẽ đen thui, không thể bấm, nhưng Bot vẫn chạy ngầm bên trong)*
+
+2. **Bật lại màn hình bình thường**:
+   Chạy lệnh: `./enable_screen.sh`
+
+3. **Chống điện thoại tự khóa (Sleep/Lock screen)**:
+   Chạy lệnh ADB sau để ép điện thoại thức vĩnh viễn:
+   ```bash
+   adb -s 10.160.138.2:5555 shell svc power stayon true
+   ```
+   *(Muốn tắt chức năng này thì đổi chữ `true` thành `false`).*
+
+
+
+💡 Mẹo thiết lập trên n8n: Thay vì phải nhớ từng ID, bạn nên lập một file Google Sheet.
+Google Sheet: https://docs.google.com/spreadsheets/d/1Oje_uRqSd3pKf0hrE5M10Aqq9gEp-qHvGmtIkrq86fU/edit?usp=sharing
+(Tên Group	Group ID	Content	Link hình đính kèm)
+
+
+Cột A: Tên Group (Để bạn tự nhớ).
+Cột B: Group ID (Dãy số).
+Cột C: Link bài viết (Nếu cần lưu). Sau đó cho n8n đọc Google Sheet này, lấy giá trị ở Cột B rồi bắn sang cho Python Bot. Chạy vòng lặp (Loop) là Bot sẽ tự động nhảy hết từ Group này sang Group khác để rải Comment!
+
+
+
+Client ID: 745351236177-ibrcl3j2d9oi2malj3fpatfu6il2290b.apps.googleusercontent.com
+Client secret: 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
+( C:\Users\NASPC\Documents\botAffilate\facebook\client_secret_745351236177-ibrcl3j2d9oi2malj3fpatfu6il2290b.apps.googleusercontent.com.json )
+