post-bridge

Post Bridge Agent Mode

Give your AI agent the ability to post to 9 social media platforms from a single command.

Supports: Instagram, TikTok, YouTube, X (Twitter), LinkedIn, Facebook, Pinterest, Threads, Bluesky

Built on the Post Bridge API. Post Bridge is a social media scheduling tool used by 1,500+ creators and teams to post everywhere from one place.

What Are Skills?

Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. Add this to your project and your AI agent will be able to create, schedule, and publish social media content across 9 platforms.

Install

Skill (works with Claude Code, Cursor, Windsurf, Codex, and other agents):

npx skills add post-bridge-hq/agent-mode

This installs the skill and makes the postbridge-cli CLI available to your agent.

CLI only (no skill, any terminal):

The CLI is published standalone on npm — no install required, npx fetches it on first use:

npx postbridge-cli setup --key pb_live_xxxxx
npx postbridge-cli accounts

Requires Node.js 18+. Install globally with npm i -g postbridge-cli if you'd rather drop the npx prefix.

/plugin marketplace add post-bridge-hq/agent-mode
/plugin install post-bridge@post-bridge

claude --plugin-dir ./agent-mode

Setup

1. Sign up at post-bridge.com and connect your social accounts
2. Enable API access (Settings > API) — $5/month add-on
3. Run the setup command:

npx postbridge-cli setup --key pb_live_xxxxx

Tip: You can also set the API key as an environment variable instead of running setup: export POST_BRIDGE_API_KEY=pb_live_xxxxx (add it to ~/.zshrc / ~/.bashrc to persist).

Start using it

Ask your AI agent things like:

• "Post this to all my social accounts"
• "Schedule a post for tomorrow at 9am on Instagram and TikTok"
• "Upload this video and post it everywhere"
• "How did yesterday's post perform?"
• "Show my scheduled posts"
• "Delete the draft I made earlier"

What your agent can do

• Post to any or all 9 connected platforms in one command
• Schedule posts for any date/time
• Upload images and videos (automatic format conversion)
• Check analytics — views, likes, comments, shares across TikTok, YouTube, Instagram
• Manage accounts — list connections, check status
• Per-platform overrides — custom captions, TikTok draft mode, YouTube titles, Instagram trial reels, Pinterest boards, etc.

Quick start

# List your connected accounts
npx postbridge-cli accounts

# Post to specific accounts
npx postbridge-cli post --caption "Hello world!" --accounts 1,2,3

# Schedule a post (specific UTC time)
npx postbridge-cli post --caption "Morning post" --accounts 1,2 --schedule "2026-06-20T14:00:00Z"

# Or auto-schedule to your next queue slot
npx postbridge-cli post --caption "Morning post" --accounts 1,2 --use-queue

# Upload media and post with it
npx postbridge-cli upload --file ./video.mp4
npx postbridge-cli post --caption "Check this out" --accounts 1,2,3 --media mid_xxx

# Check analytics
npx postbridge-cli analytics

Supported Platforms

• Instagram (Reels, Stories, Feed)
• TikTok
• YouTube (Shorts)
• X (formerly Twitter)
• LinkedIn
• Facebook
• Pinterest
• Threads
• Bluesky

Troubleshooting

"API key not found"

Run the setup command:

npx postbridge-cli setup --key pb_live_xxxxx

Or set the environment variable manually:

export POST_BRIDGE_API_KEY=pb_live_xxxxx

To persist across sessions, add it to your shell profile (~/.bashrc, ~/.zshrc, etc.).

"Node.js is required"

The CLI is a zero-dependency Node.js script and requires Node.js 18+ (for built-in fetch). Install a recent Node.js version, then retry.

API errors (401, 403)