fb-page-poster

# 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`:

```bash
# Text-only
node {baseDir}/scripts/fb-post.js --type text --message "content"

# Image (file)
node {baseDir}/scripts/fb-post.js --type image --message "content" --image-file /path/to/img.jpg

# Image (URL)
node {baseDir}/scripts/fb-post.js --type image --message "content" --image-url "https://..."

# Link in fi...