YouTube Automation Agent là dự án mã nguồn mở dùng các AI agent để tự động hóa gần như toàn bộ quy trình vận hành kênh YouTube — từ nghiên cứu chủ đề, viết kịch bản, tạo thumbnail, tối ưu SEO đến đăng tải, lên lịch và phân tích hiệu suất. Hệ thống chạy trên Node.js 18+, có dashboard local tại http://localhost:3456, hỗ trợ OpenAI hoặc Gemini (và mở rộng được cho Claude hoặc model local qua Ollama).
Kiến trúc: chuỗi 6 agent
Điểm mạnh của dự án là chia quy trình thành các agent chuyên trách, đầu ra của agent trước là đầu vào của agent sau:
- Content Strategy — phân tích xu hướng, tìm chủ đề, lập kế hoạch nội dung.
- Script Writer — viết hook, kịch bản, storytelling, CTA.
- Thumbnail Designer — tạo thumbnail, thử nhiều hướng thiết kế.
- SEO Optimizer — tối ưu title, description, keyword, tag.
- Publishing — tải lên, lên lịch, quản lý playlist và end screen.
- Analytics — thu thập dữ liệu, đánh giá và đề xuất tối ưu.
Mô hình này hợp với kênh giáo dục, công nghệ, gaming, kể chuyện. Với kênh tiếng Việt, nên bổ sung quy tắc về giọng văn, thuật ngữ, cách viết số và tên riêng để giảm lỗi AI.
Yêu cầu & cài đặt
Chuẩn bị: Node.js 18+, Google Cloud Project (bật YouTube Data API v3, tạo OAuth Client ID – Desktop app), key API của OpenAI/Gemini, và dung lượng lưu trữ cho video/thumbnail/log. Lưu ý: YouTube API tính bằng quota (mặc định 10.000 units/ngày), nên phải cache kết quả và tránh vòng lặp gọi API vô hạn — vượt giới hạn sẽ gặp lỗi 403 quotaExceeded.
Quy trình:
git clone https://github.com/darkzOGx/youtube-automation-agent.git
cd youtube-automation-agent
npm install
cp .env.example .env
cp config/credentials.example.json config/credentials.json
npm run setup
npm start
npm run setup là trình thiết lập tương tác: cấu hình kênh, AI provider, lịch đăng và xác thực YouTube. Không nên commit .env hay credentials.json lên Git.
Cấu hình & thử video đầu tiên
Các biến môi trường quan trọng:
YOUTUBE_REGION=VN
DEFAULT_PRIVACY_STATUS=private
CHANNEL_NAME="Tên kênh của bạn"
TARGET_AUDIENCE="Lập trình viên và người làm công nghệ"
POSTING_FREQUENCY=daily
Giai đoạn kiểm thử nên để private/unlisted thay vì public để rà soát video, thumbnail, phụ đề, metadata và bản quyền trước khi công khai.
Tạo video đầu tiên qua endpoint:
curl -X POST http://localhost:3456/generate -H "Content-Type: application/json" \
-d '{"topic":"Docker cho người mới bắt đầu","style":"tutorial"}'
Kiểm tra thêm qua /schedule, /analytics, /health.
Tùy biến cho kênh tiếng Việt
Edit agents/content-strategy-agent.js và utils/ai-service.js để mở rộng workflow (ví dụ: yêu cầu agent tạo outline trước, kiểm tra lệnh shell, đối chiếu phiên bản thư viện rồi mới viết kịch bản hoàn chỉnh).
Các "luật an toàn" nên thêm:
- Không phát định lượng không có nguồn kiểm chứng.
- Không sao chép nguyên văn nội dung có bản quyền.
- Đánh dấu nội dung AI khi nền tảng yêu cầu.
- Thumbnail không dùng logo/khuôn mặt trái phép.
- Duyệt thủ công trước khi bật
public.
Với kênh đa ngôn ngữ, tách prompt và content calendar theo từng locale thay vì dịch máy cả workflow.
Triển khai: local, Pi, hay VPS?
- Local: đơn giản nhất, miễn phí hosting — nhưng máy phải bật đúng giờ lịch chạy.
- Raspberry Pi: hợp với scheduler nhẹ; render video/xử lý file lớn vẫn cần máy mạnh hơn.
- VPS: chạy liên tục nhưng cần HTTPS (reverse proxy, VPN/SSH tunnel), firewall, backup và process manager.
Xử lý lỗi thường gặp
Kiểm tra lần lượt: API key/model/timeout → YouTube quota (giảm search.list, bật cache) → OAuth token & quyền kênh (publishing) → process/port/firewall (dashboard) → prompt/temperature/độ dài (chất lượng AI). Bật debug với:
NODE_ENV=development DEBUG_MODE=true npm start
Khi báo lỗi, che token trước khi đăng lên Issue.
Giới hạn & chính sách
Đây là công cụ tối ưu quy trình, không phải "công thức viral". AI đóng vai trợ lý sản xuất: AI tìm ý tưởng, tạo bản nháp, chuẩn bị tài sản; người vận hành chịu trách nhiệm kiểm chứng, biên tập và quyết định xuất bản — đặc biệt với nội dung tin tức, sức khỏe, tài chính, trẻ em, hoặc dùng giọng nói/hình ảnh tổng hợp. Kênh muốn kiếm tiền vẫn phải tuân thủ Community Guidelines, chính sách bản quyền và điều khoản API của YouTube.
Để lại một bình luận