Documentation

sfeed posts to Facebook Pages and Instagram from the terminal. Install it, connect your accounts, post.

Install

curl -fsSL https://sfeed.dev/install.sh | sh

Requires Node.js 20+. The installer detects your platform (macOS, Linux) and architecture (x64, arm64).

Quick start

sfeed auth facebook
sfeed init
sfeed post "Just shipped v2" --to facebook,instagram

Guides

• Authentication -- connect Facebook and Instagram
• Posting -- post content, attach media, schedule
• Voice Profile -- set up brand voice for AI agents
• MCP Server -- let AI agents post on your behalf
• Scheduling -- schedule posts for later (cloud and local)
• Self-Hosting -- use your own Facebook App credentials

Commands

sfeed auth facebook          # Connect Facebook + Instagram
sfeed auth status            # Show connected accounts
sfeed auth revoke facebook   # Disconnect

sfeed init                   # Scan project, build voice profile
sfeed profile                # Show your profile
sfeed profile edit           # Open in $EDITOR
sfeed profile scan           # Re-scan project

sfeed post "content"         # Post to all connected platforms
sfeed post "content" -t facebook
sfeed post "content" --media ./photo.jpg
sfeed post "content" --at "2026-04-01T09:00:00Z"
sfeed post "content" --dry-run

sfeed history                # Post history
sfeed schedule list          # Pending scheduled posts
sfeed schedule cancel <id>

sfeed serve                  # Start MCP server