fb-page-poster

The fb-page-poster skill provides a robust interface for automating social media workflows directly from your AI agent environment. Designed for community managers, social media marketers, and content creators, it integrates the Meta Graph API to streamline the process of drafting, translating, and scheduling Facebook posts. By abstracting complex API requirements into a simple command-line interface, it enables users to focus on content strategy rather than technical execution. The tool includes a mandatory preview step that ensures post formatting, scheduling timestamps, and link placement are verified before any public action is taken, significantly reducing the risk of posting errors.

• Publish text-only posts, image-based updates, and link-in-comment style content.
• Automated multilingual translation (ZH↔EN) with intent and hashtag preservation.
• Intelligent tone detection (marketing/upbeat vs. formal/professional) for appropriate copy generation.
• Support for scheduled posts using ISO 8601 timestamps.
• Mandatory post preview interface for user confirmation (yes/edit/cancel).
• Error handling for OAuth issues, permission scopes (pages_manage_posts), and rate limits.

Usage notes and practical constraints:

• Requires a long-lived Meta Page Access Token, Page ID, and App Secret configured in your environment variables.
• Always verify the pages_manage_posts and pages_read_engagement permissions if publishing fails.
• Images must be under 10MB; for larger files, ensure local compression or resizing before invocation.
• Scheduled posts must be configured at least 10 minutes into the future to comply with Meta API constraints.
• The script performs automated validation; if the user's requested schedule is in the past, the system will prompt for an adjustment.
• If authentication fails, use the integrated token-setup-guide to refresh or re-authorize your credentials.