Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
hoangvantuan avatar

Facebook

  • 26 installs
  • Updated July 13, 2026
  • hoangvantuan/claude-plugin

Publish Facebook wall or group posts with images and friend tags from your coding agent via PinchTab instead of manual browser work.

About

Facebook is a PinchTab-backed agent skill for solo builders who want to push finished posts to a personal wall or group without leaving the terminal. It assumes PinchTab is installed, the server is running, and a named profile already holds a Facebook session; first-time setup uses a headed browser login, then reuse cookies on headless runs. Operators enable `security.allowEvaluate` for reliable image upload and text input. The agent runs `fb-post.sh` with content and optional group URL, profile name, and wall user id defaults. It fits the launch distribution lane when you have copy and assets ready—not when you still need ideation or long-form writing. macOS users benefit from coreutils for timeout handling; pure-bash fallbacks exist elsewhere. Treat it as a narrow integration on top of PinchTab, not a general marketing strategy skill.

  • Posts to personal wall or Facebook group using PinchTab profile sessions
  • Supports image attachment and tagging via browser evaluate (requires allowEvaluate)
  • Shell wrapper `scripts/fb-post.sh` with positional or `--content` / `--profile` / `--group` flags
  • Headed login flow guidance when no saved Facebook cookies on the profile
  • Explicit scope: not for drafting copy (social-post) or generic browser tasks (pinchtab)

Facebook by the numbers

  • 26 all-time installs (skills.sh)
  • Ranked #1,246 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hoangvantuan/claude-plugin --skill facebook

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs26
Security audit1 / 3 scanners passed
Last updatedJuly 13, 2026
Repositoryhoangvantuan/claude-plugin

What it does

Publish Facebook wall or group posts with images and friend tags from your coding agent via PinchTab instead of manual browser work.

Files

SKILL.mdMarkdownGitHub ↗

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:

ParamRequiredDefaultDescription
<content>YesPost content (positional arg hoặc --content)
--profileNodefaultPinchTab profile name
--user-idNo100003782705460Facebook numeric ID (wall mode)
--groupNoGroup slug hoặc full URL → post vào group thay vì wall
--titleNoTiêu đề bài viết (chỉ group, hiển thị bold phía trên nội dung)
--imageNoĐường dẫn ảnh đính kèm (dùng nhiều lần cho nhiều ảnh, tối đa 8)
--tagNoTên hiển thị của bạn bè cần tag
--tag-idNoFacebook ID của bạn bè (chính xác hơn search theo tên)
--publishNofalsetrue = đăng ngay, false = chỉ soạn (user review trước)
--modeNoheadlessheaded = hiển thị browser, headless = chạy nền
--debugNofalseChụp screenshot mỗi bước vào /tmp/ (flag, không cần value: --debug)
--dry-runNoLog actions mà không mở browser (kiểm tra params)
--keep-instanceNoGiữ 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

CodeMeaningNguyên nhân & cách xử lý
0Thành công
1Sai argumentsThiế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)
2Instance failurePinchTab chưa chạy (pinchtab server &) hoặc profile không tồn tại
3Element not foundFB UI thay đổi, group URL sai, không có quyền. Dùng --debug kiểm tra screenshot
4Publish failedNút đăng không tìm thấy
5Upload failedsecurity.allowEvaluate tắt → pinchtab config set security.allowEvaluate true. Ảnh dispatch nhưng không attach → verify blob: URL trong 10s
6Missing dependencyThiế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ố.

Related skills

FAQ

Is Facebook safe to install?

skills.sh reports 1 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Automation & Workflowsdistributioncontent

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.