@sfeed/cli

Post to Facebook Pages and Instagram from the terminal or through MCP.

sfeed is a CLI and MCP server for AI agents. It handles auth, immediate posting, hosted scheduling, and billing for hosted scheduling.

Install

npm install -g @sfeed/cli

Requires Node.js 20+ installed on your machine.

Quick start

sfeed auth facebook
sfeed mcp

That connects your accounts and starts the MCP server for an agent.

Core commands

sfeed auth facebook
sfeed auth fb
sfeed auth status
sfeed auth revoke facebook

sfeed post "content"
sfeed post "content" --to facebook
sfeed post "content" --to instagram
sfeed post "content" --page "Acme Robotics"
sfeed post "content" --to facebook --media ./assets/launch-card.jpg
sfeed post "content" --at "2026-04-01T09:00:00Z"
sfeed post "content" --dry-run

sfeed pages
sfeed dashboard
sfeed dashboard --view calendar
sfeed calendar
sfeed schedule open
sfeed schedule calendar
sfeed schedule status
sfeed schedule list
sfeed schedule list --status failed
sfeed schedule list --status posted
sfeed schedule preview <id>
sfeed schedule reschedule <id> --at "2026-04-02T09:00:00Z"
sfeed schedule duplicate <id> --at "2026-04-03T09:00:00Z"
sfeed schedule cancel <id>

sfeed doctor
sfeed status
sfeed telemetry status
sfeed telemetry on
sfeed telemetry off
sfeed billing
sfeed billing subscribe
sfeed billing portal
sfeed mcp

Posting

• If you have one connected Page, sfeed post uses that Page
• If you have multiple connected Pages, you must pass --page
• --media accepts local files or public URLs
• sfeed stages local files automatically when Instagram or hosted scheduling needs a public URL
• Facebook supports text-only, single-image, multi-image, and single-video posts
• Instagram supports single-image, single-video, and image-only carousel posts
• Instagram does not support text-only posts

Scheduling

• --at schedules the post for later
• sfeed schedule preview <id> opens a hosted browser preview for a scheduled post
• sfeed dashboard opens the hosted browser UI for your whole queue
• sfeed dashboard --view calendar and sfeed calendar open the same queue as a month calendar
• sfeed schedule open is the same browser queue, kept as a compatibility alias
• sfeed schedule status shows queue state, last publish attempt, and recent failures
• sfeed schedule reschedule <id> --at ... moves a pending post to a new time
• sfeed schedule duplicate <id> [--at ...] copies an existing post into a fresh pending job
• hosted scheduling requires a subscription
• scheduled local-file media must be within 90 days
• local staged files must be 100 MB or smaller
• hosted scheduling checks for due posts every minute
• schedule times must be ISO 8601 with a timezone, for example 2026-04-01T09:00:00Z
• staged local media is served through short-lived signed URLs for previews and publish jobs

Telemetry

After sfeed auth facebook, sfeed asks once whether you want to share anonymous CLI usage events. This is optional.

sfeed telemetry status
sfeed telemetry on
sfeed telemetry off

Telemetry never sends post content, media, tokens, account IDs, page IDs, account names, billing details, or file paths. Set SFEED_TELEMETRY=0 to disable it from the environment.

Preview flow:

sfeed post "content" --to facebook --page "Acme Robotics" --at "2026-04-01T09:00:00Z"
sfeed schedule status
sfeed dashboard
sfeed schedule preview <id>

MCP

sfeed works as an MCP server. Start it with:

sfeed mcp

Example Claude Desktop config:

{
  "mcpServers": {
    "sfeed": {
      "command": "sfeed",
      "args": ["mcp"]
    }
  }
}

MCP tools

• sfeed_status
• sfeed_auth_status
• sfeed_pages
• sfeed_post
• sfeed_schedule_status
• sfeed_schedule_dashboard_url
• sfeed_schedule_preview_url
• sfeed_schedule_list
• sfeed_schedule_reschedule
• sfeed_schedule_duplicate
• sfeed_schedule_cancel

Full docs: https://sfeed.dev/docs

Useful guides:

• Cookbook: https://sfeed.dev/docs/cookbook
• Codex: https://sfeed.dev/docs/codex
• Claude Code: https://sfeed.dev/docs/claude-code
• OpenCode: https://sfeed.dev/docs/opencode