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.

Meta production access is approved for Facebook Page and Instagram publishing.

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 connect
sfeed auth instagram connect
sfeed destinations

Run the connection command only for each platform the user wants. Facebook connects selected Pages. Instagram connects a professional Business or Creator account directly and does not require a Facebook Page.

For Codex:

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

For Claude:

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

These GitHub marketplace installs are available now. Public directory approval is separate and is not claimed here; use the commands above. ChatGPT browser support will require a hosted, authenticated MCP service and is not available through this local plugin yet.

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

Facebook and Instagram connections are independent. An Instagram-only user runs sfeed auth instagram connect; a Facebook-only user runs sfeed auth facebook connect; a user who wants both runs both commands.

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 connect
sfeed auth instagram connect
sfeed status
sfeed destinations

Only connect the platforms the user wants.

Requires Node.js 20+.

The signed install script is the only supported setup and update path.

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 destinations

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 connecting a professional Business or Creator account directly

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.

Extension release checks

Run the deterministic release checks before publishing plugin changes:

npm test
claude plugin validate . --strict
claude plugin validate ./plugins/sfeed --strict

Build the OpenAI skills-only submission archive with:

npm run build:openai

The OpenAI archive intentionally excludes the local stdio MCP declaration. The repository plugins include the local sfeed mcp server for Codex and Claude Code, while the reviewed OpenAI skills-only package works on surfaces that can run the local sfeed CLI. A future public HTTPS MCP server can replace that surface limitation.

Practical examples

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

sfeed status
sfeed destinations

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

sfeed post "Spring drop, 8 new pieces." \
  --to instagram \
  --page "@acme" \
  --kind carousel \
  --media ./content/media/look-1.jpg,./content/media/look-2.jpg,./content/media/look-3.jpg

sfeed post "Demo clip is live." \
  --to instagram \
  --page "@acme" \
  --kind reel \
  --media ./content/media/demo.mp4

sfeed post "Quick behind-the-scenes update." \
  --to facebook \
  --page "Acme Robotics" \
  --kind story \
  --media ./content/media/story.jpg

sfeed post "Tuesday product update" \
  --to facebook \
  --page "Acme Robotics" \
  --at "2026-04-15T13:00:00Z"

sfeed schedule status
sfeed schedule open
sfeed schedule calendar
sfeed schedule preview <id>
sfeed schedule reschedule <id> --at "2026-04-11T13:00:00Z"
sfeed schedule duplicate <id>
sfeed schedule cancel <id>
sfeed schedule acknowledge <id>

Facebook supports feed posts, text-only posts, single-image posts, multi-image posts, single-video posts, Page Reels, and Page Stories. Instagram supports feed media, Reels, Stories, and image-only carousels up to 10 items. Use --kind feed, --kind reel, --kind story, or --kind carousel when the media shape alone is not clear.

Owners can connect multiple Facebook businesses and inspect them with sfeed auth facebook connections. Reconnecting the same business refreshes its access. See connection management for selecting Pages and previewing a targeted disconnect without removing other connections.

MCP is optional

Agents with terminal access can use the CLI directly. Add MCP when the agent client supports structured tools and you want repeatable status, page, post, and schedule calls. Version 0.4.2 adds typed results and action annotations to all 18 tools, plus explicit recovery guidance for partial failures. Update the CLI using the install script, then restart the agent session to reload its MCP server.

Claude Desktop example:

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

Once connected, the agent can inspect status, choose the right publishing destination, post immediately, schedule posts, and manage the queue.

Full MCP docs: sfeed.dev/docs/mcp

Start here

• How to post to social media with AI
• 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

Links

• Main site: sfeed.dev
• Docs: sfeed.dev/docs
• MCP docs: sfeed.dev/docs/mcp
• Scheduling docs: sfeed.dev/docs/scheduling
• Pricing: sfeed.dev/pricing