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.
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