Facebook Automation via PinchTab

Đăng bài Facebook (wall/group) + đính kèm ảnh + tag bạn bè qua PinchTab browser control.

Prerequisites

• PinchTab installed và server đang chạy (pinchtab server &)
• Một PinchTab profile có Facebook login session (cookies đã lưu từ lần login thủ công trước)
• Bật pinchtab config set security.allowEvaluate true (bắt buộc cho image upload, khuyến khích cho text input)
• macOS: khuyến khích brew install coreutils (cung cấp gtimeout). Không bắt buộc, script có pure-bash fallback

Nếu user chưa login: hướng dẫn start headed instance → login thủ công → reuse profile.

Script Usage

Script: scripts/fb-post.sh

# Positional syntax
bash scripts/fb-post.sh "<content>" [options]

# Named syntax
bash scripts/fb-post.sh --content "<content>" [options]

Parameters:

Param	Required	Default	Description
<content>	Yes	—	Post content (positional arg hoặc --content)
--profile	No	default	PinchTab profile name
--user-id	No	100003782705460	Facebook numeric ID (wall mode)
--group	No	—	Group slug hoặc full URL → post vào group thay vì wall
--title	No	—	Tiêu đề bài viết (chỉ group, hiển thị bold phía trên nội dung)
--image	No	—	Đường dẫn ảnh đính kèm (dùng nhiều lần cho nhiều ảnh, tối đa 8)
--tag	No	—	Tên hiển thị của bạn bè cần tag
--tag-id	No	—	Facebook ID của bạn bè (chính xác hơn search theo tên)
--publish	No	false	true = đăng ngay, false = chỉ soạn (user review trước)
--mode	No	headless	headed = hiển thị browser, headless = chạy nền
--debug	No	false	Chụp screenshot mỗi bước vào /tmp/ (flag, không cần value: --debug)
--dry-run	No	—	Log actions mà không mở browser (kiểm tra params)
--keep-instance	No	—	Giữ browser instance sau khi xong (dùng cho chain nhiều posts)

Post lên Wall

bash scripts/fb-post.sh "Hello world!"
bash scripts/fb-post.sh "Hello!" --tag "Hoang Van Tuan" --publish true

Post với ảnh đính kèm

bash scripts/fb-post.sh "Check this out!" --image /path/to/photo.jpg --publish true
bash scripts/fb-post.sh "Ảnh đẹp!" --image photo1.jpg --image photo2.jpg --tag "Ngoc" --group tuhoccungai --publish true

Post vào Group

bash scripts/fb-post.sh "Hello group!" --group tuhoccungai --publish true
bash scripts/fb-post.sh "Nội dung" --group "https://www.facebook.com/groups/tuhoccungai" --keep-instance --publish true
bash scripts/fb-post.sh "Nội dung bài viết" --title "[Series AI Agent] Vòng lặp nghĩ-làm" --group tuhoccungai --publish true

Exit Codes & Lỗi thường gặp

Code	Meaning	Nguyên nhân & cách xử lý
0	Thành công	—
1	Sai arguments	Thiếu content, --user-id nhận vanity URL thay vì numeric ID, file ảnh không tồn tại hoặc sai format (script validate magic bytes trước khi mở browser)
2	Instance failure	PinchTab chưa chạy (pinchtab server &) hoặc profile không tồn tại
3	Element not found	FB UI thay đổi, group URL sai, không có quyền. Dùng --debug kiểm tra screenshot
4	Publish failed	Nút đăng không tìm thấy
5	Upload failed	security.allowEvaluate tắt → pinchtab config set security.allowEvaluate true. Ảnh dispatch nhưng không attach → verify blob: URL trong 10s
6	Missing dependency	Thiếu binary cần thiết (pinchtab, python3, curl, xxd). Log ghi rõ binary nào thiếu và cách cài

Lỗi AI hay mắc (không báo exit code):

• Quên --publish true — default là false, user phải xác nhận trước khi thêm
• Tag sai người — nhiều người trùng tên, dùng --tag-id cho chính xác
• Content chứa quotes — wrap bằng double quotes, escape " bên trong
• Fast failure (< 1s) — script báo "timed out" nhưng thực ra binary không tồn tại hoặc server chưa chạy. Xem exit code và thời gian thực tế trong log

Chi tiết kỹ thuật

Cách script hoạt động, instance lifecycle, troubleshooting → internals. Đọc khi cần debug hoặc xử lý sự cố.