📘 HƯỚNG DẪN CÀI ĐẶT MÔI TRƯỜNG CHẠY AUTO-POST (NODE.JS & PUPPETEER)

Dành cho: Đặng Xuân Thành | Dự án: Amazon KDP Automation

1. Cài đặt Node.js (Nền tảng chạy script)

npm là trình quản lý gói đi kèm với Node.js. Nếu không có Node.js, lệnh npm sẽ không tồn tại.

• Bước 1.1: Truy cập nodejs.org.

• Bước 1.2: Chọn bản LTS (viết tắt của Long Term Support – Bản ổn định nhất).

• Bước 1.3: Mở file .msi vừa tải về.

• Bước 1.4: Bấm Next liên tục.

  • Lưu ý: Ở bước có ô check nội dung “Automatically install the necessary tools”, anh nên tích vào đó để nó tự cài thêm các công cụ hỗ trợ cần thiết.

• Bước 1.5: Sau khi cài xong, anh BẮT BUỘC phải tắt toàn bộ các cửa sổ CMD đang mở và mở lại cái mới để Windows nhận diện lệnh.

2. Kiểm tra cài đặt thành công

Mở CMD (Windows + R -> gõ cmd), nhập lần lượt 2 lệnh sau:

node -v
npm -v

Kết quả: Nếu hiện ra các con số (VD: v20.12.1 và 10.5.0) là máy anh đã “thông suốt”.

3. Cài đặt Puppeteer vào dự án (Chỉ làm một lần cho mỗi dự án)

Puppeteer là thư viện giúp anh điều khiển trình duyệt Chrome tự động (giống như có người ngồi click hộ).

• Bước 3.1: Di chuyển vào thư mục code của anh (VD: thư mục kdp_factory trên XAMPP).

  • Trong CMD, gõ: cd C:\xampp\htdocs\kdp_factory

• Bước 3.2: Chạy lệnh cài đặt:

  Bash

  npm install puppeteer
  

  • Lưu ý: Quá trình này sẽ tải về một bản Chromium (trình duyệt chạy ngầm), khoảng 100-200MB nên anh đợi một lát nhé.

4. Cách chạy thử script Auto-Post

Sau khi đã cài xong xuôi, mỗi khi anh muốn chạy script đăng bài (ví dụ file uploader.js), anh chỉ cần gõ trong CMD:

node uploader.js

💡 Một số lỗi thường gặp & Cách xử lý (Dành cho anh Thành):

1. Lỗi ‘npm’ is not recognized: Do anh chưa khởi động lại CMD sau khi cài Node.js. Nếu khởi động lại vẫn bị, hãy restart máy tính.

2. Lỗi quyền (Permission Denied): Hãy chạy CMD bằng quyền quản trị (Run as Administrator).

3. Lỗi “Missing dependencies”: Thường xảy ra trên Linux/Server, nhưng trên Windows của anh thì cứ cài bản LTS là đủ hết.