| name | fb-page-poster |
| description | Publish posts to a Facebook Page via the Meta Graph API. Use when the user says "post to Facebook", "FB post", "粉專發文", "社群貼文", "幫我發文", "schedule post", "排程發文", or provides content and says "post this" or "publish this". Supports text-only, image, link-in-comment, scheduled posts, and multilingual translation (ZH↔EN) with a review step before publishing. |
Facebook Page Poster
Publish content to a Facebook Page through the Meta Graph API.
Environment Variables
| Variable | Purpose |
|---|
LONG_META_page_TOKEN | Long-lived Page Access Token with pages_manage_posts and pages_read_engagement permissions |
META_PAGE_ID | Numeric Page ID |
META_APP_SECRET | Meta App Secret for appsecret_proof |
If any are missing, walk the user through {baseDir}/references/token-setup-guide.md.
Workflow
1. Parse the request
Extract from the user message:
- Content: the text to post
- Language direction: ZH→EN, EN→ZH, ZH→ZH, or EN→EN
- Post type: text | image | link-in-comment | scheduled (combinable)
- Tone: infer automatically — marketing/social (upbeat, CTA) for promotions and events; formal/professional for announcements and corporate. Ask if ambiguous.
- Image: local file path or URL (if applicable)
- Schedule: ISO 8601 timestamp (if applicable)
- Link: URL for the first comment (if applicable)
2. Draft and translate — always preview first
Never publish without user confirmation.
If source language differs from target, translate with these rules:
- Preserve meaning, intent, hashtags
- Adapt idioms naturally, do not translate literally
- Keep brand names and proper nouns in original form
- Maintain emoji usage unless unnatural in target language
Present preview:
📋 Post Preview
─────────────────
[Post text here]
🔗 First comment: [URL or N/A]
🖼️ Image: [filename/URL or N/A]
⏰ Schedule: [time or "Publish immediately"]
─────────────────
Confirm? (yes / edit / cancel)
3. Publish
Run the script at {baseDir}/scripts/fb-post.js:
node {baseDir}/scripts/fb-post.js --type text --message "content"
node {baseDir}/scripts/fb-post.js --type image --message "content" --image-file /path/to/img.jpg
node {baseDir}/scripts/fb-post.js --type image --message "content" --image-url "https://..."
node {baseDir}/scripts/fb-post.js --type text --message "content" --comment-link "https://..."
node {baseDir}/scripts/fb-post.js --type text --message "content" --schedule "2025-12-25T10:00:00+0800"
Flags are combinable. Example — image + comment link + scheduled:
node {baseDir}/scripts/fb-post.js --type image --message "content" --image-url "https://..." --comment-link "https://..." --schedule "2025-12-25T10:00:00+0800"
4. Report result
- Show the post ID
- Confirm comment was posted (if link-in-comment)
- Confirm scheduled time (if scheduled)
- On error, show the message and suggest a fix
Error reference
| Error | Likely cause | Fix |
|---|
| OAuthException / Invalid token | Token expired | Refresh via {baseDir}/references/token-setup-guide.md |
| Permission denied | Missing pages_manage_posts | Re-authorize token with correct scopes |
| Scheduled time in past | Must be ≥10 min in the future | Adjust the timestamp |
| Image too large | >10 MB | Compress or resize |
| Rate limit | Too many requests | Wait a few minutes, retry |
