sfeed

sfeed

Let your AI agent post to Facebook Pages and Instagram with sfeed.

Keep your drafts, media, and rules where they already live. Give your agent one prompt, connect Meta in the browser, review the post, and publish. Posting now is free. Pay only when you want scheduled posts to run later.

Most of the product lives at sfeed.dev.

• Docs: sfeed.dev/docs
• Install: sfeed.dev/docs#install
• Pricing: sfeed.dev/pricing
• AI guide: sfeed.dev/post-to-social-media-with-ai

Give your AI this prompt

Read https://sfeed.dev and help me set up AI-powered social posting.

Ask me where my posts, media, and rules already live. If sfeed is missing, install it with https://sfeed.dev/install.sh. Connect my Meta accounts, inspect my Facebook Pages and Instagram accounts, and adapt to the workflow I already use.

Before publishing anything, show me the post, the account it will publish to, and whether it will post now or be scheduled.

That is the main flow. The agent can run the sfeed CLI directly. Add MCP when structured tools make the workflow cleaner.

Agent plugins

Codex and Claude can install the sfeed plugin from this repo. The plugin bundles the sfeed skill and the local sfeed mcp server entry.

Users still need the local CLI and Meta auth state:

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

For Codex:

codex plugin marketplace add nem035/sfeed --sparse .agents/plugins --sparse plugins

For Claude:

claude plugin marketplace add nem035/sfeed
claude plugin install sfeed@sfeed

What the user gets

• Drafts, media, and rules stay on the user's machine
• The agent asks setup questions before creating a workflow
• Meta auth happens in the browser
• The user reviews the post and destination before publishing
• Posting now is free
• Hosted scheduling is paid because sfeed runs the post later

If you only want to post to Instagram, the setup is still sfeed auth facebook. Meta requires a professional Instagram account linked to a Facebook Page for Instagram publishing access. After setup, you can still post only to Instagram.

Use any local workflow

Your files can be anywhere: a repo, a notes folder, a calendar export, Markdown drafts, JSON, CSV, images in Downloads, or a project-specific content directory.

Your files stay local. Your agent reads whatever structure you already use. sfeed handles auth, posting, scheduling, previews, and the hosted queue.

Manual quick start

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

Requires Node.js 20+.

Use the install script as the default setup path. npm is a supported fallback for users who explicitly want it, but agents should not recommend npm first.

Available Skills

sfeed

The main onboarding, posting, and scheduling workflow.

Use when:

• the user wants an agent to set up sfeed
• the user wants an agent to read local files and publish or schedule posts
• the task spans Facebook, Instagram, and scheduling together
• the user wants MCP, CLI usage, or both

facebook-posting

Facebook Page posting workflow.

Use when:

• the user wants to post to a Facebook Page
• the task involves Facebook-specific post shapes such as multi-image posts, Page Reels, or Page Stories
• the user needs explicit page selection with sfeed pages

instagram-posting

Instagram-specific publishing workflow.

Use when:

• the user wants to post to Instagram with sfeed
• the task depends on media requirements, carousels, Reels, or Stories behavior
• the user needs help with the professional-account and linked-Page requirement

social-scheduling

Hosted queue and scheduling workflow.

Use when:

• the user wants to schedule posts for later
• the user wants previews, queue inspection, rescheduling, duplication, or canceling
• the task requires local timezone awareness

Installation

npx skills add nem035/sfeed --list

Install all skills from this repo:

npx skills add nem035/sfeed

Install specific skills:

npx skills add nem035/sfeed --skill sfeed
npx skills add nem035/sfeed --skill facebook-posting
npx skills add nem035/sfeed --skill instagram-posting
npx skills add nem035/sfeed --skill social-scheduling

Skill Structure

Each skill is in skills/<name>/SKILL.md.

Skills describe how to use sfeed with agents. They do not describe private deployment details.

The installable Codex and Claude plugin package lives in plugins/sfeed.

Practical examples

These paths are examples only. The agent should use the files and folders the user already has.

sfeed status
sfeed pages

sfeed post "Launch day. v0.1.3 is live." \
  --to facebook \
  --page "Acme Robotics" \
  --media ./content/media/launch-card.jpg