Documentation

If you want to post to social media with AI, start here. sfeed connects your Facebook Pages and Instagram accounts, gives agents a CLI and MCP server, and lets you publish now or schedule posts for later.

You do not create a separate sfeed account to start. There is no email signup, Google login, or other social-provider login for sfeed. Install the CLI, run sfeed auth facebook, approve the Meta browser flow, and post. Hosted scheduling is the paid feature.

Start Here

How to post to social media with AI is the shortest product guide. Read that first if you want the direct answer before going deeper into docs.

• FAQ
• How to post to Facebook with AI
• How to post to Instagram with AI
• How to schedule social media posts with AI
• Local files social media workflow
• Free social media scheduler for AI agents
• AI social media scheduler
• MCP social media server
• Buffer alternative for AI agents
• Hootsuite alternative for AI agents

Install

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

Requires Node.js 20+ installed on your machine. The installer picks the right release for macOS or Linux on x64 and arm64.

Agent quick start

In Codex, Claude Code, OpenCode, or another agent with terminal access, start with this prompt:

Read https://sfeed.dev and onboard me to sfeed.
Install what you need, ask where my posts and media should live, and learn my posting rules.
Connect my Meta accounts, inspect my Pages and Instagram accounts, then show me the first post preview before publishing.

Manual quick start

sfeed auth facebook
sfeed status
sfeed post "Release notes are live" --to facebook --dry-run

This does not require a separate sfeed account, email signup, Google login, or other social-provider login for sfeed. If you only want to post to Instagram, the setup command is still sfeed auth facebook. Meta requires a professional Instagram account linked to a Facebook Page for Instagram publishing access.

Give your AI this prompt

If your agent can run shell commands, it can use the sfeed CLI after auth. Add MCP when you want structured tools instead of terminal commands.

codex mcp add sfeed -- sfeed mcp
claude mcp add sfeed -- sfeed mcp

For OpenCode, run opencode mcp add or add ["sfeed", "mcp"] to the mcp section of opencode.json.

Agent skills

If your agent supports installable skills, start with the main sfeed skill:

npx skills add nem035/sfeed --skill sfeed

The public repo also includes narrower skills for Facebook posting, Instagram posting, and scheduling. Most users should start with sfeed and only add narrower skills if they want more targeted behavior.

Guides

• Authentication -- connect Facebook and Instagram
• Filesystem setup -- organize local posts, media, and rules for agents
• Rules file examples -- small local rules files for agent-driven posting
• Weekly social workflow -- plan a week in local files, then schedule it
• Posting -- post content, attach media, schedule
• MCP Server -- let AI agents post on your behalf
• Scheduling -- schedule posts for later
• Cookbook -- short recipes you can copy and run
• Browser Debugging -- inspect the local site with Playwright MCP

SEO landing pages

• Free social media scheduler -- what is free and what costs $5/month
• AI social media scheduler -- agent-driven Facebook and Instagram scheduling
• MCP social media server -- social posting tools for MCP clients
• Buffer alternative for AI agents -- local files, MCP, and narrower Meta publishing
• Hootsuite alternative for AI agents -- a smaller publishing layer for agent workflows

Tool guides

• Give your AI this prompt -- copy-paste setup flow for IDE agents
• Using sfeed with Codex -- CLI, MCP, and Codex desktop notes
• Using sfeed with Claude Code -- CLI, MCP, and Claude Cowork notes
• Using sfeed with OpenCode -- CLI and MCP setup

Commands

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

sfeed post "content"         # Post from your only connected Page
sfeed post "content" -t facebook
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                  # Connected pages
sfeed dashboard             # Open the hosted queue UI
sfeed schedule open         # Same browser queue alias
sfeed schedule status       # Queue summary and recent activity
sfeed schedule list          # Scheduled posts
sfeed schedule list --status failed
sfeed schedule list --status posted
sfeed schedule list --json   # Scheduled posts as JSON
sfeed schedule preview <id>  # Open the browser preview
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                 # Readiness checks and next steps
sfeed status                 # Overview of accounts, schedule, subscription
sfeed billing                # Subscription status
sfeed billing subscribe      # Start hosted scheduling subscription
sfeed billing portal         # Open Stripe portal
sfeed mcp                    # Start MCP server

For Instagram posting, your Instagram account must be a professional account linked to a Facebook Page. Meta setup help: professional accounts, connect Instagram and a Page.