FB Personal Poster

Post text + photos to personal Facebook timeline via Patchright stealth browser automation.

Why Not Graph API?

Facebook removed publish_actions permission in 2018. API cannot post to personal timelines.
Only browser automation works — this skill uses Patchright (stealth Chromium) to mimic human behavior.

Requirements

CODEBLOCK0

Environment Variables

Variable	Required	Description
INLINECODE1	✅	Path to Facebook cookies JSON (Selenium format). Full account access.
INLINECODE2

How to Get Cookies

1. Log in to Facebook in Chrome (manually, once)
Export all facebook.com cookies as JSON via EditThisCookie extension
Save to path in FB_COOKIE_FILE with INLINECODE10

Cookies last ~30–90 days. Re-export when expired.

Usage

Text-only post

CODEBLOCK1

Post with photos

CODEBLOCK2

Dry run (default)

CODEBLOCK3

OpenClaw Integration (Recommended)

Use the built-in browser tool — already proven working for personal timeline posting:

CODEBLOCK4

Tips

- Facebook 頁面結構複雜，selector 會變，用 snapshot 找當前可用的 ref
上傳圖片用 browser(action="upload") 功能
如果 timeout，重試一次通常就好
個人動態和粉絲專頁的操作流程不同，注意確認在正確頁面

Safety

- Dry-run is ON by default — must explicitly set FB_DRY_RUN=false for live posting
Cookies stored locally with chmod 600 — never committed to git
Human-like delays and typing speed to avoid detection

FB Personal Poster

通过Patchright隐身浏览器自动化，将文本+照片发布到个人Facebook时间线。

为何不使用Graph API？

Facebook于2018年移除了publish_actions权限。API无法发布到个人时间线。
只有浏览器自动化可行——本技能使用Patchright（隐身Chromium）模拟人类行为。

环境要求

bash
cd scripts/ && pip install -r requirements.txt
python -m patchright install chromium

环境变量

变量名	必填	说明
FBCOOKIEFILE	✅	Facebook Cookie JSON文件路径（Selenium格式）。需完整账户访问权限。
FBSTATEFILE

如何获取Cookie

1. 在Chrome中登录Facebook（手动操作，仅需一次）
通过EditThisCookie扩展导出所有facebook.com的Cookie为JSON格式
保存到FBCOOKIEFILE指定的路径，并执行chmod 600

Cookie有效期约30-90天。过期后需重新导出。

使用方法

纯文本发布

bash FBCOOKIEFILE=~/.fbcookies.json FBDRY_RUN=false \ python3 scripts/fb_post.py -m 来自自动化的问候！

带照片发布

bash FBCOOKIEFILE=~/.fbcookies.json FBDRY_RUN=false \ python3 scripts/fb_post.py -m 美好的一天！ -p photo1.jpg photo2.jpg

预览模式（默认）

bash python3 scripts/fb_post.py -m 测试发布 -p photo.jpg

不会实际发布——仅预览流程

OpenClaw集成（推荐）

使用内置的browser工具——已证明可用于个人时间线发布：

python

步骤1：导航到Facebook

browser(action=navigate, url=https://www.facebook.com/)

步骤2：确认在个人主页（url应为facebook.com/me）

步骤3：点击在想些什么

browser(action=act, kind=click, ref=[发布输入框])

步骤4：输入消息

browser(action=act, kind=type, text=你的消息内容)

步骤5：上传照片（如需）

browser(action=upload, paths=[/path/to/photo.jpg])

步骤6：设置分享范围为公开

步骤7：点击发布按钮

browser(action=act, kind=click, ref=[发布按钮])

提示

- Facebook页面结构复杂，选择器会变化，使用snapshot查找当前可用的ref
上传图片使用browser(action=upload)功能
如果超时，通常重试一次即可
个人动态和粉丝专页的操作流程不同，注意确认在正确页面

安全说明

- 预览模式默认开启——必须显式设置FBDRYRUN=false才能实际发布
Cookie本地存储并执行chmod 600——绝不提交到Git
模拟人类操作延迟和打字速度以避免检测

fb-personal-poster脸书个人海报